What's Changed

Major Features & Improvements

Audited Persistence, Sync, and Safari Compatibility (73edecc8, #780)
A full pass over storage, backup, iCloud sync, filter publication, and DNR rule installation. Storage recovery and migrations are durable, cloud reconciliation preserves deletions and newer local edits, restores require complete metadata before they commit, rule publication refuses incomplete or overflowing output, and legacy DNR downgrades keep exception semantics.
Per-Feature Switches for Tube Cleaner and Player Cleaner (ead61586, 0312194d)
Each cleaner feature can be turned on or off individually from the Userscripts page instead of all-or-nothing.
DeArrow as Its Own Script (6aefee95, 257d2818, 7353f0ae, #700, #708)
DeArrow is separated from Tube Cleaner, configured from the Userscripts page, and supports per-channel thumbnail exceptions.
SponsorBlock Settings Import and Export (c2ccc3f7)
Native, validated import and export of SponsorBlock settings so you can move them between devices.
Site Exceptions for Blocklists and Scripts (1d56a1cd, 0cc0a832, aca98797)
Exclude individual sites from a filter list, add per-site userscript exceptions from a unified Info panel, and subdomain exclusions now honor parent-scoped rules.
Separate Filter and Userscript Update Checks (884da858, 9bb53f43, ee2ecb75)
Filters and userscripts update independently, userscripts refresh from Safari while browsing, and filter downloads triggered from Safari are staged until you apply.
30,000 removeparam Rules (9dc31842)
The DNR budget matches Safari's 30k limit and those rules are counted in the capacity view.
Headless Update Completion on macOS (e2ccd098, 092c9bf7, #704, #710)
Opening the app finishes pending filter updates without the launch agent, and Settings shows detailed background diagnostics.
Rules Viewer Upgrades (b2a0fe01, b3f0e710, c66c97d1, 695e4d11)
Unsupported, duplicate, and Scripts-only rules are highlighted, with shared search, wrapping, and line numbers.
Keyboard Shortcuts (ef4ea7fb, 7f795bcb, e073ebfd, c2f81f58)
⌘N, ⌘⇧N, ⌘L, refresh, tab switching, ⌘W on the apply sheet, and keyboard scrolling on the macOS filter and userscript pages.
Appearance Setting and Cosmetic Filtering Toggle (d16fd609, e0d2d36f)
Choose light, dark, or system appearance in-app, and turn cosmetic filtering off without disabling lists.
Preferences in Backups (7a37da42, dc697873, 37c14da8)
App preferences and pause exception sites are included in backups and sync, and a restore applies immediately.
Bypass Paywalls Clean from R2 (a04e9b55)
The BPC list is served from R2 instead of the worker.

Performance & Reliability

Lighter Protobuf Store (3e948415, cb8fb194, d813b59f, #764)
The store is no longer re-decoded on every read and save, oversized userscript patterns stay out of it, and filter rows stop probing the disk on every render.
Shared Update Pipeline (2eb59745, a58e63ee, 03d120fc, 40ea41af)
Foreground and background updates share one processing path, userscript updates are single-fetch, removeparam extraction is cached, and coherence checks stop parsing the whole rules cache.
Faster Compiles and Reloads (3fd0f177, f09cc13b, 28198b9b, e195b582, 78c9670f)
Newest lists compile first with unique rule counts, only failed extensions retry, large and repeatedly failing blockers reload first, reordering lists keeps the compiled cache, and duplicate rules are dropped before conversion.
Update Ownership and Scheduling (d334b67d, 2eaad3af, 0deca006, #731)
Cross-process update claims report accurate outcomes, background wakes are scheduled at the actual due date, and failed updates resume from the unverified lists.
Safari Reload Safety (58956ead, 9ae109b6, c5700fc2, 53fc3325)
Fixed iOS reload timeouts, content blockers reload even when Safari is closed, a blocker turned off in Safari no longer fails apply, and filter downloads no longer delay page rules.
Fewer 0xDEAD10CC Kills (1feab91f)
Closed two more iOS suspension windows during apply.
Userscript Request Safety (090fac60, bc565d45, b6a4363d, #753, #781)
Network host grants are enforced, match indexing is faster, and native relays are bound to the calling frame and site.
Userscript Match Correctness (2f9386d3, b8821c3a, #751)
*:// no longer matches ftp, update metadata is honored, and style variable handling is bounded.

Bug Fixes

Custom Filters and Categories (c86dd7b8, db895279, fea90c3d, #766, #776)
A deleted custom filter can be added again, categories survive updates and launches, and damaged filter records no longer fall back to remote URLs.
Userscript Toggles (921f546c, 20ba8f00, e636c152, #777)
Toggle choices survive stale saves, failed batch enables are discarded, and Local Import scripts turn on.
Player Cleaner Toggle (0cd75436, #761, #777)
Tube Cleaner hooks are retained for safe grant aliases so the switch stays where you put it.
Userscript Import (a4505b3b, 55b23c4b, 6425c9e5, #772, #775)
Fixed false protection-page detection, restored Stylus imports, and stopped bulk URL entry from merging lines while typing.
No-Updates Toast (665f7abc, a6d85e59, d74b6934, 018ff6b7)
The toast can be swiped or clicked away on iOS and macOS, survives the progress sheet closing, and the swipe animates smoothly.
iOS Rules Viewer (392972b0, 49cfe273)
Fixed blank text and snapback, and enabled horizontal scrolling.
Onboarding Crash (35834142)
Concurrent Safari setup queries no longer crash onboarding.
Landscape Update Sheet (018ff6b7)
The update-check sheet floats as a compact card in landscape on iPhone.
Userstyles (f04f39fd, 9ca8aa52, f083d467, 17ae3bcf)
@match is respected, value:Label selects parse, remote Less imports inline, and styles apply before first paint on repeat visits.
Element Zapper (7900fbd8, 69f8207d, 966d123b, #719)
Closing the zapper no longer reloads the page, parent and www rules apply across subdomains, and rules can be cleared per site.
No Autoplay (a91f20b7, 2f9386d3)
Works under strict page policies and ignores typed Space and K in the gate.
iPad Popup and Search (68b7ad59, 53fd361d, 0c33faf8)
Fixed the disappearing iPad popup and kept the search toolbar visible.
Export and Regional Lists (93c611e0, 1adf8a3e, 7db42b33)
Export opens one save dialog, regional filters no longer scroll jumpily, and onboarding reset leaves no stray lists.

UI/UX Improvements

macOS 26 Toolbar (f0d0f78d, c7572347, 26c15440, af9dfcd2, #703, #758)
Toolbar actions are grouped into glass islands, undo/redo is split from search, and the compact icon-only toolbar is back.
Native Update and Apply Sheets (a86d48dd, dd890d68, d4d4aeb8, 6f5bb21b, 81b44d18, #707, #712, #746)
Update checks run in a native progress sheet, apply sheets are sized to their content on macOS, iPhone, and iPad, and the width no longer jumps.
Unified Add and Edit Screens (92ccfc91, c372802a, c8722392, 7123367f, #744, #745, #759)
Filters and userscripts share the same import forms, editing flow, and glass cards.
Settings Layout (9888090b, 5e4d44b7, 52ea2682, #713, #714)
Site controls moved near the top, pause options tidied, and each component can be paused independently.
Info Panels (a35d3642, 9c4fc7e7, 79f09b4e, 13cf4e5c, #696, #770, #774)
Sheets close with an X, open at half height on iPhone, and copying a URL confirms inline.
iPhone Layout (6a507e5f, a1539397, 4e3c4c34, 85a36db7, #757)
The info toggle stays whole, the source URL wraps left, the editor grows, search stays in the toolbar row, and counts fit on one row.
Popup (a4fd09b1, c8920002, 0c8c04a8, #701)
Hostnames and Open wBlock stay readable, the color scheme refreshes when Safari resumes, and mobile filter updates open in wBlock.
Downloads and Logs (5a8650dc, 00c1636c, 9e6faf0f, 59ce02eb, #697, #717)
A Download button for userscripts, compact download controls, and logs with error details and reload policy.

Localization

Japanese (#754, #755, #756, #778, #779, #782)
Expanded and refined Japanese strings across filters, updates, and settings. Thanks @so-5699.
Turkish (#722)
Updated Turkish strings. Thanks @remad0.

Documentation

Userstyles Guide (e8030413)
A user guide for installing and configuring userstyles.
App Store Screenshots (dacd5037)
Refreshed screenshots for the 3.x releases.

Full Changelog: 3.0.0...3.1.0

Download

Download from the App Store: https://apps.apple.com/app/wblock/id6746388723
macOS (Homebrew): brew tap 0xcub3/wblock && brew install --cask wblock
macOS (DMG): wBlock-3.1.0.dmg is attached to this release once notarization finishes.

Navigation Menu

3.1.0

Choose a tag to compare

Sorry, something went wrong.