If you are using macOS Big Sur (2020) or newer, see how to install on macOS released after 2019.

If you are using macOS Catalina (2019), Mojave (2018), High Sierra (2017), Sierra (2016), El Capitan (2015), Yosemite (2014), or Mavericks (2013), then this web page is for you.

Now, on with the show.

If you’ve already installed Plucky, see how to update.

If you want to uninstall, see how to uninstall.

If you are using Mac OS on Mojave or earlier, the steps may not work because Apple no longer updates their TLS certificate stores on Mojave and older. Because of this, on some computers, the installation process fails with a TLS error.

Some using macOS Mojave have reported success following the instructions on https://github.com/plujon/mac-curl-recert and then installing Plucky.

Some using macOS High Sierra have reported that they needed to instead manually add the dst root CA X3 certificate .

If you need to use either of the above, please report your experience so this page can be updated.

How to install

In Chrome:

  1. Visit https://r.pluckeye.net/try-it.
  2. Click the big “installer” button.
  3. Click Save File.
  4. Click the download arrow, and click Plucky.pkg.
  5. Follow the installation wizard prompts.
  6. Restart your browsers.

How to activate the system feature

  1. First, activate the system feature, using either the Plucky Settings page in the browser (Pluckeye button, then click Settings), or typing the following in a terminal.

    pluck + system
    
  2. Open System Preferences.

  3. Click on Security & Privacy.

  4. Click on the General tab.

    Allow apps downloaded from:

    • App Store
    • App Store and identified developers

    Open System Preferences and look for a screen similar to the one shown in the link below. If you see such a screen, grant Plucky permission to install.

    Note that if you install Plucky while the Security Preferences dialog is open, macOS will not update the dialog. In that case, you must close and reopen the System Preferences dialog.

  5. Finally, type the following in a terminal.

    pluck repair
    

If pluck repair prints errors

Sometimes, pluck repair prints errors, as seen below:

$ pluck repair
0f30:42: 8f5c4244 WARNING 0x23ff7ff3
0f30:42: 8f5c4244 WARNING 0x23ff7ff3
0f30:43: 8f5c4244 WARNING 0x3119100b
0f28:29: 8f5c4244 WARNING 0x3119100b
0c72:11: 8f5c4244 WARNING 0x3119100b
0cf2:28: 8f5c4244 WARNING 0x3119100b
0c5e:35: 8f5c4244 WARNING 0x3119100b
0d16:20: 8f5c4244 WARNING 0x3119100b
10f8:39: 8f5c4244 WARNING 0x3119100b
10f9:38: 8f5c4244 WARNING 0x3119100b
10f7:84: 8f5c4244 WARNING 11
0c63:15: 8f5c4244 WARNING 0x310f7057

The above is a consequence of a macOS bug. But it shouldn’t be hit very often, and if it is, please let me know. You can try working around the problem by doing the following.

  1. Set your delay to 0.

    pluck delay 0
    
  2. Remove the system feature.

    pluck - system
    
  3. Save your configuration.

    cd ~/Desktop
    pluck export > pluckeye-config.txt
    
  4. Uninstall.

    pluck uninstall
    
  5. Reinstall.

  6. Re-import your configuration.

    cd ~/Desktop
    cat pluckeye-config.txt | pluck import -
    
  7. Re-try the system feature.

    pluck + system
    
  8. If you still get the same warnings, remove the system feature for a few days. Then try again. Ridiculous, I know.

    pluck - system
    sleep 86400
    pluck + system
    

If you don’t get errors, but it still isn’t working

Please let me know. Perhaps there is a conflict with other software on the computer.


Last updated: 2023-07-27