Our take
- Activity
- 77
- Community
- 31
- Issues
- 95
- Pull requests
- 77
+169 stars in the last 30 days
- Closes issues faster than 82% of the projects we track
- Merges more pull requests than 82% of the projects we track
Project history
Daily GitHub snapshots since Oct 7, 2026. History covers stars and forks; health signals are not tracked historically.
Stars
3,244Forks
74Change since Nov 16, 2026: +5 stars·0 forks
Overview
wBlock is a Safari ad and tracker blocker for Apple devices. It addresses Safari’s per-content-blocker rule limits by distributing compiled filter rules across five blockers, with a separate scripts extension for features static rules cannot handle.
It is a fit for people who want filtering and optional userscripts in one Safari-focused app, with controls for individual sites and synced settings. It is not a general-purpose blocker for other browsers.
Key Features
- Compiles filter lists into five Safari content blockers, with a viewer for compiled rules and unsupported or duplicate lines.
- Supports built-in and custom filter lists, including lists added by URL, pasted text, or file.
- Provides a Greasemonkey-compatible userscript engine and support for userstyles.
- Includes an element zapper and per-site switches for filtering, scripts, and autoplay.
- Offers native video playback integrations for YouTube and other supported video players.
- Syncs lists, settings, allowlists, and custom filters through iCloud, with local backup export as an alternative.
Use Cases
- Safari users who want ad and tracker filtering across Mac, iPhone, and iPad without configuring separate blockers for each device.
- People who need cosmetic filters, scriptlets, or userscripts for site behavior beyond what static content-blocking rules can express.
- Users who want to hide a page element or disable filtering or scripts on a particular site when something breaks.
- YouTube viewers who want supported native playback features such as Picture-in-Picture and SponsorBlock controls.
Getting Started
Install from the App Store, or on macOS with Homebrew:
brew tap 0xcub3/wblock && brew install --cask wblock
On first launch, enable the extensions in Safari. See the README for setup details and other installation options.
Considerations
- wBlock requires Safari on macOS 12.3 or later, iOS 15.4 or later, or visionOS 1.0 or later, according to the project’s platform badge.
- Safari applies content-blocking rules itself. The scripts extension handles capabilities static rules cannot provide, but Safari must reload blockers after updates before changes take effect.
- Safari limits rule capacity, so enabling extra filter lists can use capacity and cause site breakage. The project recommends choosing one general-purpose blocker rather than running multiple blockers together.
- iCloud sync is available, but users can instead export a backup. On iOS, background update timing is controlled by the operating system.
Found this useful?
Share it with someone who would like wBlock.