wBlock

<div align="center">

<img src="docs/media/img/wblock_logo.png" alt="wBlock logo" width="112" />

# wBlock

### The end of Safari ad-blocking B.S.

A free, open-source ad blocker for Safari on Mac, iPhone, iPad, and Apple Vision Pro.


<a href="https://apps.apple.com/us/app/wblock/id6746388723?itscg=30200&itsct=apps_box_badge&mttnsubad=6746388723">
  <picture>
    <source media="(prefers-color-scheme: dark)" srcset="https://toolbox.marketingtools.apple.com/api/v2/badges/download-on-the-app-store/white/en-us?releaseDate=1760313600" width="220" />
    <source media="(prefers-color-scheme: light)" srcset="https://toolbox.marketingtools.apple.com/api/v2/badges/download-on-the-app-store/black/en-us?releaseDate=1760313600" width="220" />
    <img src="https://toolbox.marketingtools.apple.com/api/v2/badges/download-on-the-app-store/black/en-us?releaseDate=1760313600" alt="Download on the App Store" width="220" />
  </picture>
</a>

<br>
<br>

[![Version](https://img.shields.io/github/v/release/0xCUB3/wBlock?style=flat&label=version&color=gray)](https://github.com/0xCUB3/wBlock/releases/latest)
![Platforms](https://img.shields.io/badge/macOS_12.3+_|_iOS_15.4+_|_visionOS_2.0+-gray?style=flat&logo=apple&logoColor=white)
![License](https://img.shields.io/badge/GPL--3.0-gray?style=flat&label=license)
[![Discord](https://img.shields.io/badge/Discord-5865F2?style=flat&logo=discord&logoColor=white)](https://discord.gg/Y3yTFPpbXr)
[![Featured on FMHY](https://img.shields.io/badge/featured_on-FMHY-3E1E56?style=flat&logo=data:image/svg%2bxml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHZpZXdCb3g9IjAgMCAyNCAyNCI+PHBhdGggZmlsbD0id2hpdGUiIGQ9Ik01IDIuNSAyMSAxMiA1IDIxLjV6Ii8+PC9zdmc+)](https://fmhy.net/beginners-guide#browsers)
[![Mentioned in Open-Source iOS Apps](https://awesome.re/mentioned-badge.svg)](https://github.com/dkhamsing/open-source-ios-apps)

<br>

<img src="docs/media/img/hero_image.png" alt="wBlock on macOS in light and dark mode" width="900" />

<br>
<br>

[Features](#features) · [Screenshots](#screenshots) · [Install](#install) · [How it works](#how-it-works) · [FAQ](#faq) · [Support](#support)

</div>

## Features

### Blocking

Up to 750,000 Safari rules across five content blockers, with recommended lists, regional lists picked for you, and optional annoyance and cookie-banner filters.

<details>
<summary>More about blocking</summary>
<br>

- AdGuard-compatible filter lists compiled into Safari's native rules and spread across five content blockers, with a limit of 150,000 rules each. Safari applies the rules outside the app process.
- Recommended default lists, automatic regional filter selection, and optional annoyance and cookie-banner filters. Add custom lists by URL, pasted text, or file import.
- Scheduled updates from hourly to weekly, with incremental downloads for lists that support them. On macOS, a launch agent checks for updates while the app is closed.
- Tracking-parameter removal, including `utm_*`, and link-shortener