troubleshooting | Pluckeye

Android

Sometimes clearing the data associated with the Pluckeye app can fix problems. Unfortunately, clearing that data, will also clear your browser history, bookmarks, and the like. Fortunately, it won’t destroy your Pluckeye configuration because that is backed up to https://u.pluckeye.net/. But, if all else fails, it may be worth doing.

No Internet access

If you have no internet access, there are 4 things to try right off the bat.

  1. Try restarting your browser.
  2. Try rebooting.
  3. Try pluck repair and then rebooting.
  4. Try clicking the Pluck button, then “config”, then the button labeled “refresh”.

If you have already successfully set up configuration synchronization, you may also want to try pluck sync and pluck refresh.

If none of the above fixes the problem, you may want to disable the system feature and change your delay to 0 while troubleshooting.

pluck - system
pluck + delay 0

Occasionally, uninstalling, restarting browsers, reinstalling, and restarting browsers can resolve obscure problems. But make sure you save your configuration before uninstalling if you don’t want to lose it.

Note: Manually saving a configuration using export is unnecessary if you have already successfully set up configuration synchronization because such configurations are automatically saved to https://u.pluckeye.net/ .

cd Desktop
pluck export > pluckeye-settings.txt
pluck + delay 0
pluck uninstall

After reinstalling:

cd Desktop
pluck import pluckeye-settings.txt

If that still doesn’t fix it, read on.

Browser extension is missing

If you are using Pluckeye v0.99.x or earlier and you have manually removed the Pluckeye extension from Chrome, you will not be able to restore it by re-installing Pluckeye. You must either update to v1.0 or re-install the Pluckeye extension from the Chrome Web Store.

Software conflict

Pluckeye is incompatible with some software. If you have Cold Turkey, Covenant Eyes, Qustodio, or similar software installed, try disabling or uninstalling it temporarily to see if that is the problem. If you want to continue to use the other software, you can use Pluckeye, but not the system feature.

No IP address, no routing, no DNS

Sometimes the computer on which Pluckeye is installed loses Internet access because the networking configuration on the computer itself is incorrect (typically done via DHCP when the computer turns on). The following command can test basic network access.

   nslookup pluckeye.net

A successful response might look something like:

Server:		127.0.0.53
Address:	127.0.0.53#53

Non-authoritative answer:
Name:	pluckeye.net
Address: 167.99.21.48

If the command fails, your DNS and/or IP configuration is probably broken. You should disable Pluckeye’s system feature, reboot, and troubleshoot your network when Pluckeye isn’t operative.

   pluck - system

More than one Pluckeye user has reasonably thought Pluckeye was preventing Internet access when the problem was actually their network card, router, or ISP.

Block early in verdicts

Website access

Unable to see images or videos on an allowed website (example.com)

To discover why access is blocked, try pluck eval

   pluck eval https://example.com/p.png program:chrome
   pluck eval https://example.com/p.png

Additionally, you can use eval to check for more granular block rules. For example, to check whether images are allowed on example.com, type pluck eval example.com image/ (note the slash in image/, which corresponds to the ‘image/’ part of the default block image/ rule, which you can see after exporting settings). Similarly, you can check for video access by using pluck eval example.com video/.

Inexplicably able to see images and videos on an unallowed website (example.com)

This is different from being able to see images and videos on all websites. If there is a particular website where you see images or video and you expect that you shouldn’t, there are a few possibilities.

Perhaps the site images actually come from an allowed site

Perhaps the site is allowed by Pluckeye’s default configuration

Pluckeye’s default configuration will allow images from a few locations. They are listed below along with a rule that will block either images or the entire site.

  1. pluckeye.net
           pluck + block pluckeye.net image/
  2. The Chrome Web Store (in Chrome).
           pluck + block https://chrome.google.com/webstore
  3. The Firefox Add-Ons site (in Firefox).
           pluck + block https://addons.mozilla.org/

Perhaps you are using a browser extension that allows such media

Some extensions, such as Adblock Plus, replace a page’s ads with their own. Because these ads come from “elsewhere”, they are allowed. To prevent this, remove the extension and if necessary, block installation of it by using

    pluck + block https://chrome.google.com/webstore

Inexplicably able to see images and videos on all websites

If you can see images and videos on all websites, there are a few possibilities why.

Perhaps Pluckeye isn’t fully installed

Do you see the blue Pluckeye P button in your browser? If not, Pluckeye isn’t fully installed.

Perhaps your configuration allows it

A common reason images and videos show on all websites is that Pluckeye has been configured to allow such access. To determine if this is the case, use pluck eval.

    pluck eval http://example.com/p.png

Ordinarily, the output of the above command is something like the following.

block because of rule 1234: block image/

If instead of that you see

null because of rule 0

then your configuration has lost the factory default settings. To restore factory default settings, either:

  1. Invoke pluck factoryreset (this will destroy your current configuration!).
  2. Import the classic configuration into your remote configuration.

If you see some other output that indicates Pluckeye allows access, such as

allow because of rule 1234: allow program:chrome

then the rule that is reason Pluckeye allows access. You can either remove the rule, or add an additional, high priority rule to block access.

Perhaps there is a software conflict

Pluckeye will either block all access or allow all access when combined with certain products, depending on your Pluckeye settings. Such products are usually blockers or filters such as Cold Turkey or Covenant Eyes.

Perhaps you’re on Linux and using Linux Snaps

You can disable snaps as described on Linux Snaps.

Program access

Pluckeye can allow or block programs by name.

For example, you can allow a program named “skype” with a per-program rule.

  pluck + allow program:skype

If you want to allow a program, but you don’t know it’s name, start it, and then run pluck verdicts to see what the program’s name.

  pluck verdicts

If you want to get fancy, you can allow or block a program along with a user, IP address, port, or other context. E.g., to allow skype for the user susan, but to block it for peter:

  pluck + allow program:skype user:susan
  pluck + block program:skype user:peter

Help! This [internet-dependent] program no longer works!

See above for how to allow specific programs. Some programs will be blocked automatically when Pluckeye is operating at system level (level 2). For example, if after installing or updating Pluckeye the Spotify desktop app is unable to connect, the program can be allowed using pluck + allow program:spotify . Some messenging apps may also be blocked at system level and are unblocked the same way.

Unable to download games on Steam

Please see this entry on the Using Pluckeye page: “How do I unblock Steam”.

Other problems

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

Sometimes. In particular, some common sites such as

contain advertizing-related javascript that reacts poorly to the advertizements 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 your browser completely and restart it.

Older Pluckeye versions

Some problems only occur in older Pluckeye versions.

How to fix “delay is ?” and restore internet

This apparent error message also occurs when you try to use private browsing in certain browsers, but without affecting normal browsing performance.

In the unlikely event that Pluckeye browser extension is unable to recall your current delay setting and is consequently blocking your internet, your best bet is to reinstall Pluckeye. You may also want to temporarily disable any other browser plugins.

To export your current settings and reinstall Pluckeye, open a console window and enter the following series of commands:

pluck set "Delay 0"
pluck export > settings.txt
Reinstall Pluckeye and import the settings as below.
pluck import settings.txt

For more detailed instructions on exporting/importing settings, see Using Pluckeye.

(Almost) Instant Browser Crash

This is rare. One of two things is likely at fault.

1) Pluckeye has a conflict with another browser extension.

Solution

  • Open your browser in safe or private mode. (Right-click your browser icon and select “Run in safe mode” or “New Private Window”. This should disable most of the browser extensions, as most extensions are denied by default in private browsing mode.)
  • Open your extensions page (File > Extensions OR File > Add-ons) and disable as many extensions as you can.
  • Close your browser.
  • Restart your browser normally. If it doesn’t crash and pages load normally, the issue was likely a conflicting extension. Turn your extensions on one at a time (restarting the browser each time) until you discover the culprit.

2) Your browser is out of date and is no longer compatible with the current version of Pluckeye.

This can happen if you update to a new version of Pluckeye on an out-of-date browser. You should always keep both your browser and Pluckeye up-to-date for stability and security.

Solution

  • Update your browser. (If you can’t open your browser long enough to download the update, you may need to use a second computer to download the correct file and transfer it over.)
    • In Linux, as long as you downloaded your browser from your distro’s repository, you can update via terminal. In Debian and Ubuntu, type sudo apt update followed by sudo apt upgrade.

3) If neither solution works

If neither of the above solutions work, visit the Pluckeye forums (Reddit) or contact Jon.

I’m still stuck

If this page did not help you and if your problem isn’t a bypass, then you can try the Pluckeye forum or the Pluckeye subreddit for community support. If your problem is a bypass, please use the bypass page to report it. If you need to send a message directly to Jon, you can use the contact page.

In case of emergency

If you have a delay greater than 1 hour, you have lost Internet access, and you really need it restored ASAP, you can try:

pluck - system
pluck supplicate

That will generate an expedite request to immediately disable the system feature.

If Jon or some other person approves your request on https://u.pluckeye.net/ , you can then run the following command to apply the expedited change.

pluck mayprove