Frequently Asked Questions

1 About Pluckeye

1.1 What is Pluckeye?

Pluckeye is an Internet content filter, a kind of software that prevents the user from accessing parts of the Internet.

See also vision.html.

1.2 How does Pluckeye differ from other filters?

  • Pluckeye blocks all images and videos from the Internet by default.
  • Pluckeye doesn't use password protection; rather it uses a delay system for configuration. See also this question.
  • Pluckeye can block some content but allow other content from the same webhost (based on Internet media types).
  • Pluckeye doesn't come with a prepackaged list of web resources that it should block or allow; configuration is up to the end-user.
  • Pluckeye's target audience are those who want a filter for themselves rather than parents looking to protect their kids.
  • Pluckeye aims not at convenience but at inconvenience!
  • Pluckeye works on Windows, Mac OS X, and Linux, and Android. See also this question.

See also this site for a list of Internet filters.

1.3 Is Pluckeye easy to bypass?

No, not if you have installed Pluckeye at "installation level 2". See here for a more thorough description of installation levels.

1.4 But couldn't I just uninstall Pluckeye whenever I want?

No. The delay must first be set to 0 before Pluckeye will uninstall. See also the uninstall sequence described here.

But isn't Pluckeye just a browser extension that can be disabled in the browser?

That is true at installation level 1 (the default). But real users are expected to use installation level 2.

But couldn't I just set the delay to 0 and then uninstall?

Yes, but to set the delay to 0 you would have to wait one delay cycle.

But isn't Pluckeye easy to bypass?

Try it and see.

1.5 Is Pluckeye a porn filter?

Many users of Pluckeye are seeking to avoid porn, but Pluckeye can also be used to block other sources of online temptation such as email, gambling, gaming, shopping, and social media sites.

1.6 Wait, it blocks all images? Not just porn and clickbait?

Even photos of my Aunt Gertrude? What's the point of the Internet without pictures?!

That is 4 questions.

Yes, by default, all images on the Internet are blocked. But most Pluckeye users whitelist sites and/or use scheduling rules so they can see images on some or many sites. Pluckeye is designed to be configured by the user.

1.7 I can whitelist sites? What good is a filter if I can simply access whatever I want?

Well, there's what you want now, what you want 5 hours from now, and what you want to want 5 hours from now. To which of these wants are you referring?

Pluckeye is designed to help users choose "meta wants" rather than "carnal wants".

The means for this is a delayed configuration system that allows the user to make any changes to the filter configuration, but the changes only take effect after a delay.

It is similar to the debt-ridden consumer putting his emergency credit card in the freezer so it can't be used for impulse purchases, the alcoholic choosing ahead of time not to walk past the liquor store where the smell of alcohol will be certain to be too much for him, the food addict choosing not to store chocolate ice cream in her freezer, and so on.

1.8 That delay sounds like it might be inconvenient at times.

Yes. That is the whole point. Hence, the Pluckeye motto is

Hooray for inconvenience!

Runner up mottos include:

  1. It ain't for wimps.
  2. It's up to you. (see this tip)
  3. Do whatever is necessary.
  4. You have to want it.
  5. Take the bull by the horns.
  6. Pluckeye is there to serve you.

1.9 What do you mean, "Hooray for inconvenience"? Who would want to be inconvenienced?

Folks who dislike the kind of convenience the Internet offers.

1.10 Can Pluckeye cure my porn addiction?

I don't think so; you need to make that choice. However, Pluckeye may be a tool that can help you make better choices.

1.11 Can you recommend any less extreme filters?

Popular products can be found on .

For a more extensive list, see .

1.12 Can you recommend any organizations that can help me with my porn struggle / pornography addiction?

1.13 Can Pluckeye do X (email my friends, filter based on keywords, …)?

Maybe. This page and the tips page mention most of Pluckeye's features. If you have a feature request, feel free to let me know.

1.14 I don't have problems with porn, but I'm addicted to Facebook. Might I have any use for Pluckeye?

Pluckeye can be used in a similar manner to SelfControl for Mac or SelfControl for Linux. Such users may want to remove the filtering rules that are specific to images. See how-to-filter-by-time.html.

1.15 What's with the name, "Pluckeye"? How's it pronounced?

It's an allusion to this:

And if your right eye offend thee, pluck it out, and cast if from thee, for it is profitable for thee that one of thy members should perish, and not that thy whole body should be cast into hell." (Matthew 5:29, KJV)

And though it is spelled "pluck-eye", I pronounce the name pluck-ee.

1.16 How do you plan on monetizing Pluckeye?

I hope that users who find it valuable willingly pay for it.

1.17 How can I contribute to Pluckeye?

Glad you asked! See help-out.html.

1.18 Why and when was Pluckeye created?

Work on Pluckeye began in 2007 after the author (Jon) investigated what software was available for folks looking for a filter to help them overcome compulsive porn use – a problem he believed to be increasingly common and long lasting. Firmly believing such a product should be freely (as in gratis) available, he eventually contacted a few vendors who had free offerings (X3Watch, BlueCoat, and Qustodio) to see if it was possible to work with them on improving the self-control features in them. Unsurprisingly, none were interested in integrating a volunteer coder into their process. So, he undertook to build his own – after all, how hard could it be?

Thus was Pluckeye conceived. But because the author was easily sidetracked its gestation was horribly long, and a working version was not publicly available until January 2014.

1.19 Is there any scientific basis for Pluckeye?

Ugh. How I hate the way the words "scientific" and "proven" are handled in modern life. I recommend reading Abolition of Man.

1.20 But is there any scientific basis?

:-( Well, here's an interesting study on how some pigeon's self-limited. I guess it is kind of similar.

But perhaps a study involving pigeons pecking levers is a bit of a stretch. Here's one involving humans

But, should humans really be treated as objects of study, like animals?

Here's a direct quote from a similar study:

"Maximization theory, which is borrowed from economics, provides techniques for predicting the behavior of animals - including humans."

Are humans true animals? You make the call.

1.21 Would Pluckeye be a good filter for protecting a child? If not, do you know of one?

This is hard to answer.

Pluckeye was not designed with the child in mind. It could be used that way, especially by a conservative parent (such as the author!), but there are other tools available, including some built into Windows, macOS, or Chrome OS. If you're looking for a guide to set up something, you might find the following links useful.

2 Using Pluckeye

2.1 What operating systems does Pluckeye support?

Pluckeye supports Linux, Windows, Mac OS X, and Android.

See platforms.html for more information.

2.2 How do I install pluckeye?

2.3 What are the recommended practices for using Pluckeye?

See the tips page.

2.4 What does "level 1" mean?

See the installation levels page.

2.5 What browsers does Pluckeye work with?

Firefox and Chrome. But at level 2, Pluckeye can block all browsers (i.e., Internet Explorer, Safari, and Opera).

2.6 Where do I type the pluck commands that are mentioned on this site?

pluck add "Allow"

are typed in 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 advanced features such as scheduled rules or accountability.

However, the basic feature set requires only pointing and clicking in the browser, and many people use Pluckeye without typing anything, ever.

For a longer explanation of code blocks, see notation.html.

2.7 How do I whitelist a site?

In Firefox or Chrome, click on the Pluckeye button, and then click "Allow".

Or, from the command line:

pluck add "Allow"

Keep in mind that the whitelisting will only take effect after the pluckeye delay has expired.

2.8 Can I whitelist a URL, perhaps using wildcards, pattern matching, a specific resource or something similar?

Yes, and no. As of Pluckeye 0.31.0, literal urls and url prefixes are supported, like so:

pluck add "Allow"

Full regular expressions support is not yet implemented, and may never be. If you would like regex support, see this uservoice suggestion.

2.9 Can I block or allow part of a website, but not all of it?

Yes. Pluckeye supports blocking by URL. There are 2 ways to do it.

  1. Firefox or Chrome > Pluckeye button > Allow > Click the "down arrow" (aka caret) to allow a specific url.
  2. Use a terminal and add a rule for the url you would like to allow.
pluck add "Allow"

2.10 Can I transfer (export/import) my Pluckeye settings between computers?


First, export the settings from the source computer:

On Mac OS X or Linux:

cd ~/Desktop && pluck export >pluckeye-settings.txt

On Windows

pluck.exe export > "%HOMEPATH%\Desktop\pluckeye-settings.txt"

Copy pluckeye-settings.txt from the desktop of the source computer to the desktop on the destination computer.

Then, on the destination computer, import the settings:

On Mac OS X or Linux:

pluck import pluckeye-settings.txt

On Windows

pluck.exe import "%HOMEPATH%\Desktop\pluckeye-settings.txt"

2.11 How do I manually remove a rule?

If the rule was added using the "Allow" button in Firefox or Chrome, the "Default" button will remove the rule.

At the command line, you can use pluck rm. For example,

pluck add "Allow"
pluck rm "Allow"

2.12 What is the complete syntax for rules and settings?

2.13 I whitelisted a site, but I still can't see videos there. Why?

Hmm. What url? Please let me know so I can investigate for the sake of others.

There are a variety of ways to publish videos on the web.

2.14 I did not whitelist a site, but I can download videos. How can I block them?

That's odd. Try these commands:

pluck add "Block application/octet-stream"
pluck add "Block application/x-unknown-content-type"

If that does not fix the problem, give me the url (and optionally your email) so I can investigate.

2.15 Can Pluckeye notify my accountability partner?

2.16 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?

Yes. See multiuser.html.

2.17 How do I access,,, and from the command line? They all use https.

Like so:

pluck add "Allow"

Typical symptoms of this FAQ:

$ git clone
Cloning into 'fmemopen'...
fatal: unable to access '': Couldn't connect to server
$ bundle install
Unfortunately, a fatal error has occurred. Please see the Bundler
troubleshooting documentation at Thanks!
/usr/lib/ruby/2.2.0/net/http.rb:879:in `initialize': Permission denied - connect(2) for "" port 443 (Errno::EACCES)
$ heroku logs
Enter your Heroku credentials.
Email: blah
Password (typing will be hidden): blah
!    Unable to connect to Heroku API, please check internet connectivity and try again.

The solution to all of the above:

pluck add "Allow"
pluck add "Allow"
pluck add "Allow"
pluck add "Allow"
pluck add "Allow"
sleep $(pluck export | perl -lne 'print $1 if /Delay (\d+) seconds/')
git clone
# Cloning into 'fmemopen'...

Also useful to some folks:

pluck add "program $(which git) whiteout"

2.18 How do I use Homebrew on Mac OS X at installation level 2?

This once worked, but seems to no longer:

pluck add "allow"
for i in ~/.bashrc ~/.bash_profile ~/.bash_login ~/.profile; do
    [ -f $i ] && break
echo "export HOMEBREW_NO_ENV_FILTERING=1" >>$i

So to use homebrew, you'll have to drop down to level 1 or use a periodic whiteout. E.g., to reserve a whiteout on Saturdays from 12pm to 2pm:

pluck add "sometimes A12-14 whiteout"

2.19 How do I unblock Steam?

It depends on the operating system.

  1. Windows
    pluck add "program steamwebhelper.exe whiteout"

    If using nhb, also use

    pluck add "program Steam.exe whiteout"

    Note that some versions of Pluckeye before v0.98.14 have been known to block Steam from downloading games at level 2, regardless of the above settings. Use v0.98.14 or above to avoid that.

  2. Linux

    One way:

    pluck add "program steam whiteout"

    Another way:

    pluck add "allow"
    pluck add "allow"
    pluck add "allow"
    pluck add "allow"
    pluck add "allow"
    pluck add "allow"
    pluck add "allow"

    See also

2.20 How do I unblock Minecraft?

2.21 How can I watch videos on youtube?

It depends. One option is to schedule access to youtube. E.g., to only allow media from youtube on Mondays 10am - 12pm:

pluck add "sometimes M10-12 allow"

Another option is to allow one of the following "clean" youtube sites.

Another option is to whitelist only specific videos.

2.22 How do I use Playonlinux?

pluck add "allow"

2.23 How do I uninstall Pluckeye?

See the uninstallation instructions on how-to-install.html.

2.25 How do I block torrents?

pluck add "block application/x-bittorrent"

2.26 How do I block all websites except a few select ones?

If you only want access to

pluck add "Block"
pluck add "Allow"
pluck add "Allow"
pluck add "Package plucki"

2.27 How do I block downloading of a live ISO?

pluck add "block application/x-iso9660-image"

2.28 How do I block or unblock pdfs or other documents?

To allow pdfs or doc files or other documents on specific sites, one generally just allows a url, or a domain. E.g.,

pluck add "allow"
pluck add "allow

To block pdfs on most sites:

pluck add "block application/pdf"

See also the no-documents recipe on

2.30 How do I watch videos on while blocking

pluck add "Block video/"
pluck add "Allow"

should work. But it might not in some versions of Firefox.

pluck add "Allow"
pluck add "Block"

will not work because "Block" will block videos from

2.31 Is there a way to modify the settings in an ordinary editor?

If you only want to add settings:

pluck export >settings.txt
$EDITOR settings.txt
pluck import settings.txt

If you want to remove a lot of settings:

pluck export >settings.txt
$EDITOR settings.txt
pluck factoryreset # leaves a few settings
pluck import settings.txt

2.32 I notice my CPU "spinning". Does Pluckeye slow down Firefox and/or my computer?

Sometimes. In particular, some common sites such as

contain advertising-related javascript that reacts poorly to the advertisements being blocked. Such javascript will sometimes cause the CPU to "spin in a loop" while it tries continuously to load ads.

If you notice your CPU is being heavily utilized by Firefox, close some tabs until the CPU spinning goes away. Alternatively, you can close Firefox completely and restart it.

2.33 How can I completely cut off Internet access at night?

To schedule daily blackouts from midnight to 6am and from 9pm (21:00) to midnight:

pluck add "sometimes 0-6&21-24 blackout"

2.34 How can I schedule access? What format do so-called "sometimes" settings take?

To allow from 8am to 9am:

pluck add "sometimes 8-9 allow"

The same thing, but only for Mondays:

pluck add "sometimes M8-9 allow"

The schedule format used by sometimes rules is not well documented, but perhaps the following legend will enlighten.

sUn, Mon, Tue, Wed, thuR, Fri, sAt, sUn

If you'd like a calendar-like interface to create an hrs-3 string for you, visit . Then point, click, and drag your desired schedule, and a properly-formatted sometimes string should show at the top of the page. The page supports daily or weekly schedules.

2.35 Does Pluckeye interfere with the Mac App Store and iTunes? If so, how can I use the App Store?

Yes. From the known issues:

On Mac OS X, at installation level 2, iTunes and the App Store are blocked on some machines. The current workaround is to periodically drop down to level 1 to apply updates from the App Store.

If you would like to see this changed, you can vote for improved App Store support.

2.36 How do I allow all websites and then only block specific ones?

2.37 How do I reset Pluckeye to its default settings, with all images being blocked?

pluck factoryreset

2.38 What if I think Pluckeye doesn't block enough for my tastes?

You may want to enable the NHB option.

3 Unanswered question?