---

=======

BEWARE! uBlock Origin is COMPLETELY UNRELATED to the web site ublock.org

The donations sought by the individual behind ublock.org ("to keeps uBlock development possible", a misrepresentation) are not benefiting any of those who contributed most to create uBlock Origin (developers, translators, and all those who put efforts in opening detailed issues). For the differences between uBlock Origin and uBlock, see the unbiased Wikipedia article.

---

uBlock Origin is NOT an "ad blocker": it is a wide-spectrum blocker -- which happens to be able to function as a mere "ad blocker". The default behavior of uBlock Origin when newly installed is to block ads, trackers and malware sites -- through EasyList, EasyPrivacy, Peter Lowe’s ad/tracking/malware servers, various lists of malware sites, and uBlock Origin's own filter lists.

---

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.

• Installation
• Building
• Release History
• Further Documentation
• About
• License

Installation

Until relatively stable, this extension must be installed manually.

Feel free to read about the extension's required permissions.

Chromium

You can install the latest version manually, from the Chrome Store, or from the Opera store.

It is expected that uBlock Origin is compatible with any Chromium-based browsers.

Compatible with Safari 10, untested on older versions.

Note

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.

Building

Development

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/make-safari.sh 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 com.apple.Safari IncludeDevelopMenu -bool true or go to Preferences > Advanced > Show Develop menu in menu bar.

Example clone and build:

# Clone
git clone https://github.com/uBlockOrigin/uAssets.git
git clone https://github.com/el1t/uBlock-Safari.git
# Build
cd uBlock-Safari
./tools/make-safari.sh
echo 'Output is in dist/build/uBlock0.safariextension'

Release

To build and sign for release (certificates required):

1. Clone uBlock-Safari and uAssets into the same parent directory
2. Build by running ./tools/make-safari.sh 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.

About

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.

License

GPLv3.