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.
If you have no internet access, there are 4 things to try right off the bat.
pluck repair
and then rebooting.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.
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.
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.
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.
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/
.
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.
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.
pluck + block pluckeye.net image/
pluck + block https://chrome.google.com/webstore
pluck + block https://addons.mozilla.org/
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
If you can see images and videos on all websites, there are a few possibilities why.
Do you see the blue Pluckeye P button in your browser? If not, Pluckeye isn’t fully installed.
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:
pluck factoryreset
(this will destroy your current 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.
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.
You can disable snaps as described on Linux Snaps.
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
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.
Please see this entry on the Using Pluckeye page: “How do I unblock Steam”.
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.
Some problems only occur in older Pluckeye versions.
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.
This is rare. One of two things is likely at fault.
Solution
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
sudo apt update
followed by sudo apt upgrade
.If neither of the above solutions work, visit the Pluckeye forums (Reddit) or contact Jon.
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.
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