Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/el1t/uBlock-Safari
uBlock Origin - An efficient blocker for Chromium, Firefox, and Safari. Fast and lean.
https://github.com/el1t/uBlock-Safari
Last synced: 18 days ago
JSON representation
uBlock Origin - An efficient blocker for Chromium, Firefox, and Safari. Fast and lean.
- Host: GitHub
- URL: https://github.com/el1t/uBlock-Safari
- Owner: el1t
- License: gpl-3.0
- Fork: true (gorhill/uBlock)
- Created: 2016-12-03T04:34:28.000Z (almost 8 years ago)
- Default Branch: safari
- Last Pushed: 2021-01-04T11:00:55.000Z (almost 4 years ago)
- Last Synced: 2024-08-01T00:55:10.457Z (3 months ago)
- Language: JavaScript
- Homepage:
- Size: 94 MB
- Stars: 2,745
- Watchers: 140
- Forks: 99
- Open Issues: 98
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE.txt
Awesome Lists containing this project
README
[](https://travis-ci.org/el1t/uBlock-Safari)
[](https://github.com/gorhill/uBlock/blob/master/LICENSE.txt)
***
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](https://github.com/gorhill/uBlock). Platform specific portions are under development.
Much of the platform shim from the original uBlock Safari version is still being used.
* [Installation](#installation)
* [Building](#building)
* [Release History](#release-history)
* [Further Documentation](#further-documentation)
* [About](#about)
* [License](#license)
## Installation
The preferred method of installation is to install from the [extension gallery](https://safari-extensions.apple.com/details/?id=com.el1t.uBlock-3NU33NW2M3).
This allows the extension to update automatically, and the submissions are approved by Apple.
To learn more about installation and updates, visit the [wiki](https://github.com/el1t/uBlock-Safari/wiki/Installation-and-Updates).
Compatible with Safari 11, untested on older versions (but should work).
#### 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](#blocking) than most popular ad blockers. Other blockers can also prevent uBlock₀'s privacy or anti-blocker features from working properly.
## Building
### Development
To build and load an unpacked extension for development:
1. **Clone** `uBlock-Safari` and [`uAssets`](https://github.com/uBlockOrigin/uAssets) into the same parent directory
1. **Build** by running `./tools/make-safari.sh` in `uBlock-Safari`'s directory
1. **Install** the unpacked extension through Safari's Extension Builder
1. In Safari, load the Extension Builder (Develop > Show Extension Builder)
1. Click the `+` button in the bottom left corner and "Add Extension"
1. Select `dist/build/uBlock0.safariextension`
1. Click install and enter your password
1. 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:
```bash
# 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`](https://github.com/uBlockOrigin/uAssets) into the same parent directory
1. **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](https://github.com/el1t/uBlock-Safari/releases) for a history of releases and highlights for each release.
## Further Documentation
Visit the upstream [uBlock Origin wiki](https://github.com/gorhill/uBlock/wiki) for further documentation.
## About
[uBlock Origin's manifesto](MANIFESTO.md).
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](https://crowdin.net/project/ublock).
## License
[GPLv3](https://github.com/gorhill/uBlock/blob/master/LICENSE.txt).