Pluckeye is an powerful Internet content filter, a kind of software that prevents the user from accessing parts of the Internet.
Pluckeye relies on setting the desired filter up and preventing the user to change it until a preset amount of time has passed.
The user has to set a time interval (i.e. delay) in order to Pluckeye prevent any change until said interval has passed.
Example: The user sets an eight hour interval and performs a modification.
- 00:00hs: The user blocks all images from the internet.
- 00:30hs: The user sets the delay to 8 hours.
- 01:00hs: The user allows ok.com to display images.
- 09:00hs: The site ok.com is now allowed to display images.
Blocking commands will take action immediately (such as
block) and allowing commands will take action after the delay has passed (such as
allow). The former will override the latter, but not viceversa.
Pluckeye is for:
Some mottos of the Pluckeye philosophy:
Pluckeye works on Windows, Mac OS X, Linux and Android.
Lockbox is a companion site of Pluckeye. It can save a password (or any text for that matter) and let the user access it only after a preset time has passed (after requesting acces to it).
The user may create a "box" that will save the password, set a delay and set how much time will elapse after the box is closed again once it is opened.
In order to use Pluckeye effectively, the user has to set a delay time and a level of enforcement, these are the corresponding commands.
pluck set "[delay/level] [value]"
Pluckeye can work in several enforcement levels (see the levels page and NHB page for more information). The delay must be set to 0 in order to be applied (which at the same time will depend on the current delay).
Pluckeye relies in the delay system, mentioned above (see the delay page for more information). It uses the s/m/h notation (for seconds/minutes/hours).
Example: Removing the delay.
Example: Setting the delay to 90 seconds.
Example: Setting the delay to 90 minutes.
Example: Setting the delay to 90 hours.
This command will reset Pluckeye to its factory settings (all images and videos from the internet will be blocked). The delay must be set to 0 in order to be applied (which at the same time will depend on the current delay).
In order to reset Pluckeye manually apply the following rules:
Pluckeye lets the user to save and load the settings.
pluck export > [filename]
This command exports the settings to a text file.
pluck import [filename]
This command imports the setting from a text file.
The user can uninstall Pluckeye after setting the delay to 0 (which also respects the current delay).
This command will erase Pluckeye settings. The delay must be set to 0 in order to be applied (which at the same time will depend on the current delay).
pluck [add/rm] [rule]
The user may add or remove rules according his or her needs.
Websites can be completely blocked or allowed.
"block http://my-college.edu/courses"(add restriction of specific part of domain)
"allow my-college.org"(add permission of whole domain)
Programs can be completely allowed or prevente do access the internet (level 2 must be enaled).
[allow/block] program [program]
program [program] [whiteout/blackout]
Example: Allow spotify to access the internet.
"allow program /usr/bin/spotify"(For Linux.)
Also, a program can be whitelisted the following by using the
Example: Whitelist spotify.
"program /usr/bin/firefox spotify"(For Linux.)
Pluckeye can allow block by MIME type (i.e. exe and mp4). The blocking can be applied to a type of media or to a specific type. Here are some examples:
"sometimes [value] [rule]"
The user may set a time schedule to apply the rules.
Example: Allow access on Monday through Friday, 10am to 12pm.
"sometimes MTWRF10-12 allow youtube.com"
Example: Allow access any day from 10am to 12pm.
"sometimes 10-12 allow youtube.com"
Example: Allow access now for 10 minutes (the delay will still be considered).
"sometimes now+10m allow youtube.com"
Example: Enable NHB except on Sunday from 11:30 to 12:00.
"sometimes U0-1130&12-24.MTWRFA0-24 nhb"(If this fails it can be splitted in two separate commands -divided by the & symbol-.)
The user may start the rules by using this command (for example after a whiteout).
This command is used to block the whole internet (pages won't load at all) and it will override any other command.
"sometimes now+10m blackout"
This command will pause any Pluckeye rule (they will stop being applied) and it will override every other command, except a blackout. It will be applied once the delay has passed.
Example: Set a whiteout for 10 minutes (that will apply once the delay has passed).
"sometimes now+10m whiteout"
Please perform the following searches before posting an issue.
How to schedule a Telegram web blocking (allowing it from 13:30 to 14:30):
"sometimes MTWRFA0000-1330 block web.telegram.org"
"sometimes MTWRFA1430-2130 block web.telegram.org"
The user can make scripts in order to run Pluckeye according to the needs.
pluck add nhb
pluck add "package plucki"
pluck add "registration [basic/none]"
pluck add block audio/