Skip to content


Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?
This branch is 120 commits ahead, 5437 commits behind gorhill:master.


Failed to load latest commit information.
Latest commit message
Commit time
April 15, 2018 06:53
April 21, 2018 22:01
April 21, 2018 23:51
December 2, 2016 23:33
December 5, 2017 08:38
April 12, 2017 16:39
June 23, 2014 18:42
March 12, 2015 23:22

Build License

uBlock Origin
for Safari

pronounced you-block origin (/ˈjuːˌblɒk/) — you decide what enters your browser.

An efficient blocker add-on for various browsers. Fast, potent, and lean.

Regarding this Safari port

The majority of this code is shared with upstream. Platform specific portions are under development. Much of the platform shim from the original uBlock Safari version is still being used.


The preferred method of installation is to install from the extension gallery. This allows the extension to update automatically, and the submissions are approved by Apple.

To learn more about installation and updates, visit the wiki.

Compatible with Safari 11, untested on older versions (but should work).


To benefit from uBlock Origin's higher efficiency, it's advised that you don't use other inefficient blockers at the same time (such as AdBlock or Adblock Plus). uBlock₀ will do as well or better than most popular ad blockers. Other blockers can also prevent uBlock₀'s privacy or anti-blocker features from working properly.



To build and load an unpacked extension for development:

  1. Clone uBlock-Safari and uAssets into the same parent directory
  2. Build by running ./tools/ in uBlock-Safari's directory
  3. Install the unpacked extension through Safari's Extension Builder
    1. In Safari, load the Extension Builder (Develop > Show Extension Builder)
    2. Click the + button in the bottom left corner and "Add Extension"
    3. Select dist/build/uBlock0.safariextension
    4. Click install and enter your password
    5. You will have to reinstall from this panel every time you restart Safari

If you don't see a Develop menu in Safari, you can run defaults write IncludeDevelopMenu -bool true or go to Preferences > Advanced > Show Develop menu in menu bar.

Example clone and build:

# Clone
git clone
git clone
# Build
cd uBlock-Safari
echo 'Output is in dist/build/uBlock0.safariextension'


To build and sign for release (certificates required):

  1. Clone uBlock-Safari and uAssets into the same parent directory
  2. Build by running ./tools/ all in uBlock-Safari's directory
    1. Requires xar-mackyle, which will be built if not found

Release History

See the releases pages for a history of releases and highlights for each release.

Further Documentation

Visit the upstream uBlock Origin wiki for further documentation.


uBlock Origin's manifesto.

Free. Open source. For users by users. No donations sought.

Without the preset lists of filters, this extension is nothing. So if ever you really do want to contribute something, think about the people working hard to maintain the filter lists you are using, which were made available to use by all for free.

You can contribute by helping translate uBlock₀ on Crowdin.




uBlock Origin - An efficient blocker for Chromium, Firefox, and Safari. Fast and lean.







No packages published


  • JavaScript 91.7%
  • CSS 3.2%
  • HTML 3.0%
  • Shell 1.3%
  • Python 0.8%