Skip to content

31d4r/cordon

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

4 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Cordon

Cordon logo

Cordon is a macOS menu bar app that blocks ads and trackers on your Mac. It runs a local filter on your machine and works across browsers and most apps.

Download

Open the installer or unzip the archive, then move Cordon to your Applications folder. See How to use below for certificate setup and enabling protection.

Screenshots

Requests - see blocked ads and trackers in real time

Cordon Requests view showing blocked network requests

Filter Lists - turn filter lists on or off by category

Cordon Filter Lists view

Requirements

  • macOS

To build from source you also need Xcode. No Go or other tools are needed. The blocking engine is included in the repo.

Build

  1. Open Cordon.xcodeproj in Xcode
  2. Build and run (Cmd+R)

How to use

Step 1: Install the certificate

After you launch Cordon, look for the shield icon in the menu bar (top right of your screen).

  1. Click the Cordon icon in the menu bar
  2. Click Install Certificate
  3. macOS will ask for your password. Enter it when prompted
  4. If macOS asks you to trust the certificate, click Always Trust

This certificate lets Cordon filter HTTPS traffic safely on your Mac. You only need to do this once.

To check it worked, open Cordon, go to Settings, and click Verify Certificate Trust.

Step 2: Turn on protection

  1. Click the Cordon icon in the menu bar
  2. Click Enable Protection

Wait one to two minutes the first time while filter lists load. When protection is on, the shield icon changes and ads should start getting blocked.

To turn it off, click the icon again and choose Disable Protection.

Step 3: Open Cordon (optional)

Click the menu bar icon and choose Open Cordon to see more options:

Tab What it does
Requests See blocked ads and trackers in real time
Filter Lists Turn filter lists on or off (ads, privacy, malware, regional)
Rules Add your own blocking rules, one per line
Settings Certificate, ignored hosts, launch at login

You do not need to open the main window for basic use. Install the certificate, enable protection, and you are done.

Browser tips

If Brave or Chrome show a certificate warning:

  • Reinstall the certificate from Settings
  • Turn off Secure DNS in the browser privacy settings
  • Turn off QUIC in brave://flags or chrome://flags
  • Quit and reopen the browser

Limitations

Some apps ignore the system proxy or use their own security. Banking apps may not work with protection on. You can add domains to Ignored Hosts in Settings to skip filtering for specific sites.

Cordon only protects the Mac it runs on. It does not block ads on other devices on your network (phones, TVs, etc.).

Uninstall

  1. Disable protection from the menu bar
  2. In Settings, click Uninstall Certificate
  3. Delete the app

To remove leftover files:

rm -rf ~/Library/Application\ Support/Cordon/

About

Local ad and tracker blocker for macOS

Resources

Stars

Watchers

Forks

Packages

 
 
 

Contributors