abmindicate.org
... ...
@@ -72,7 +72,7 @@ password, and save the password on [[http://lockbox.pluckeye.net/]] .
72 72
73 73
** Similar tools
74 74
75
-*** <<crontab>> crontab (linux or macosx)
75
+*** crontab (linux or macosx)
76 76
77 77
Like abmindicate, the following commands are dangerous. And if you
78 78
are not careful with them, you may remove your own administrative
... ...
@@ -92,4 +92,4 @@ access and be unable to recover it. Beware!
92 92
93 93
Or maybe see [[file:abmindicate.sudo.sh.txt][this script]].
94 94
95
-*** <<delayed-admin>> [[https://github.com/miheerdew/delayed-admin][delayed-admin]] (linux or macosx)
95
+*** [[https://github.com/miheerdew/delayed-admin][delayed-admin]] (linux or macosx)
addon.org
... ...
@@ -1,6 +1,10 @@
1 1
#+TITLE: Add-On | Pluckeye
2 2
#+SETUPFILE: _base.org
3 3
4
-For users of Pale Moon:
4
+For users modern Firefox:
5 5
6
-- [[file:downloads/fugue.xpi]]
6
+- [[file:downloads/whiff.xpi][Firefox addon]]
7
+
8
+For users of Pale Moon or Waterfox:
9
+
10
+- [[file:downloads/fugue.xpi][Pale Moon addon]]
android.org
... ...
@@ -1,30 +1,70 @@
1 1
#+TITLE: Android | Pluckeye
2 2
#+SETUPFILE: _base.org
3 3
4
-* Android
4
+* Are you a parent looking for ways to protect your children?
5 5
6
-Let's have a conversation about solutions on Android!
6
+Here are some links for you.
7 7
8
-[[https://forum.pluckeye.net/viewtopic.php?pid=149]]
8
+- [[https://www.beabovethefray.org/2019/07/in-defense-of-not-giving-children-smartphones/][don't give your child a smart phone]]
9
+- [[https://protectyoungeyes.com/content/android-parental-controls-complete-guide-parents/]]
10
+
11
+* Users of Pluckeye, read on
9 12
10 13
** Pluckeye on Android
11 14
15
+You may need to [[https://www.talkandroid.com/guides/beginner/install-apk-files-on-android/][adjust your security settings]] to install it.
16
+
12 17
By default, all images are blocked. To change the default
13
-settings, you need an account on [[https://u.pluckeye.net/]] . Not all
14
-Pluckeye settings are yet supported.
18
+settings, you need an account on [[https://u.pluckeye.net/]] .
15 19
16
-** Pluckeye links
20
+** [[https://play.google.com/store/apps/details?id=net.pluckeye.tober][The Play Store version]] is old
17 21
18
-- [[https://pluckeye.uservoice.com/forums/137031-general/suggestions/6474260-port-pluckeye-to-android-unrooted][vote for unrooted android support]]
19
-- [[https://pluckeye.uservoice.com/forums/137031-general/suggestions/15002484-port-pluckeye-to-android-rooted][vote for rooted android support]] (rooted support is deeper, more expensive, and requires the user do some special things to their device)
20
-- [[http://filters.pluckeye.net/?os=android]]
21
-- [[file:contact.html]] (send Jon feedback on this page)
22
-- [[https://forum.pluckeye.net/viewtopic.php?pid=149][Pluckeye forum topic about android]]
22
+Although old, the version in the Play Store should still work if
23
+your Android version is below 10. If you have Android 10 or above,
24
+though, it will crash on start up.
25
+
26
+Unfortunately, Pluckeye in the Play Store isn't up to date because
27
+the Play Store now requires all apps with native code be 32-bit and
28
+64-bit capable. The Pluckeye App does not have the 64-bit parts
29
+and adding them would take *many* hours. If you want to help make
30
+this happen, please [[https://contact.pluckeye.net/][let us know]].
31
+
32
+** How to use it
33
+
34
+On Android, Pluckeye is at present just a browser, and so it is
35
+typically used alongside an app locker or [[https://families.google.com/familylink/][parental control]] software
36
+in which other browsers are disabled and only Pluckeye is
37
+permitted. Because app lockers usually use password protection to
38
+control administration, those seeking self-control either:
39
+
40
+- have a friend, parent, or other person administer the
41
+ app locker
42
+
43
+or
44
+
45
+- write down a long, random password on a piece of paper and put it
46
+ in an inconvenient place, and/or put it into a into a box on
47
+ [[https://lockbox.pluckeye.net/]]
48
+
49
+Users who want to replace Android on their phone with a custom
50
+version may find [[https://wiki.pluckeye.net/custom-roms][this custom ROM article]] useful.
51
+
52
+Some tools used by Pluckers are listed below.
23 53
24 54
** Tools related to Android used by some Pluckers
25 55
56
+- [[https://play.google.com/store/apps/details?id=de.Maxr1998.xposed.maxlock][MaxLock - Xposed app locker]] (very fast)
57
+- [[https://families.google.com/familylink/][Google Family Link]] (requires password)
26 58
- [[https://play.google.com/store/apps/details?id=com.domobile.applock&hl=en][DoMobile AppLock]] (app locker that supports long PIN)
27 59
- [[https://mobilock.in/][MobiLock]] (android app with kiosk lockdown)
28 60
- [[https://play.google.com/store/apps/details?id=com.gears42.surelock&hl=en][SureLock]] (android app with kiosk lockdown)
29
-- [[https://lockbox.pluckeye.net/]] (delay password store)
30 61
- [[https://play.google.com/store/apps/details?id=com.lockio][lockIO]] (security app)
62
+- [[https://lockbox.pluckeye.net/]] (delay password store)
63
+
64
+** More Pluckeye links
65
+
66
+- [[https://www.reddit.com/r/pluckeye/comments/a0ekv0/how_to_install_and_use_pluckeye_for_android/][tealhill's helpful Pluckeye for Android guide]]
67
+- [[https://pluckeye.uservoice.com/forums/137031-general/suggestions/6474260-port-pluckeye-to-android-unrooted][vote for unrooted android support]]
68
+- [[https://pluckeye.uservoice.com/forums/137031-general/suggestions/15002484-port-pluckeye-to-android-rooted][vote for rooted android support]]
69
+- [[http://filters.pluckeye.net/?os=android]]
70
+- [[https://forum.pluckeye.net/viewtopic.php?pid=149][Pluckeye forum topic about android]]
faq.org
... ...
@@ -94,7 +94,7 @@ Internet without pictures?!
94 94
That is 4 questions.
95 95
96 96
Yes, by default, all images on the Internet are blocked. But
97
-most Pluckeye users whitelist sites and/or use scheduling rules
97
+most Pluckeye users white-list sites and/or use scheduling rules
98 98
so they can see images on some or many sites. Pluckeye is
99 99
designed to be configured by the user.
100 100
... ...
@@ -161,7 +161,7 @@ Maybe. This page and the [[file:tips.org][tips]] page mention most of Pluckeye'
161 161
features. If you have a feature request, feel free to [[http://pluckeye.uservoice.com/][let me
162 162
know]].
163 163
164
-** I don't have problems with porn, but I'm addicted to facebook. Might I have any use for Pluckeye?
164
+** I don't have problems with porn, but I'm addicted to Facebook. Might I have any use for Pluckeye?
165 165
166 166
Pluckeye can be used in a similar manner to [[http://selfcontrolapp.com][SelfControl for Mac]]
167 167
or [[http://svn.jklmnop.net/projects/SelfControl.html][SelfControl for Linux]]. Such users may want to remove the
... ...
@@ -181,7 +181,7 @@ And though it is spelled "pluck-eye", I pronounce the name
181 181
182 182
** How do you plan on monetizing Pluckeye?
183 183
184
-I hope that users find it valuable and willingly pay for it.
184
+I hope that users who find it valuable willingly pay for it.
185 185
186 186
** How can I contribute to Pluckeye?
187 187
... ...
@@ -233,6 +233,49 @@ humans."
233 233
234 234
Are humans true animals? You make the call.
235 235
236
+** Would Pluckeye be a good filter for protecting a child? If not, do you know of one?
237
+
238
+This is hard to answer.
239
+
240
+Pluckeye was not designed with the child in mind. It could be used
241
+that way, especially by a conservative parent (such as the
242
+author!), but there are other tools available, including some built
243
+into Windows, macOS, or Chrome OS. If you're looking for a guide
244
+to set up something, you might find the following links useful.
245
+
246
+- [[https://protectyoungeyes.com/parental-controls-every-digital-device/]]
247
+- [[https://internetsafety101.org/parentalcontrols]] (kinda dated)
248
+- [[http://filters.pluckeye.net/?audience=parent]]
249
+
250
+** Can I subscribe to Pluckeye using paypal?
251
+
252
+Donations through paypal are not connected to the subscription
253
+system.
254
+
255
+You can [[file:donate.org][donate]] using paypal, and then periodically fill out surveys
256
+or request freebies, but a payment via paypal does not count as a
257
+subscription.
258
+
259
+If you are concerned about sending credit card information, you
260
+might be interested to know that on s.pluckeye.net, while your
261
+credit card is filled out while you are looking at the site, the
262
+number never goes to s.pluckeye.net; it only goes to stripe.com (a
263
+merchant gateway). That's a typical set up so that little guys
264
+like me don't have to deal with the added responsibility of seeing
265
+or storing actual credit card data.
266
+
267
+** I live in a country where credit cards are uncommon, can I subscribe without a credit card?
268
+
269
+Unfortunately, resources are so thin, the author has very little
270
+spare time for improving the payments system. If you can't
271
+subscribe because your live in a country where online subscriptions
272
+are handled differently, please [[contact][let the author know]] so he has some
273
+idea how often this happens, and if you could theoretically use
274
+SEPA or iDEAL, please also mention that. Then simply fill out
275
+quarterly surveys or request freebies, and feel free to support the
276
+project some other way (e.g., through recommending it somewhere if
277
+you feel it is worth recommending).
278
+
236 279
* Using Pluckeye
237 280
238 281
** What operating systems does Pluckeye support?
... ...
@@ -253,12 +296,13 @@ See the [[file:tips.org][tips]] page.
253 296
254 297
See the [[file:levels.org][installation levels]] page.
255 298
256
-** <<browsers>> What browsers does Pluckeye work with?
299
+** What browsers does Pluckeye work with?
257 300
258
-Firefox and Chrome. But at level 2, Pluckeye can block all
259
-browsers (i.e., Internet Explorer, Safari, and Opera).
301
+Firefox, Chrome, and some browsers based on them (such as Brave,
302
+Vivaldi, etc.). But at level 2, Pluckeye can block all browsers
303
+(i.e., Internet Explorer, Safari, and Opera).
260 304
261
-** <<commands>> Where do I type the pluck commands that are mentioned on this site?
305
+** Where do I type the pluck commands that are mentioned on this site?
262 306
263 307
#+BEGIN_SRC sh
264 308
pluck add "Allow mysite.org"
... ...
@@ -312,7 +356,7 @@ it.
312 356
pluck add "Allow https://flickr.com/photos/myfamily"
313 357
#+END_SRC
314 358
315
-** <<export>> Can I transfer (export/import) my Pluckeye settings between computers?
359
+** Can I transfer (export/import) my Pluckeye settings between computers?
316 360
317 361
Yes.
318 362
... ...
@@ -327,10 +371,11 @@ On Mac OS X or Linux:
327 371
On Windows
328 372
329 373
#+BEGIN_SRC bat
330
- "pluck.exe" export > %HOMEPATH%\Desktop\pluckeye-settings.txt
374
+ pluck.exe export > "%HOMEPATH%\Desktop\pluckeye-settings.txt"
331 375
#+END_SRC
332 376
333
-Copy pluckeye-settings.txt from the desktop of the destination computer.
377
+Copy pluckeye-settings.txt from the desktop of the source computer
378
+to the desktop on the destination computer.
334 379
335 380
Then, on the destination computer, import the settings:
336 381
... ...
@@ -343,7 +388,7 @@ On Mac OS X or Linux:
343 388
On Windows
344 389
345 390
#+BEGIN_SRC bat
346
- "pluck.exe" import %HOMEPATH%\Desktop\pluckeye-settings.txt
391
+ pluck.exe import "%HOMEPATH%\Desktop\pluckeye-settings.txt"
347 392
#+END_SRC
348 393
349 394
** How do I manually remove a rule?
... ...
@@ -358,7 +403,7 @@ At the command line, you can use pluck rm. For example,
358 403
pluck rm "Allow wikipedia.org"
359 404
#+END_SRC
360 405
361
-** <<syntax>> What is the complete syntax for rules and settings?
406
+** What is the complete syntax for rules and settings?
362 407
363 408
See [[file:rule-syntax.org]].
364 409
... ...
@@ -368,7 +413,7 @@ Hmm. What url? Please [[contact][let me know so I can investigate]] for the sa
368 413
369 414
There are a variety of ways to publish videos on the web.
370 415
371
-** I did not whitelistx a site, but I can download videos. How can I block them?
416
+** I did not whitelist a site, but I can download videos. How can I block them?
372 417
373 418
That's odd. Try these commands:
374 419
... ...
@@ -379,15 +424,15 @@ That's odd. Try these commands:
379 424
380 425
If that does not fix the problem, [[contact][give me the url (and optionally your email) so I can investigate]].
381 426
382
-** <<accountability>> Can Pluckeye notify my accountability partner?
427
+** Can Pluckeye notify my accountability partner?
383 428
384 429
See [[file:how-to-register-for-accountability.org]].
385 430
386
-** <<multiuser>> I share a computer with others. Is it possible for some users to use Pluckeye while other users are completely oblivious to Pluckeye's presence?
431
+** I share a computer with others. Is it possible for some users to use Pluckeye while other users are completely oblivious to Pluckeye's presence?
387 432
388 433
Yes. See [[file:multiuser.org]].
389 434
390
-** <<github.com>> How do I access github.com, rubygems.org, npmjs.org, and heroku.com from the command line? They all use https.
435
+** How do I access github.com, rubygems.org, npmjs.org, and heroku.com from the command line? They all use https.
391 436
392 437
Like so:
393 438
... ...
@@ -428,31 +473,43 @@ The solution to all of the above:
428 473
Also useful to some folks:
429 474
430 475
#+BEGIN_SRC sh
431
- pluck add "program $(which git) whiteout"
476
+ pluck add "program git whiteout"
477
+ pluck add "program git-remote-http whiteout"
478
+#+END_SRC
479
+
480
+** What about pip packages?
481
+
482
+On Linux:
483
+
484
+#+BEGIN_SRC sh
485
+ pluck add "Allow pypi.org"
486
+ pluck add "Allow pythonhosted.org"
432 487
#+END_SRC
433 488
434
-** <<homebrew>> How do I use [[https://brew.sh/][Homebrew]] on Mac OS X at installation level 2?
489
+** How do I use [[https://brew.sh/][Homebrew]] on Mac OS X at installation level 2?
490
+
491
+Run the following commands in a terminal.
435 492
436
-This once worked, but seems to no longer:
493
+#+BEGIN_SRC sh
494
+ cat >~/.pluckeye.homebrew.env $i
495
+ source ~/.pluckeye.homebrew.env
496
+#+END_SRC
497
+
498
+After that, allow the hosts that homebrew requires. E.g.:
437 499
438 500
#+BEGIN_SRC sh
439
- pluck add "allow homebrew.bintray.com"
440
- for i in ~/.bashrc ~/.bash_profile ~/.bash_login ~/.profile; do
441
- [ -f $i ] && break
442
- done
443
- echo "export HOMEBREW_NO_ENV_FILTERING=1" >>$i
444
- export HOMEBREW_NO_ENV_FILTERING=1
501
+ pluck add "allow bintray.com"
502
+ pluck add "allow gnu.org"
445 503
#+END_SRC
446 504
447
-So to use homebrew, you'll have to drop down to level 1 or use a
448
-periodic whiteout. E.g., to reserve a whiteout on Saturdays from
449
-12pm to 2pm:
505
+Alternatively, you could use a periodic whiteout. E.g., to reserve
506
+time on Saturdays from 12pm to 2pm for homebrew updating:
450 507
451 508
#+BEGIN_SRC sh
452 509
pluck add "sometimes A12-14 whiteout"
453 510
#+END_SRC
454 511
455
-** <<steam>> How do I unblock Steam?
512
+** How do I unblock Steam?
456 513
457 514
It depends on the operating system.
458 515
... ...
@@ -462,6 +519,16 @@ It depends on the operating system.
462 519
pluck add "program steamwebhelper.exe whiteout"
463 520
#+END_SRC
464 521
522
+If using [[file:nhb.org][nhb]], also use
523
+
524
+#+BEGIN_SRC sh
525
+ pluck add "program Steam.exe whiteout"
526
+#+END_SRC
527
+
528
+Note that some versions of Pluckeye before v0.98.14 have been
529
+known to block Steam from downloading games at level 2, regardless
530
+of the above settings. Use v0.98.14 or above to avoid that.
531
+
465 532
*** Linux
466 533
467 534
One way:
... ...
@@ -484,13 +551,14 @@ Another way:
484 551
485 552
See also [[https://support.steampowered.com/kb_article.php?ref=8571-GLVN-8711]]
486 553
487
-** <<minecraft>> How do I unblock Minecraft?
554
+** How do I unblock Minecraft?
488 555
489 556
See [[https://forum.pluckeye.net/viewtopic.php?id=101]]
490 557
491
-** <<youtube>> How can I watch videos on youtube?
558
+** How can I watch videos on youtube?
492 559
493
-It depends. One option is to schedule access to youtube. E.g.
560
+It depends. One option is to schedule access to youtube. E.g., to
561
+only allow media from youtube on Mondays 10am - 12pm:
494 562
495 563
#+BEGIN_SRC sh
496 564
pluck add "sometimes M10-12 allow youtube.com"
... ...
@@ -501,30 +569,30 @@ Another option is to allow one of the following "clean" youtube sites.
501 569
- [[http://cleanvideosearch.com/]]
502 570
- [[http://safeyoutube.net/]]
503 571
504
-Another option is to whitelist specific videos.
572
+Another option is to whitelist only specific videos.
505 573
506
-** <<playonlinux>> How do I use Playonlinux?
574
+** How do I use Playonlinux?
507 575
508 576
#+BEGIN_SRC sh
509 577
pluck add "allow repository.playonlinux.com"
510 578
#+END_SRC
511 579
512
-** <<uninstall>> How do I uninstall Pluckeye?
580
+** How do I uninstall Pluckeye?
513 581
514 582
See the uninstallation instructions on [[file:how-to-install.org]].
515 583
516
-** <<install-linux>> How do I install linux?
584
+** How do I install linux?
517 585
518 586
[[https://help.ubuntu.com/community/Lubuntu/GetLubuntu/LTS]]
519 587
[[http://www.ubuntu.com/download/desktop]]
520 588
521
-** <<torrents>> How do I block torrents?
589
+** How do I block torrents?
522 590
523 591
#+BEGIN_SRC sh
524 592
pluck add "block application/x-bittorrent"
525 593
#+END_SRC
526 594
527
-** <<block-most>> How do I block all websites except a few select ones?
595
+** How do I block all websites except a few select ones?
528 596
529 597
If you only want access to ok.com:
530 598
... ...
@@ -532,16 +600,15 @@ If you only want access to ok.com:
532 600
pluck add "Block"
533 601
pluck add "Allow pluckeye.net"
534 602
pluck add "Allow ok.com"
535
- pluck add "Package plucki"
536 603
#+END_SRC
537 604
538
-** <<isos>> How do I block downloading of a live ISO?
605
+** How do I block downloading of a live ISO?
539 606
540 607
#+BEGIN_SRC sh
541 608
pluck add "block application/x-iso9660-image"
542 609
#+END_SRC
543 610
544
-** <<pdfs>> How do I block or unblock pdfs or other documents?
611
+** How do I block or unblock pdfs or other documents?
545 612
546 613
To allow pdfs or doc files or other documents on specific sites,
547 614
one generally just allows a url, or a domain. E.g.,
... ...
@@ -559,7 +626,7 @@ To block pdfs on most sites:
559 626
560 627
See also the no-documents recipe on [[https://www.pluckeye.net/recipes/]]
561 628
562
-** <<programs>> How do I block downloading of all programs?
629
+** How do I block downloading of all programs?
563 630
564 631
Try the "no-programs" recipe:
565 632
... ...
@@ -567,7 +634,7 @@ Try the "no-programs" recipe:
567 634
- [[http://www.pluckeye.net/recipes/macosx/no-programs.txt]]
568 635
- [[http://www.pluckeye.net/recipes/linux/no-programs.txt]]
569 636
570
-** <<safeyoutube>> How do I watch videos on safeyoutube.net while blocking youtube.com?
637
+** How do I watch videos on safeyoutube.net while blocking youtube.com?
571 638
572 639
#+BEGIN_SRC sh
573 640
pluck add "Block video/"
... ...
@@ -583,7 +650,7 @@ should work. But it might not in some versions of Firefox.
583 650
584 651
will not work because "Block youtube.com" will block videos from
585 652
safeyoutube.net.
586
-** <<editors>> Is there a way to modify the settings in an ordinary editor?
653
+** Is there a way to modify the settings in an ordinary editor?
587 654
588 655
If you only want to add settings:
589 656
... ...
@@ -602,7 +669,7 @@ If you want to remove a lot of settings:
602 669
pluck import settings.txt
603 670
#+END_SRC
604 671
605
-** <<cpu-spins>> I notice my CPU "spinning". Does Pluckeye slow down Firefox and/or my computer?
672
+** I notice my CPU "spinning". Does Pluckeye slow down Firefox and/or my computer?
606 673
607 674
Sometimes. In particular, some common sites such as
608 675
... ...
@@ -610,15 +677,15 @@ Sometimes. In particular, some common sites such as
610 677
- [[http://nytimes.com/]]
611 678
- [[http://thesaurus.com/]]
612 679
613
-contain advertizing-related javascript that reacts poorly to the
614
-advertizements being blocked. Such javascript will sometimes cause
680
+contain advertising-related javascript that reacts poorly to the
681
+advertisements being blocked. Such javascript will sometimes cause
615 682
the CPU to "spin in a loop" while it tries continuously to load
616 683
ads.
617 684
618 685
If you notice your CPU is being heavily utilized by Firefox, close
619 686
some tabs until the CPU spinning goes away. Alternatively, you can
620 687
close Firefox completely and restart it.
621
-** <<nightguard>> How can I completely cut off Internet access at night?
688
+** How can I completely cut off Internet access at night?
622 689
623 690
To schedule daily blackouts from midnight to 6am and from 9pm (21:00) to midnight:
624 691
... ...
@@ -626,7 +693,7 @@ To schedule daily blackouts from midnight to 6am and from 9pm (21:00) to midnigh
626 693
pluck add "sometimes 0-6&21-24 blackout"
627 694
#+END_SRC
628 695
629
-** <<sometimes>> How can I schedule access? What format do so-called "sometimes" settings take?
696
+** How can I schedule access? What format do so-called "sometimes" settings take?
630 697
631 698
To allow youtube.com from 8am to 9am:
632 699
... ...
@@ -640,6 +707,12 @@ The same thing, but only for Mondays:
640 707
pluck add "sometimes M8-9 allow youtube.com"
641 708
#+END_SRC
642 709
710
+Enable NHB except on Sunday from 11:30 to 12:00
711
+
712
+#+BEGIN_SRC sh
713
+ pluck add "sometimes U0-1130&12-24.MTWRFA0-24 nhb"
714
+#+END_SRC
715
+
643 716
The schedule format used by sometimes rules is not well documented,
644 717
but perhaps the following legend will enlighten.
645 718
... ...
@@ -651,21 +724,71 @@ and drag your desired schedule, and a properly-formatted sometimes
651 724
string should show at the top of the page. The page supports daily
652 725
or weekly schedules.
653 726
654
-** <<app-store>> Does Pluckeye interfere with the Mac App Store and iTunes? If so, how can I use the App Store?
727
+** How can I block audio by default?
655 728
656
-Yes. From the known issues:
729
+#+BEGIN_SRC sh
730
+ pluck add "block audio/"
731
+#+END_SRC
657 732
658
-#+BEGIN_QUOTE
659
-On Mac OS X, at installation level 2, iTunes and the App
660
-Store are blocked on some machines. The current workaround is to
733
+** Does Pluckeye interfere with the Mac App Store, iTunes, and Apple Mail? If so, how can I use them?
734
+
735
+It depends on your Pluckeye settings, and your version of Mac OS X.
736
+In v0.99.14+ you may be able to allow these programs. Note that
737
+this syntax is only valid for v0.99.x and above.
738
+
739
+The App Store, in macOS 10.13 or so and above:
740
+
741
+#+BEGIN_SRC sh
742
+ pluck + allow program App Store
743
+ pluck + allow program commerce
744
+#+END_SRC
745
+
746
+iTunes
747
+
748
+#+BEGIN_SRC sh
749
+ pluck + allow program iTunes
750
+#+END_SRC
751
+
752
+Mail
753
+
754
+#+BEGIN_SRC sh
755
+ pluck + allow program Mail
756
+#+END_SRC
757
+
758
+Note that you may need to configure Mail using [[https://static.pluckeye.net/images/screenshots/mac14-mail-account-provider-other.png][Other Mail Account]].
759
+For Gmail accounts, you will need to enable the [[https://myaccount.google.com/lesssecureapps][less secure apps
760
+option.]]
761
+
762
+Note that the above settings will not permit images in most HTML
763
+email. Such images can't be allowed at present without also
764
+allowing *all of Safari*, a feature that almost no Plucker wants.
765
+
766
+In Pluckeye before v0.99, at installation level 2, iTunes and the
767
+App Store are blocked on some machines. The workaround is to
661 768
periodically drop down to level 1 to apply updates from the App
662 769
Store.
663
-#+END_QUOTE
664 770
665
-If you would like to see this changed, you can [[https://pluckeye.uservoice.com/forums/137031-general/suggestions/18120082-improve-support-for-the-app-store-and-or-itunes][vote for improved
666
-App Store support]].
771
+If you use macOS 10.12 or below, you may not be able to allow the
772
+App Store without also allowing Safari. In which case, a periodic
773
+allowance for WebKit might be useful. For example, to allow WebKit
774
+(includes Safari and the App Store) on Mondays from 10am to 12pm:
667 775
668
-** <<allow-all>> How do I allow all websites and then only block specific ones?
776
+#+BEGIN_SRC sh
777
+ pluck + allow program App Store
778
+ pluck + when M10-12 allow program com.apple.WebKit
779
+#+END_SRC
780
+
781
+** How can I block the Windows App Store?
782
+
783
+The Microsoft App Store is blocked by [[file:nhb.org][nhb]]. But if nhb is too
784
+severe for you, if if using Pluckeye v0.99.24+, the app store can
785
+be blocked with
786
+
787
+#+BEGIN_SRC sh
788
+ pluck + block program winstore.app.exe
789
+#+END_SRC
790
+
791
+** How do I allow all websites and then only block specific ones?
669 792
670 793
Really? With Pluckeye? Shrug.
671 794
... ...
@@ -677,16 +800,36 @@ Really? With Pluckeye? Shrug.
677 800
678 801
2. Block the sites you want to block.
679 802
680
-** <<factory-reset>> How do I reset Pluckeye to its default settings, with all images being blocked?
803
+** How do I reset Pluckeye to its default settings, with all images being blocked?
681 804
682 805
#+BEGIN_SRC sh
683 806
pluck factoryreset
684 807
#+END_SRC
685 808
686
-** <<hard-mode>> What if I think Pluckeye doesn't block enough for my tastes?
809
+** What if I think Pluckeye doesn't block enough for my tastes?
687 810
688 811
You may want to enable the [[file:nhb.org][NHB option]].
689 812
813
+** Does Pluckeye support password protection?
814
+
815
+Sort of, via the expedite feature. To set it up, you need to
816
+register both the supporter (i.e., friend / spouse / parent) and
817
+the primary user on [[https://u.pluckeye.net/]] . The friend can then
818
+approve requests made by the user. If the user has a a long delay,
819
+this is similar to traditional password protection.
820
+
821
+Alternatively, if you can allow somebody else to first register on
822
+[[https://u.pluckeye.net/]] using your device, that person can make the
823
+device "restricted", and you will no longer have ability to make
824
+any changes to its configuration; only that other person will.
825
+
826
+** How can I use my network printer when Pluckeye is at level 2 and blocks by default?
827
+
828
+#+BEGIN_SRC sh
829
+ pluck + allow port 3910
830
+ pluck + allow port 3911
831
+#+END_SRC
832
+
690 833
* Unanswered question?
691 834
692 835
[[file:contact.html][Contact me]].
firefox-56.org
... ...
@@ -19,8 +19,7 @@ options?
19 19
but not recommended because using an old, unsupported browser makes
20 20
you more vulnerable to malware, and malware is no fun.
21 21
22
-3. Try a [[https://www.mozilla.org/en-US/firefox/new][modern Firefox]] , [[https://www.google.com/chrome][Chrome]] , [[http://www.chromium.org/][Chromium]] , [[https://vivaldi.com/][Vivaldi]] , or other
23
- browser.
22
+3. Try a [[https://www.mozilla.org/en-US/firefox/new][modern Firefox]] , [[https://www.google.com/chrome][Chrome]] , [[http://www.chromium.org/][Chromium]] , or other browser.
24 23
25 24
* References
26 25
help.org
... ...
@@ -38,3 +38,8 @@
38 38
a message with your name, country, and phone number. If there's no
39 39
urgency, please use one of the resources above instead of phoning.
40 40
Thanks!
41
+
42
+* See also
43
+
44
+- [[https://u.pluckeye.net/doc/help]]
45
+- [[https://manual.pluckeye.net/]]
how-to-block-all-porn-on-android.org
... ...
@@ -40,7 +40,7 @@ See [[file:android.org]], [[http://filters.pluckeye.net/?os=android]], and
40 40
41 41
* The nuclear option (a dumb phone)
42 42
43
-Yes, in 2018, you can still get dumb phones. It's even [[https://www.fastcompany.com/40522828/this-is-what-its-like-to-not-own-a-smartphone-in-2018][become cool]].
43
+Yes, in 2019, you can still get dumb phones. It's even [[https://www.fastcompany.com/40522828/this-is-what-its-like-to-not-own-a-smartphone-in-2018][become cool]].
44 44
One way to find such phones is to search for "phone plans for
45 45
seniors" because they often want simple "talk/text" services. Here
46 46
are 5 real-life options!
how-to-build-net-responsibility-on-ubuntu.org
... ...
@@ -7,7 +7,7 @@
7 7
1. [[file:how-to-open-a-console-window.org][Open a terminal]].
8 8
2. In the terminal, paste the following:
9 9
10
- #+BEGIN_SRC shell
10
+ #+BEGIN_SRC sh
11 11
curl https://www.pluckeye.net/net-responsibility/build.sh | sh
12 12
#+END_SRC
13 13
how-to-do-covenant-eyes-on-linux.org
... ...
@@ -2,6 +2,18 @@
2 2
#+SETUPFILE: _base.org
3 3
#+HTML_HEAD: <meta name="description" content="How to achieve a Covenant Eyes-like setup on Linux using Pluckeye, the ProCon Latte Content Filter, and Accountable2You.">
4 4
5
+* This page is out of date
6
+
7
+The information on this page is out of date.
8
+
9
+See [[https://filters.pluckeye.net/?os=linux]] for products known to
10
+work on Linux, and [[https://filters.pluckeye.net/?platform=network]]
11
+for products that may work on or as a home router.
12
+
13
+The remainder of this page is retained for historical interest.
14
+
15
+* Out of date content follows
16
+
5 17
This page was created because
6 18
[[http://www.covenanteyes.com/2009/06/10/covenant-eyes-for-linux/]] is not
7 19
very helpful.
how-to-do-k9-on-linux.org
... ...
@@ -2,6 +2,14 @@
2 2
#+SETUPFILE: _base.org
3 3
#+HTML_HEAD: <meta name="description" content="How to achieve a K9-like setup on Linux using Pluckeye and the ProCon Latte Content Filter.">
4 4
5
+The information on this page is out of date because ProCon Latte is no
6
+longer available. :-(
7
+
8
+Feel free to give Pluckeye standalone a try, but don't expect it to be
9
+K9.
10
+
11
+* Out of date instructions
12
+
5 13
Around the web you may find recommendations to use the K9 browser from
6 14
Blue Coat. But [[http://k9webprotection.uservoice.com/forums/84793-general/suggestions/1197245-create-a-linux-version][K9 doesn't support linux]]. This page will describe how
7 15
to achieve a password-protected, K9-like experience using Pluckeye and
how-to-register-for-accountability.org
... ...
@@ -1,24 +1,43 @@
1 1
#+TITLE: How to Register for Accountability | Pluckeye
2
+#+SETUPFILE: _base.org
2 3
3 4
* How
4 5
5 6
1. Install Pluckeye.
6 7
7
-2. Using the device that has Pluckeye installed, create an account
8
- on [[https://u.pluckeye.net/]] . The site will automatically associate the
9
- device with the first user account that logs in using that
10
- device.
8
+2. Using the device that has Pluckeye installed, login to
9
+ [[https://u.pluckeye.net/]], creating an account if you have never
10
+ done that.
11
+
12
+3. [[https://u.pluckeye.net/invitations/new][Create a helper invitation]]. See also [[https://u.pluckeye.net/doc/get-helpers]] .
13
+
14
+4. Upload your configuration.
15
+
16
+ #+BEGIN_SRC sh
17
+ pluck upload
18
+ #+END_SRC
19
+
20
+5. Your helper should be able to now see your configuration,
21
+ including the last month of changes made to it, as well as
22
+ approve expedite requests.
11 23
12
-3. Invoke the following commands in a [[file:how-to-open-a-console-window.org][console window]]:
24
+Note that the legacy "registration basic" setting from v0.98.x and
25
+below is ignored in v0.99.x and newer.
13 26
14
- #+BEGIN_SRC sh
15
- pluck upload
16
- pluck resync
17
- #+END_SRC
27
+* How it used to work before Pluckeye v0.99.0
28
+
29
+1. Install Pluckeye.
30
+
31
+2. Register your settings (see [[Register][below]]).
32
+
33
+3. Using the device that has Pluckeye installed, create an account
34
+ on [[https://u.pluckeye.net/]] . The site will automatically the
35
+ device with the first user account that logs in using that
36
+ device.
18 37
19 38
4. [[https://u.pluckeye.net/invitations/new][Create a helper invitation]]. See also [[https://u.pluckeye.net/doc/get-helpers]] .
20 39
21
-* How to register and unregister in Pluckeye v0.98.15 and below:
40
+** How to register and unregister
22 41
23 42
At a [[file:how-to-open-a-console-window.org][console window]]:
24 43
installed.org
... ...
@@ -23,7 +23,8 @@ important Pluckeye settings such as the *Pluckeye Delay* and the
23 23
* Useful links when starting out
24 24
25 25
- [[file:tips.org][tips]]
26
-- [[file:recipes/][recipes (configuration examples)]]
26
+- [[https://u.pluckeye.net/doc/intro]]
27
+- [[file:recipes/][recipes (configuration examples)]] (old, for Pluckeye v0.98 and below)
27 28
28 29
* Stay informed
29 30
known-issues.org
... ...
@@ -5,12 +5,11 @@
5 5
partially or wholly incompatible with
6 6
7 7
- Covenant Eyes
8
- - K9
9 8
- Net Nanny
10 9
- Qustodio
11
- - X3watch
12 10
- BullGuard Antivirus
13 11
- possibly other filters
12
+ - jumpstart wifi hacker
14 13
When installed along with any of these products, the Internet may
15 14
become inaccessible (try restarting all browsers). If problems
16 15
persist, uninstall Pluckeye or one of the conflicting filters.
... ...
@@ -25,72 +24,83 @@
25 24
3. On some older versions of Windows, Pluckeye will not install.
26 25
Pluckeye should install correctly on Windows 7 Service Pack 1 or
27 26
newer, Windows Vista with Service Pack 2, or Windows XP with
28
- Service Pack 3.
27
+ Service Pack 3. You can get Windows 7 Service Pack 1 at
28
+ [[https://support.microsoft.com/en-us/help/15090/windows-7-install-service-pack-1-sp1]]
29 29
30
-4. On Mac OS X, per-program rules do not yet have any effect.
30
+4. On Mac OS X, at installation level 2, the App Store, iTunes, and
31
+ Mail apps may be blocked by default. It depends on what version of
32
+ Mac OS X it is and Pluckeye settings. To allow them
31 33
32
-5. On Mac OS X, at installation level 2, iTunes and the App Store are
33
- blocked on some machines. The current workaround is to
34
- periodically drop down to level 1 to apply updates from the App
35
- Store.
34
+ pluck + allow program App Store
35
+ pluck + allow program iTunes
36
+ pluck + allow program Mail
36 37
37
-6. On Mac OS X, in Chrome, the lockdown and blackout buttons do not
38
+ To block them:
39
+
40
+ pluck + block program App Store
41
+ pluck + block program iTunes
42
+ pluck + block program Mail
43
+
44
+ To provide feedback on this known issue, contact Jon who doesn't
45
+ have every version of Mac OS X.
46
+
47
+5. On Mac OS X, in Chrome, the lockdown and blackout buttons do not
38 48
work because the confirmation dialog box is immediately closed by
39 49
Chrome.
40 50
41
-7. Pluckeye only supports Linux x86-64 distributions with glibc 2.14
51
+6. Pluckeye only supports Linux x86-64 distributions with glibc 2.14
42 52
or above (circa 2012).
43 53
44
-8. Many distributions of Linux are not well supported. Pluckeye is
54
+7. Many distributions of Linux are not well supported. Pluckeye is
45 55
most likely to work on Debian-based and Arch-based distributions.
46 56
Pluckeye is not regularly tested on Gentoo or RHEL-based systems
47 57
such as Fedora, and may not work on such systems. If you would
48 58
like to volunteer to help test such systems, feel free to email
49 59
support@pluckeye.net.
50 60
51
-9. On uncommon Linux distributions that do not follow the Linux
61
+8. On uncommon Linux distributions that do not follow the Linux
52 62
Standard Base (e.g. SliTaz, Puppy Linux), Pluckeye may not install.
53 63
Pluckeye may still work on such distributions if the necessary
54 64
prerequisites are installed (e.g., perl).
55 65
56
-10. On some versions of Linux, at installation level 2, Google Chrome
57
- (google-chrome-stable) will not start. Chromium (chromium or
58
- chromium-browser), on the other hand, should work.
66
+9. On some versions of Linux, at installation level 2, Google Chrome
67
+ (google-chrome-stable) will not start. Chromium (chromium or
68
+ chromium-browser), on the other hand, should work.
59 69
60
-11. On Linux x86-64, at installation level 2, many electron-based
70
+10. On Linux x86-64, at installation level 2, many electron-based
61 71
applications fail to start. If this happens to an app you care
62 72
about, do report it to Pluckeye staff.
63 73
64
-12. In Firefox 57+, especially on slow machines, the Pluckeye panel
74
+11. In Firefox 57+, especially on slow machines, the Pluckeye panel
65 75
may only show a "help" button. In most cases the full panel is
66 76
shown a few seconds after Firefox starts.
67 77
68
-13. If Firefox is installed after Pluckeye, then the Pluckeye button
78
+12. If Firefox is installed after Pluckeye, then the Pluckeye button
69 79
will not appear in Firefox automatically. To fix this, go to
70 80
about:addons and enable the Plucki extension.
71 81
72
-14. Already existing firefox processes are not affected when a user
82
+13. Already existing firefox processes are not affected when a user
73 83
types the following in a console:
74 84
75 85
pluck add "package foo"
76 86
77 87
Firefox must be restarted for package settings to take effect.
78 88
79
-15. In Firefox 42 through Firefox 46, two Pluckeye buttons appear in
89
+14. In Firefox 42 through Firefox 46, two Pluckeye buttons appear in
80 90
the toolbar by default. To workaround the issue, go to
81 91
about:addons and disable the one named "Pluckeye". However, be
82 92
aware that this will also disable Pluckeye in any newer Firefoxes
83 93
that use the same profile. Speaking of which, why are you using
84 94
Firefox 42 through 46?
85 95
86
-16. Pluckeye only supports Chrome 45 or newer.
96
+15. Pluckeye only supports Chrome 45 or newer.
87 97
88
-17. When Chrome starts or a new tab is opened, the page sometimes says
98
+16. When Chrome starts or a new tab is opened, the page sometimes says
89 99
"The requested URL /__pluckeye_bounce__%2F_%2Fchrome%2Fnewtab was
90 100
not found on this server. That's all we know.". Navigating to a
91 101
site should work fine.
92 102
93
-18. If Pluckeye is set to level 2 before integrating with Chrome
103
+17. If Pluckeye is set to level 2 before integrating with Chrome
94 104
(e.g. before Chrome is even installed), or if the Pluckeye
95 105
extension is removed from Chrome while at level 2, then Chrome
96 106
will be completely blocked from the Internet. To fix this, drop
... ...
@@ -99,7 +109,7 @@
99 109
extension was removed by the user, you will need to either remove
100 110
your Chrome profile or install Pluckeye from the Chrome Web Store.
101 111
102
-19. If the user visits some particular websites, such as
112
+18. If the user visits some particular websites, such as
103 113
distrowatch.com, nytimes.com, thesaurus.com that host certain
104 114
types of ads, the CPU will spin while a tab is open on that
105 115
website. The root cause is thought to be javascript on the page
... ...
@@ -108,59 +118,17 @@
108 118
on such pages or to close such tabs. This issue seems to affect
109 119
Firefox more often than Chrome.
110 120
111
-20. Sometimes and Onetime settings permanently overwrite already
112
- existing settings that match the same setting. It is best to avoid
113
- using sometimes and onetime settings for hosts or urls that also
114
- have permanent settings (this might be fixed eventually).
115
-
116
-21. Sometimes unreliability. The sometimes rules sometimes interact
117
- badly with non-sometimes rules, or with each other. The whole
118
- sometimes system will soon be replaced. If you want to avoid
119
- sometimes rules altogether, use
120
-
121
- pluck add "nosometime"
122
-
123
- If you would like to force a different algorithm with respect to
124
- the delay imposed on sometimes rules, use
125
-
126
- pluck add "slowsometime"
127
-
128
- It is hoped these options will not be necessary for long.
129
-
130
-22. Invoking pluck with bogus settings does not always yield an error.
131
- For example, if a user invokes
132
-
133
- pluck add "program block firefox"
134
-
135
- rather than the correct
136
-
137
- pluck add "program firefox blackout"
138
-
139
- then instead of rejecting the bad syntax, pluck accepts it as a
140
- rule that does nothing on the program "block".
141
-
142
-23. When upgrading from one major version of Pluckeye to another,
121
+19. When upgrading from one major version of Pluckeye to another,
143 122
pending settings are lost. The workaround is to re-add the
144 123
pending settings after upgrading.
145 124
146
-24. If a sometimes rule is removed while it is in effect, the
147
- corresponding time-bounded setting remains. The workaround is to
148
- remove the corresponding setting manually:
149
-
150
- pluck add "sometimes 0-24 allow a.com"
151
- pluck del "sometimes 0-24 allow a.com"
152
-
153
- Also needed:
154
-
155
- pluck del "a.com"
156
-
157
-25. Attempting to reduce the delay on the settings page by
125
+20. Attempting to reduce the delay on the settings page by
158 126
double-clicking the "Apply" button on that page will cause the
159 127
delay to remain unchanged. This occurs because the first click
160 128
sets a pending delay, and the second click removes it. The
161 129
workaround is to only click "Apply" once.
162 130
163
-26. In Chrome, if a button that requires confirmation is clicked
131
+21. In Chrome, if a button that requires confirmation is clicked
164 132
(e.g. abort, lockdown, or blackout), the confirmation box may
165 133
render outside of the visible area. One workaround is to resize
166 134
the Chrome window as that sometimes makes the confirmation box
levels.org
... ...
@@ -1,18 +1,16 @@
1 1
#+TITLE: Installation Levels | Pluckeye
2 2
#+SETUPFILE: _base.org
3 3
4
-*** Level 0
4
+* Terms
5 5
6
-The Pluckeye extension for Firefox or Chrome is
6
+- Level 0 :: The Pluckeye extension for Firefox or Chrome is
7 7
installed from the [[https://addons.mozilla.org/en-US/firefox/][Mozilla Add-ons]] site or from the
8 8
[[https://chrome.google.com/webstore/category/extensions][Chrome Web Store]]. As long as the extension is enabled,
9 9
images will be blocked within Firefox or Chrome: no
10 10
whitelist, no blacklist, no configuration, no options.
11 11
12
-*** Level 1
13
-
14
-Level 1 is the default when Pluckeye is first installed
15
- from the [[http://www.pluckeye.net/try-it.html][try it page]]. Level 1 includes system
12
+- Level 1 :: Level 1 is the default when Pluckeye is first installed
13
+ from the [[file:try-it.html][try it page]]. Level 1 includes system
16 14
binaries as well as the Pluckeye extensions for Firefox
17 15
and Chrome. As long as the extension is enabled, level
18 16
1 allows use of most Pluckeye features in Firefox or
... ...
@@ -21,16 +19,14 @@ Level 1 is the default when Pluckeye is first installed
21 19
Pluckeye without firmly locking down one's Internet
22 20
access.
23 21
24
-*** Level 2
25
-
26
-Also known as *self-control mode*, level 2 prevents the
22
+- Level 2 :: Also known as *self-control mode*, level 2 prevents the
27 23
user from easily bypassing Pluckeye. In addition to
28 24
Firefox and Chrome, other browsers on the computer such
29 25
as Safari and Internet Explorer are filtered or
30 26
blocked. See the platform notes below. The author
31 27
originally expected that most users would use level 2.
32 28
33
-*** Why isn't level 2 the default?
29
+* Why isn't level 2 the default?
34 30
35 31
Level 1 is the default level mainly as a safety measure. By
36 32
requiring the user to set the level manually, the user is then
... ...
@@ -41,15 +37,10 @@ level 1 to be sufficient help for themselves.
41 37
42 38
*** Level 2 on Windows
43 39
44
-On Windows, level 2 means that only Firefox and Chrome may be used
45
-for browsing the Internet; Internet Explorer, Microsoft Edge, and
46
-all other browsers other than Firefox and Chrome *will not work at
47
-all*.
48
-
49
-*** Level 2 on Mac OS X
50
-
51
-On Mac OS X, level 2 means that Safari, the App Store, and iTunes
52
-will not work at all. See also [[file:known-issues.org][Known Issues]].
40
+On Windows, level 2 means that only Firefox, Chrome, and browsers
41
+based on them (e.g. Brave) may be used for browsing the Internet;
42
+Internet Explorer, Microsoft Edge, and all other browsers other
43
+than Firefox and Chrome *will not work at all*.
53 44
54 45
*** Level 2 on Linux
55 46
... ...
@@ -71,12 +62,11 @@ See also [[http://www.pluckeye.net/quickstart-windows-7.html#installation-level]
71 62
*** Method 2, command line
72 63
73 64
**** Windows
65
+
74 66
#+BEGIN_EXAMPLE
75
- C:\> pluck set "delay 0"
76
-#+END_EXAMPLE
67
+C:\> pluck set "delay 0"
77 68
. . . wait until delay setting has taken effect . . .
78
-#+BEGIN_EXAMPLE
79
- C:\> pluck set "level 2"
69
+C:\> pluck set "level 2"
80 70
#+END_EXAMPLE
81 71
82 72
multiuser.org
... ...
@@ -1,6 +1,27 @@
1 1
#+TITLE: Multiple Users | Pluckeye
2 2
#+SETUPFILE: _base.org
3 3
4
+* This page is out of date
5
+
6
+** v0.99.10 and above
7
+
8
+The old multiuser support has been dropped in Pluckeye v0.99.10 and
9
+above. It has been replaced with the simpler ability to simply
10
+apply a whiteout to specific users.
11
+
12
+#+BEGIN_SRC sh
13
+ pluck + allow user:susan
14
+ pluck + allow user:\\paravel\polly
15
+ pluck + when 8-11 allow user:lucy
16
+#+END_SRC
17
+
18
+** v0.98.15 and below
19
+
20
+The information on this page is out of date. It applied to Pluckeye
21
+0.98.15 and below.
22
+
23
+The remainder of this page is retained for historical interest.
24
+
4 25
* Overview
5 26
6 27
By default, Pluckeye settings are [[shared][shared]] amongst all Pluckeye users
... ...
@@ -15,11 +36,11 @@ computer Susan also uses, the same rule applies to Susan
15 36
automatically, and vice versa. If Peter wants his own private
16 37
rules, he should enable [[Personal][personal]] settings for himself.
17 38
18
-** Windows-specific prerequisite: all users install Pluckeye or [[file:plucki.org][Plucki]].
39
+** Windows-specific prerequisite: all users install Pluckeye.
19 40
20 41
See [[windows-scenarios][the windows scenarios below]] for explanation.
21 42
22
-* <<shared>> Shared
43
+* Shared
23 44
24 45
When a user has shared settings, all Internet access checks are done
25 46
using the shared settings, and all changes made to Pluckeye settings
... ...
@@ -34,7 +55,7 @@ to the shared settings:
34 55
pluck user shared add "allow foo.com" # this would do the same
35 56
#+END_SRC
36 57
37
-* <<personal>> Personal
58
+* Personal
38 59
39 60
Settings may also be personal rather than shared.
40 61
... ...
@@ -43,26 +64,25 @@ done using the personal settings, and all changes made to
43 64
Pluckeye settings change the personal settings.
44 65
45 66
The first time a user is explicitly named on the command line after
46
-"pluck user", personal settings are created for the user. So, to
47
-enable personal settings for a user, do the following,
67
+"pluck user NAME init", personal settings are created for the user.
68
+So, to enable personal settings for a user, do the following,
48 69
49 70
on Windows:
50 71
51 72
#+BEGIN_EXAMPLE
52
-C:\> pluck user %USERNAME%
73
+C:\> pluck user %USERNAME% init
53 74
#+END_EXAMPLE
54 75
55 76
on Linux and Mac OS X:
56 77
57 78
#+BEGIN_SRC sh
58
- pluck user $(whoami)
79
+ pluck user $(whoami) init
59 80
#+END_SRC
60 81
61
-Note that personal settings would also be created if an explict
62
-command such as export is used at time of initial creation. E.g.,
82
+For example, the following will create settings for peter:
63 83
64 84
#+BEGIN_SRC sh
65
- pluck user peter export # will create personal settings for peter
85
+ pluck user peter init
66 86
#+END_SRC
67 87
68 88
After personal settings have been created for a user, the user may
... ...
@@ -80,31 +100,59 @@ personal user settings.
80 100
The following scenarios describe how to setup a machine with
81 101
multiple users for use with Pluckeye.
82 102
83
-** <<windows-scenarios>> Windows
103
+** Windows
84 104
85 105
Multiuser setup on Windows is complicated by the fact that each
86
-user must install [[file:plucki.org][Plucki]] or Pluckeye for Firefox integration. This
106
+user must install Pluckeye for Firefox integration. This
87 107
paragraph does not apply to Chrome. This prerequisite is unique to
88 108
Windows because of Mozilla rules regarding Firefox addons.
89 109
90 110
If any user has already set the installation level to 2, then other
91
-users will be unable to download [[file:plucki.org][Plucki]] or Pluckeye unless a
111
+users will be unable to download or install Pluckeye unless a
92 112
whiteout is in effect. Oops! Hence, the order of installation
93 113
operations is extra sensitive on Windows.
94 114
115
+*** Note on non-administrative users
116
+
117
+For each user that is to have Pluckeye-specific settings,
118
+temporarily make them an administrator of the computer so that
119
+each can run the Pluckeye installer. After Pluckeye is installed,
120
+then you may remove the Administrator access from the standard
121
+users. Running the installer with the credentials of another user
122
+will not result in a *complete* installation for the
123
+non-administrator.
124
+
125
+1. If Pluckeye is already installed, set the delay to 0 and the level to 1.
126
+
127
+ #+BEGIN_SRC sh
128
+ pluck set "delay 0"
129
+ echo you may need to wait for any preexisting delay to elapse before the next command
130
+ pluck set "level 1"
131
+ #+END_SRC
132
+
133
+2. Make Peter an Administrator.
134
+3. Log Peter out of the computer if he was already logged in.
135
+4. Log Peter in.
136
+5. As Peter, run the Pluckeye installer.
137
+6. Log Peter out.
138
+7. Make Peter a standard user.
139
+8. Repeat steps 2-7 for every user on the computer.
140
+9. As an Administrator, set the level to 2.
141
+10. As Peter, log in and use Pluckeye like normal.
142
+
95 143
*** Scenario 1: Peter uses Pluckeye at installation level 1, Susan does not use Pluckeye
96 144
97 145
1. Peter: Install Pluckeye.
98 146
99 147
*** Scenario 2: Peter and Susan both use Pluckeye at installation level 1
100 148
101
-1. Peter: Install Pluckeye, and leave at level 1 so that Susan can install Plucki.
102
-2. Susan: Install [[file:plucki.org][Plucki]].
149
+1. Peter: Install Pluckeye, and leave at level 1 so that Susan can install Pluckeye.
150
+2. Susan: Install Pluckeye.
103 151
104 152
*** Scenario 3: Peter and Susan both use Pluckeye at installation level 2
105 153
106
-1. Peter: Install Pluckeye, and leave at level 1 so that Susan can install Plucki.
107
-2. Susan: Install [[file:plucki.org][Plucki]].
154
+1. Peter: Install Pluckeye, and leave at level 1 so that Susan can install Pluckeye.
155
+2. Susan: Install Pluckeye.
108 156
3. Peter or Susan: Set Pluckeye to level 2 (in Firefox or Chrome or via `pluck set "level 2"`).
109 157
110 158
*** Scenario 4: Peter uses Pluckeye at installation level 2, Susan at installation level 1
... ...
@@ -120,7 +168,7 @@ See [[inconspicuous][inconspicuous]] setup.
120 168
*** Scenario 6: Peter uses Pluckeye at installation level 1, Susan does not use Pluckeye
121 169
122 170
1. Peter: Install Pluckeye
123
-2. Susan: Disable Plucki in about:addons
171
+2. Susan: Disable Pluckeye in about:addons
124 172
125 173
*** Scenario 7: Peter and Susan both use Pluckeye at installation level 1
126 174
... ...
@@ -135,7 +183,7 @@ See [[inconspicuous][inconspicuous]] setup.
135 183
136 184
See [[inconspicuous][inconspicuous]] setup.
137 185
138
-* <<inconspicuous>> How to setup Pluckeye inconspicuously
186
+* How to setup Pluckeye inconspicuously
139 187
140 188
Some users of Pluckeye would like other users of the same computer
141 189
to not be aware of Pluckeye. As of version 0.28.0, this may be
... ...
@@ -151,6 +199,7 @@ personal rule set *for Susan* that contains a whiteout rule.
151 199
*** Windows XP, Windows Vista, and Windows 7
152 200
153 201
#+BEGIN_EXAMPLE
202
+C:\> pluck user Susan init
154 203
C:\> pluck user Susan add whiteout
155 204
#+END_EXAMPLE
156 205
... ...
@@ -160,7 +209,7 @@ own personal settings and put a 2 hour delay in the shared settings
160 209
(which the guest account would use):
161 210
162 211
#+BEGIN_EXAMPLE
163
-C:\> pluck user Peter
212
+C:\> pluck user Peter init
164 213
C:\> pluck user shared set "delay 2 hours"
165 214
#+END_EXAMPLE
166 215
... ...
@@ -172,6 +221,7 @@ Pluckeye does not yet support an inconspicuous setup for Windows
172 221
** On Linux
173 222
174 223
#+BEGIN_SRC sh
224
+ pluck user susan init
175 225
pluck user susan add whiteout
176 226
#+END_SRC
177 227
nhb.org
... ...
@@ -8,6 +8,6 @@ Pluckeye up through release 0.74.0 had distinct nhb variants.
8 8
Pluckeye 0.75.0 and on have an nhb option that can be set using the
9 9
Pluckeye button > Settings > Advanced, or using the command line.
10 10
11
-#+BEGIN_SRC shell
11
+#+BEGIN_SRC sh
12 12
pluck add "nhb"
13 13
#+END_SRC
options.org
... ...
@@ -1,64 +1,47 @@
1 1
#+SETUPFILE: _base.org
2 2
#+TITLE: Options | Pluckeye
3 3
4
-*** allow
4
+* blackout
5 5
6
-Whitelists a program/webpage/website.
6
+Disables all Internet access; often coupled with a [[sometimes]] setting.
7 7
8
-*** blackout
9
-
10
-Disables all Internet access; often coupled with a *sometimes* setting.
11
-
12
-*** block
13
-
14
-Blacklists a program/webpage/website.
15
-
16
-*** nhb
17
-
18
-/No-Holds-Barred, a term used to describe fighting competitions that allow dangerous maneuvers./
8
+* nhb
19 9
20 10
Make some blocking decisions even more aggressive. Don't hold back.
21
-
22 11
It only has effect at level 2.
23 12
24
-Pluckeye up through release 0.74.0 had distinct nhb variants. Pluckeye 0.75.0 and on have an nhb option that can be set using the *Pluckeye button > Settings > Advanced*, or using the command line.
25
-
26
-#+BEGIN_SRC shell
27
- pluck add "nhb"
28
-#+END_SRC
29
-
30
-*** noapproval
13
+* noapproval
31 14
32 15
Disable the approval system.
33 16
34
-*** nochrome
17
+* nochrome
35 18
36 19
Do not allow Chrome, or Chromium-based browser such as Vivaldi to be
37 20
used at level 2 (unless a whiteout is in effect).
38 21
39
-*** nofirefox
22
+* nofirefox
40 23
41 24
Prevents firefox 57+ from utilizing the Pluckeye extension.
42 25
43
-*** nosometime
26
+* nosometime
44 27
45
-Disables all *sometimes* rules.
28
+Disables all sometimes rules.
46 29
47
-*** registration
30
+* registration
48 31
49 32
[[file:how-to-register-for-accountability.org][Register]] settings as an accountability measure.
50 33
51
-*** slowsometime
34
+* slowsometime
52 35
53
-Like *nosometime*, except that it changes the delay algorithm used for
54
-*sometimes* rules rather than making all sometimes rules ineffective.
55
-In particular, all *sometimes* rule will be delayed with this option.
36
+Like [[nosometime]], except that it changes the delay algorithm used for
37
+sometimes rules rather than making all sometimes rules ineffective.
38
+In particular, all sometimes rule will be delayed with this option.
56 39
57
-*** slowunbork
40
+* slowunbork
58 41
59
-Allows *unbork* to wait for more than 24 hours to run.
42
+Allows unbork to wait for more than 24 hours to run.
60 43
61
-*** sometimes
44
+* sometimes
62 45
63 46
Do something according to a [[https://u.pluckeye.net/hrs3][schedule]]. E.g,
64 47
platforms.org
... ...
@@ -6,22 +6,13 @@
6 6
| Platform | Supported? |
7 7
|-------------------------+----------------------|
8 8
| Windows 7+ | Yes |
9
-| Mac OS X 10.9+ | Yes |
9
+| Mac OS X 10.6.8+ | Yes |
10 10
| Linux | Yes (most distros) |
11
-| Android | [[https://manual.pluckeye.net/android][alpha]] |
11
+| Android | [[file:android.html][alpha]] |
12 12
| iOS | [[https://pluckeye.uservoice.com/forums/137031-general/suggestions/12237957-port-pluckeye-to-ios][request it]] |
13 13
| Windows Mobile | [[https://pluckeye.uservoice.com/forums/137031-general][request it]] |
14 14
| Chrome OS (chromebooks) | [[http://www.chromium.org/chromium-os/how-tos-and-troubleshooting/developer-faq#TOC-Are-native-applications-supported-][not possible, AFAICT]] |
15 15
16
-* Old platforms
17
-
18
-| Platform | Use | Do not use |
19
-|------------------------------+---------------------------+------------|
20
-| Windows XP | v0.95.7 (or maybe newer?) | ? |
21
-| Mac OS X 10.6.8 Snow Leopard | v0.97.10 | v0.98+ |
22
-| Mac OS X 10.7 Lion | v0.97.10 | v0.98+ |
23
-| Mac OS X 10.8 Mountain Lion | v0.97.10 | v0.98+ |
24
-
25 16
** By version and date of debut
26 17
27 18
| Platform \ Level | 0 | 1 | 2 |
... ...
@@ -35,6 +26,6 @@
35 26
| Android | 2018-02-03 | 2018-02-03 | [[https://pluckeye.uservoice.com/forums/137031-general/suggestions/6474260-port-pluckeye-to-android][request it]] |
36 27
| iOS | [[https://pluckeye.uservoice.com/forums/137031-general/suggestions/12237957-port-pluckeye-to-ios][request it]] | [[https://pluckeye.uservoice.com/forums/137031-general/suggestions/12237957-port-pluckeye-to-ios][request it]] | [[https://pluckeye.uservoice.com/forums/137031-general/suggestions/12237957-port-pluckeye-to-ios][request it]] |
37 28
38
-* Installation levels
29
+* <<installation-levels>> Installation levels
39 30
40
-See [[https://manual.pluckeye.net/levels][Levels]].
31
+See [[file:levels.org]].
release-notes.org
... ...
@@ -226,7 +226,7 @@ Internal build.
226 226
sync-ed to [[https://u.pluckeye.net/]] . If you'd like to avoid the
227 227
sync, you can use the nosync option. It is enabled by default.
228 228
229
- #+BEGIN_SRC shell
229
+ #+BEGIN_SRC sh
230 230
pluck add nosync
231 231
#+END_SRC
232 232
sysinspect.org
... ...
@@ -6,6 +6,10 @@
6 6
I have built a special executable to help me investigate problems on
7 7
user machines.
8 8
9
+The output of the tool is only useful if you run it while there is a
10
+problem. For example, if you have problems at level 2, and you run
11
+the tool while at level 1, the output is of little worth.
12
+
9 13
* <<windows>> On Windows
10 14
11 15
1. Download [[https://www.pluckeye.net/downloads/sysinspect/sysinspect-windows.exe]]
... ...
@@ -14,9 +18,9 @@ user machines.
14 18
15 19
3. Run it.
16 20
17
-4. It will create sysinspect-windows.exe.out (on your desktop if you did step 2).
21
+4. It will create sysinspect-windows.out (on your desktop if you did step 2).
18 22
19
-5. Send me sysinspect-windows.exe.out (/support-email/)
23
+5. [[https://e.pluckeye.net/upload-sysinspect][Upload sysinspect-windows.out]] if you can, or email it to /support-email/.
20 24
21 25
* <<macosx>> On Mac OS X
22 26
... ...
@@ -50,7 +54,7 @@ user machines.
50 54
51 55
5. It will create sysinspect-macosx.out (on your desktop if you did step 2).
52 56
53
-6. Send me sysinspect-macosx.out (/support-email/)
57
+6. [[https://e.pluckeye.net/upload-sysinspect][Upload sysinspect-macosx.out]] if you can, or email it to /support-email/.
54 58
55 59
* <<linux>> On Linux
56 60
... ...
@@ -73,4 +77,4 @@ user machines.
73 77
74 78
5. It will create sysinspect-linux.out (on your desktop if you did step 2).
75 79
76
-6. Send me sysinspect-linux.out (/support-email/)
80
+6. [[https://e.pluckeye.net/upload-sysinspect][Upload sysinspect-linux.out]] if you can, or email it to /support-email/.
tips.org
... ...
@@ -1,7 +1,18 @@
1 1
#+TITLE: Tips | Pluckeye
2 2
#+SETUPFILE: _base.org
3 3
4
-* Install both Firefox and Chrome, and maybe Pale Moon or Vivaldi
4
+* Be aware of `pluck repair`
5
+
6
+In Pluckeye v0.99 and above, if something doesn't work correctly
7
+after installing, [[file:how-to-open-a-console-window.org][open a console]] and invoke:
8
+
9
+#+BEGIN_SRC sh
10
+ pluck repair
11
+#+END_SRC
12
+
13
+That fixes some common problems, especially on macOS.
14
+
15
+* Install both Firefox and Chrome, and maybe Pale Moon
5 16
6 17
Having both Firefox and Chrome gives you additional protection in
7 18
case something goes wrong with Pluckeye. If you are comfortable at
... ...
@@ -12,11 +23,12 @@ to enable the Pluckeye extension manually. In Firefox, type
12 23
"about:addons" in the location bar, click "Extensions", and search
13 24
for Pluckeye.
14 25
15
-** Maybe try Pale Moon or Vivaldi
26
+** Maybe try Pale Moon
16 27
17
-[[http://palemoon.org/][Pale Moon]] and [[http://vivaldi.org/][Vivaldi]] are alternative browsers known to work well
18
-with Pluckeye. Pale Moon is akin to classic Firefox and Vivaldi is
19
-a descendant of Chromium.
28
+[[http://palemoon.org/][Pale Moon]] is an alternative browser, akin to classic Firefox.
29
+There are occasional problems with modern Firefox and Chrome that
30
+Pale Moon evades because it has a completely different engine under
31
+the hood.
20 32
21 33
* Use installation level 2
22 34
... ...
@@ -92,7 +104,7 @@ Allow access to amazon.com any day 10am to 12pm:
92 104
pluck add "Sometimes 10-12 Allow amazon.com"
93 105
#+END_SRC
94 106
95
-* <<whiteout>> Schedule a whiteout once a week.
107
+* Schedule a whiteout once a week.
96 108
97 109
If you think you can handle a periodic whiteout, it might alleviate
98 110
some of the pain in using Pluckeye. Depending on your settings,
... ...
@@ -142,24 +154,28 @@ when a better mind-set is restored:
142 154
143 155
* Learn about other Pluckeye features
144 156
145
-1. The expedite button is *really* useful in maintaining a long
157
+1. Several features, such as cross-device synchronization and
158
+ expediting changes, only work if you create a user account on
159
+ [[https://u.pluckeye.net/]] .
160
+
161
+2. The expedite button is *really* useful in maintaining a long
146 162
delay, but to use it you need to find some real-life human beings
147 163
to power it (a.k.a. [[https://u.pluckeye.net/doc/get-helpers][Pluckeye helpers]]). If you don't know who to
148 164
ask, maybe you could start a circle of Pluckeye helpers in the
149 165
[[https://forum.pluckeye.net/viewforum.php?id=5][Pluckeye forum]] or in [[https://www.reddit.com/r/pluckeye/][r/pluckeye]].
150 166
151
-2. Register Pluckeye for accountability or sharing settings between
167
+3. Register Pluckeye for accountability or sharing settings between
152 168
devices. See [[file:how-to-register-for-accountability.org]].
153 169
154
-3. The history button shows you what Pluckeye is blocking. It can
170
+4. The history button shows you what Pluckeye is blocking. It can
155 171
often help in situations where you do not understand why a
156 172
particular web page or document will or won't load.
157 173
158
-* Adapt and be creative
159
-Adapt; be creative; and be your own best friend, instead of worst enemy.
174
+* Adapt, be creative, and be your own best friend, instead of worst enemy
175
+
160 176
If you expect Pluckeye to "do it for you", you're doing it wrong.
161 177
162
-* <<prime-directive>> The Pluckeye prime directive
178
+* The Pluckeye prime directive
163 179
164 180
The most important principle in using Pluckeye is that you must
165 181
determine what boundaries you need to set. These boundaries are
... ...
@@ -175,7 +191,7 @@ to.
175 191
176 192
This principle can not be over-emphasized. Let it soak in.
177 193
178
-** <<love-inconvenience>> Learn to love inconvenience
194
+** Learn to love inconvenience
179 195
180 196
If you frequently bemoan the way Pluckeye interferes with normal
181 197
activity, you'll have 3 choices: