faq.org
... ...
@@ -4,7 +4,7 @@ title: FAQ
4 4
5 5
If you're not already a Pluckeye user, you may want to take a look at the [[https://www.pluckeye.net/faq-about.html][non-user FAQ]] instead of this page.
6 6
7
-[[_TOC_|levels = 2]]
7
+[[_TOC_]]
8 8
9 9
* Using Pluckeye FAQ
10 10
... ...
@@ -34,10 +34,17 @@ If you're not already a Pluckeye user, you may want to take a look at the [[http
34 34
[[commands][Commands]] such as
35 35
36 36
#+BEGIN_SRC sh
37
- pluck + allow example.com
37
+ pluck + allow example.com
38 38
#+END_SRC
39 39
40
- are typed in [[how-to-open-a-console-window.org][a console window]] (AKA a terminal on Mac OS X or Linux). You'll need to learn to open and type in one if you want to use some advanced features such as [[rules#when][scheduled rules]]. However, the basic feature set requires only pointing and clicking in the browser, and many people use Pluckeye without typing anything, ever.
40
+ are typed in [[how-to-open-a-console-window.org][a console window]] (AKA a terminal on macOS or Linux).
41
+ If you are using Pluck 1.0 or above, you can accomplish most tasks
42
+ without ever using a console. If you are using Pluckeye 0.99.60 or
43
+ below, you can only take advantage of some advanced Pluckeye
44
+ features such as [[rules#when][scheduled rules]] by using a console. However, the
45
+ basic feature set requires only pointing and clicking in the
46
+ browser, and many people use Pluckeye without typing anything,
47
+ ever.
41 48
42 49
For a longer explanation of how to type in commands, see [[notation]].
43 50
... ...
@@ -45,17 +52,21 @@ If you're not already a Pluckeye user, you may want to take a look at the [[http
45 52
See the [[glossary]].
46 53
47 54
** How do I whitelist a site?
48
- Keep in mind that no matter how you do this, the new setting will only be effective after the Pluckeye [[delay]] waiting period.
49 55
50
-*** Through the browser extension
51
-**** v1.0
52
- In Chrome, click on the Pluckeye button (usually in the top right), and then click the "allow <website>" button immediately below "New Rule".
56
+ There are a couple ways. The most common way is to click the
57
+ Pluckeye button ([[https://static.pluckeye.net/images/png/p64.png]]) in
58
+ the browser, and then click "allow".
53 59
54
-**** v0.99 and older
55
- In Chrome, click on the Pluckeye button (usually in the top right), and then click =allow=.
60
+ You can also type in a [[how-to-open-a-console-window][console]]:
56 61
57
-*** Through a console
58
- Use the [[rules#everything][allow everything rule]].
62
+ #+BEGIN_SRC sh
63
+ pluck + allow mysite.org
64
+ #+END_SRC
65
+
66
+ Keep in mind that no matter how you do this, the new setting will
67
+ only be effective after the Pluckeye [[delay]] waiting period.
68
+
69
+ For more information on adding rules, see [[rules]].
59 70
60 71
** How do I block only "bad sites"?
61 72
... ...
@@ -72,12 +83,14 @@ See the [[glossary]].
72 83
#+BEGIN_SRC sh
73 84
pluck + when 0-6&21-24 block everything
74 85
#+END_SRC
75
-
86
+
76 87
Use a [[rules#when][when rule]] and the [[rules#everything][everything context]] to understand how this works.
77 88
78 89
** How do I block or allow part of a website, but not all of it?
79 90
80
- See [[rules#how-to-add-a-rule][How to add a rule]].
91
+ You can [[rules#how-to-add-a-rule][add a rule]] to block or allow specific [[glossary#url][urls]]. For example,
92
+ you can allow https://www.facebook.com/myfriend and block
93
+ https://www.facebook.com/myenemy.
81 94
82 95
** How do I transfer (export/import) my Pluckeye settings between computers?
83 96
... ...
@@ -96,36 +109,58 @@ See the [[glossary]].
96 109
97 110
** How do I manually remove a rule?
98 111
99
-*** Through the browser extension
100
-**** v0.99 and older
101
- If the rule was added using the "allow" button in Chrome, the "revert" button will remove the rule.
112
+ There are many ways.
102 113
103
-*** Through a console window
104
- Use the [[commands#minus][- (minus) command]].
114
+ In Pluckeye v1.0+, you usually remove rules by clicking the
115
+ Pluckeye button ([[https://static.pluckeye.net/images/png/p64.png]]) in
116
+ the browser, selecting the verdicts tab, expanding the verdict you
117
+ dislike, and then deleting the corresponding rule. But you could
118
+ also click on the config tab and search for the rule you would like
119
+ to remove.
120
+
121
+ In Pluckeye v0.99.60 and below, you can click the Pluckeye button
122
+ and then "revert" on a site on which you formerly clicked "allow"
123
+ or "block". You can also use the Pluckeye button > history page to
124
+ delete rules.
125
+
126
+ In any version of Pluckeye, you can also use [[commands#minus][pluck's - (minus)
127
+ command]] in [[how-to-open-a-console-window][console window]]:
128
+
129
+ #+BEGIN_SRC sh
130
+ pluck - allow mysite.org
131
+ pluck - allow https://www.facebook.com/myfriend
132
+ #+END_SRC
105 133
106 134
** What is the complete syntax for rules and settings?
107 135
108
- See [[rule-syntax.txt]].
136
+ See [[rules]].
109 137
110 138
** Can I whitelist a URL, perhaps using wildcards, pattern matching, a specific resource or something similar?
111 139
112
- Yes, and no. As of Pluckeye 1.0 literal urls and url prefixes are supported, using the [[commands#add][+ (add) command]]:
140
+ Yes, and no. Literal urls and url prefixes are supported, using the [[commands#add][+ (add) command]]:
113 141
114 142
Full regular expressions support is not yet implemented, and may never be. If you would like regex support, see [[http://pluckeye.uservoice.com/forums/137031-general/suggestions/7936581-support-partial-urls-wildcards][this uservoice suggestion]].
115 143
116
-** Why can't I see the contents of blacklists on [[//u.pluckeye.net/][the users site]]?
144
+** Why can't I see the contents of public blacklists on [[//u.pluckeye.net/][the users site]]?
145
+
117 146
The content of the blacklists are hidden by default because some people report that the textual content in blacklists can trigger behavior they are trying to change. If you want to see the content of the blacklists, you need to include the string 'wigwam' in your profile description and wait for your delay (if any) to elapse.
118 147
119 148
** Why can't I publish (make public) my general configuration on [[//u.pluckeye.net/][the users site]]?
149
+
120 150
Currently only admins can publish general configurations. General configurations may contain powerful rules like [[rules#everything][block everything]], which overrides other rules. Since users can import public configurations into their own configurations, if anyone could publish general configurations, someone might import a very restrictive configuration into their own without realizing how restrictive it is. You can still publish other types of configurations, though.
121 151
122 152
** Why can't I assign an import list to my device?
153
+
154
+ TL;DR: Use a general configuration; it can import just as well.
155
+
123 156
Currently only general configurations can be assigned to devices. This is because other configuration types are limited in the kinds of rules they can contain, and a user should never be prevented from adding a rule to their local configuration (though some rules are subject to their [[delay]]). For example, if you had an import list assigned to your device and you ran ~pluck + allow example.com~, it would be impossible to add the rule, since "allow" rules cannot appear in import lists. (In theory the rule could be added to one of the configurations listed in the import list, but there is no good way of determining which one of these it should be added to.)
124 157
125 158
** Why can't I import one of my general configurations into my import list?
159
+
126 160
Unpublished (i.e., private) general configurations cannot be imported into import lists. The reason for this is the same as the [[#why-can-t-i-publish-make-public-my-general-configuration][reason only admins can publish general configurations]. To get around this, you can use a general configuration (which can import any configuration type) instead of an import list.
127 161
128 162
** How do I use [[expedite]] on mobile?
163
+
129 164
Expedite only works with Pluckeye on desktop systems (Windows, Mac OS X, and Linux). It is hoped that it will one day work on mobile as well.
130 165
131 166
** Does [[//u.pluckeye.net/][the users site]] collect data about users? What's your privacy policy?
... ...
@@ -178,6 +213,8 @@ See the [[glossary]].
178 213
pluck + nofirefox
179 214
#+END_SRC
180 215
216
+ See also [[youtube]].
217
+
181 218
** How can I enforce safe search?
182 219
183 220
You can enforce safe search on google.com by using Chrome or a Chromium-based browser and enabling the [[safe][safesearch]] feature:
... ...
@@ -202,9 +239,9 @@ See the [[glossary]].
202 239
203 240
** How do I install Linux?
204 241
205
- * [[https://help.ubuntu.com/community/Lubuntu/GetLubuntu/LTS]]
242
+ - [[https://help.ubuntu.com/community/Lubuntu/GetLubuntu/LTS]]
206 243
207
- * [[http://www.ubuntu.com/download/desktop]]
244
+ - [[http://www.ubuntu.com/download/desktop]]
208 245
209 246
** How do I block torrents?
210 247
... ...
@@ -502,7 +539,7 @@ See the [[glossary]].
502 539
pluck clear
503 540
pluck import settings.txt
504 541
#+END_SRC
505
-
542
+
506 543
But using [[rules#through-the-users-site][the users site]] may be easier.
507 544
508 545
** How do I temporarily override a "block otherwise"?