<div align="center">
<img src="https://assets.kitploit.com/production/public/readmes/9565/f9be27527e40a78f4f25d3a7763a377ffb492bc1891f8645f0214792a89cf548.png" alt="wBlock ロゴ" width="112" />
# wBlock
### Safariの広告ブロックに関するくだらない話はもう終わり。
Mac、iPhone、iPad、Apple Vision ProのSafari向けの無料オープンソース広告ブロッカー。
<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="App Storeからダウンロード" width="220" />
</picture>
</a>
<br>
<br>
[](https://github.com/0xCUB3/wBlock/releases/latest)


[](https://discord.gg/Y3yTFPpbXr)
[](https://fmhy.net/beginners-guide#browsers)
[](https://github.com/dkhamsing/open-source-ios-apps)
<br>
<img src="https://assets.kitploit.com/production/public/readmes/9565/52c7b447f669b7e207d2b83aabc2802c556edd9516e579c47f9895920637f641/42582adf96376cd477fc79cc9aa542c878daae0b1f25ca4f5e3880a4a7d198e5-display-v1.webp" alt="ライトモードとダークモードのmacOS上のwBlock" width="900" />
<br>
<br>
[機能](#features) · [スクリーンショット](#screenshots) · [インストール](#install) · [仕組み](#how-it-works) · [FAQ](#faq) · [サポート](#support)
</div>
## 機能
### ブロッキング
5つのコンテンツブロッカーにまたがる最大750,000件のSafariルール。推奨リスト、地域別に自動選択されるリスト、オプションの迷惑要素およびCookieバナー用フィルターを備えています。
<details>
<summary>ブロッキングの詳細</summary>
<br>
- AdGuard互換のフィルターリストをSafariネイティブのルールにコンパイルし、5つのコンテンツブロッカーに分散させます。各ブロッカーの上限は150,000ルールです。Safariはアプリのプロセス外でルールを適用します。
- 推奨デフォルトリスト、地域別フィルターの自動選択、オプションの迷惑要素およびCookieバナー用フィルター。URL、貼り付けたテキスト、ファイルインポートによるカスタムリストの追加が可能です。
- 毎時から毎週までのスケジュール更新。対応リストでは差分ダウンロードを利用できます。macOSでは、アプリが閉じている間も起動エージェントが更新を確認します。
- `utm_*` を含むトラッキングパラメータの削除と、短縮リンクの解決。どちらもデフォルトで有効です。
- 容量インジケーターとルールビューア。コンパイル済みルール、未対応のエントリ、重複ルール、スクリプト拡張機能が処理するルール、最新の更新による変更を表示します。
</details>
### ユーザースクリプト
Greasemonkey互換のエンジン、UserCSSテーマ、Tube Cleaner、DeArrow、Dark Readerなどを含む組み込みカタログ。
<details>
<summary>ユーザースクリプトの詳細</summary>
<br>
- 独立したスクリプト拡張機能が、スクリプトレット、コスメティックフィルタリング、ユーザースクリプト、ユーザースタイル、要素の非表示をサポートします。
- `GM_*` および `GM.*` APIをサポートするGreasemonkey互換エンジン。`GM_xmlhttpRequest` は、スクリプトの `@connect` メタデータで宣言されたホストに制限されます。
- LessおよびStylusをサポートするUserCSSテーマ(`.user.css`)。[docs/USERSTYLES.md](https://github.com/0xcub3/wblock/blob/main/docs/USERSTYLES.md) を参照してください。
- Tube Cleaner、Player Cleaner、DeArrow、Dark Reader、Return YouTube Dislike、Bypass Paywalls Clean、AdGuard Extra、AdGuard Popup Blocker、TwitchAdSolutionsを含む組み込みカタログ。カタログのスクリプトはデフォルトで無効ですが、アンチアドブロックチェックを処理するtinyShieldは例外です。
</details>
### ネイティブ動画
Tube Cleaner と Player Cleaner は、動画に Safari ネイティブのコントロールを提供し、ピクチャ・イン・ピクチャ、バックグラウンド音声、SponsorBlock を利用できるようにします。
<details>
<summary>ネイティブ動画について詳しく</summary>
<br>
Tube Cleaner と Player Cleaner は、ページがレンダリングされる前に既存の動画要素に対して Safari ネイティブのコントロールを有効にします。これにはピクチャ・イン・ピクチャ、バックグラウンド音声、フルスクリーン再生、Now Playing が含まれます。
Tube Cleaner は YouTube で動作し、元の動画ストリームを維持します。チャプターとキャプションを Safari ネイティブのメニューに表示し、カテゴリごとの設定で SponsorBlock によるスポンサーのスキップを行います。代替のタイトルとサムネイルには DeArrow を別途利用できます。
Player Cleaner は video.js、JW Player、Plyr、Flowplayer、MediaElement、Clappr、Media Chrome、および Archive.org のような shadow-root プレイヤーをサポートします。再生速度、音量、キャプション、再生位置をサイトごとに保存します。
両スクリプトはアプリのリリースとは独立して [wBlock-userscripts](https://github.com/0xCUB3/wBlock-userscripts) から更新されます。広告ブロックはフィルターリストが担います。
</details>
### サイトごとのコントロールと同期
Safari のポップアップでは、サイトごとにフィルタリング、ユーザースクリプト、自動再生のオン・オフを切り替えられ、Element Zapper はそれ以外の要素を非表示にします。リスト、スクリプト、設定は iCloud を通じて同期されます。
<details>
<summary>サイトごとのコントロールと同期について詳しく</summary>
<br>
Safari ツールバーのポップアップには、フィルタリング、ユーザースクリプト、自動再生の個別スイッチと、Element Zapper があります。フィルターリストとユーザースクリプトは、選択したサイトに限定したり、特定のドメインから除外したりできます。Zapper のルールは設定で編集できます。iPhone と iPad では、Element Zapper は共有シートにもあるため、他のアプリの内蔵ブラウザから開いたページも非表示にできます。これらのルールは、wBlock で次に「適用」を実行した後に他のアプリへ反映されます。
wBlock は macOS、iOS、iPadOS、visionOS で動作します。iCloud 同期はフィルターリスト、カスタムフィルター、ユーザースクリプト、許可リスト、設定を対象とします。ローカルバックアップのエクスポートも利用できます。
</details>
### 設計段階からのプライバシー
wBlock はデータを一切収集しません。Safari がアプリの外部でルールを適用し、アイドル時のメモリ使用量は約 40 MB です。
> [!TIP]
> [比較ガイド](https://github.com/0xcub3/wblock/blob/main/Adblock_Comparison.md)では、wBlock、uBlock Origin Lite、Wipr、AdGuard を比較しています。
## スクリーンショット
<p align="center">
<picture>
<source media="(prefers-color-scheme: dark)" srcset="docs/media/img/filters_macos_dark.png" />
<img src="https://assets.kitploit.com/production/public/readmes/9565/82e5de58ecd0e34c8b3e11869d2b944ac5ef54c0391a6e1027ff483a0a4c9601/51024bdb66ef35314102814037052822f648b087c62ef8428745a48560c4deab-display-v1.webp" alt="macOS のフィルター" width="760" />
</picture>
<br><sub>macOS のフィルター</sub>
</p>
<br>
<p align="center">
<picture>
<source media="(prefers-color-scheme: dark)" srcset="docs/media/img/scripts_popup_ios_dark.png" />
<img src="https://assets.kitploit.com/production/public/readmes/9565/976e753bbfe670701961a4c7c9f1b93233eef1ca9983f1adf27758905bb96973/1b19d722633b19330382d5281738f539a403c96c26fc1eceb81f8945483ada3b-display-v1.webp" alt="iPhone の Safari ポップアップ" height="560" />
</picture>
<img src="https://assets.kitploit.com/production/public/readmes/9565/630d6f33e78c95d190de68c7d897865802df77edf39cee596e94fdaa3e583f84/ba00ede1e1b803daf3a6225cb2629bde1b228c928a39c85491e5f87d96492775-display-v1.webp" alt="Tube Cleaner の SponsorBlock 設定" height="560" />
<br><br><sub>iPhone の Safari ポップアップと、Tube Cleaner の SponsorBlock</sub>
</p>
<br>
<p align="center">
<picture>
<source media="(prefers-color-scheme: dark)" srcset="docs/media/img/userscripts_macos_dark.png" />
<img src="https://assets.kitploit.com/production/public/readmes/9565/0a43bfebcee0c1168a4d27d03874a69ff837c625d6a3ec37b9834126f1760d3f.png" alt="macOS のユーザースクリプト" width="760" />
</picture>
<br><sub>macOS のユーザースクリプト</sub>
</p>
<br>
<p align="center">
<picture>
<source media="(prefers-color-scheme: dark)" srcset="docs/media/img/settings_macos_dark.png" />
<img src="https://assets.kitploit.com/production/public/readmes/9565/34551e39e45c30e4a70cbd7600583229103edb5608582a2f01e68b99493a69cf.png" alt="macOS の設定" width="760" />
</picture>
<br><sub>macOS の設定</sub>
</p>
## インストール
[App Store](https://apps.apple.com/us/app/wblock/id6746388723) 版が wBlock をインストールする推奨の方法です。自動的に更新され、Apple による署名と審査を受けています。iPhone、iPad、Apple Vision Pro では、App Store が入手できる唯一の方法です。
Mac では、[最新リリース](https://github.com/0xCUB3/wBlock/releases/latest)から DMG をダウンロードするか、Homebrew を使用することもできます:
```sh
brew install --cask wblock
```
Homebrew は [homebrew/cask](https://github.com/Homebrew/homebrew-cask/blob/main/Casks/w/wblock.rb) からインストールするため、追加の tap は不要です。旧 tap を使用していた場合は、[移行手順](https://github.com/0xcub3/wblock/blob/main/docs/HOMEBREW.md#move-from-the-old-tap)に従ってください。
初回起動時、wBlock は Safari で拡張機能を有効にする手順を案内します。
## 仕組み
アプリはフィルタリストをダウンロードし、[SafariConverterLib](https://github.com/AdguardTeam/SafariConverterLib) 4.3.0 で変換します。ルールは Ads、Privacy、Security、Foreign、Custom の 5 つのコンテンツブロッカーに分散されます。Safari はアプリとは独立してそれらをコンパイルおよび適用します。wBlock Scripts 拡張機能は、静的ルールでは表現できない処理を担当します。
フィルタデータは LZ4 圧縮を用いた Protocol Buffers で保存され、ストリーミング書き込みによってコンパイル中のピークメモリを低く抑えます。リストを変更すると、影響を受けるコンテンツブロッカーのみが再構築されます。変更を反映するには、Safari が更新されたルールセットを再読み込みする必要があります。
[比較ガイド](https://github.com/0xcub3/wblock/blob/main/Adblock_Comparison.md#how-wblock-works-around-static-rules)には、特定のサイトでフィルタリングを無効にするために使用するルールが記載されています。
## FAQ
<details>
<summary>wBlock は他の広告ブロッカーと併用すべきですか?</summary>
<br>
いいえ。汎用のコンテンツブロッカーは一度に 1 つだけ使用してください。
複数のブロッカーは、同じページやリクエストに対して競合する変更を加える可能性があります。Mozilla の [webRequest ドキュメント](https://developer.mozilla.org/en-US/docs/Mozilla/Add-ons/WebExtensions/API/webRequest/onHeadersReceived)では、競合するレスポンスの変更により、1 つの拡張機能の変更だけが成功する可能性があることが説明されています。[uBlock Origin のドキュメント](https://github.com/gorhill/ublock#all-programs)は、他のコンテンツブロッカーとの併用を推奨していません。[AdGuard のガイダンス](https://adguard.com/en/adguard-browser-extension/opera/overview.html)では、読み込みの遅延、サイトの表示崩れ、動画再生の問題が起こりうる結果として挙げられています。
wBlock の問題を報告する前に、他の広告ブロッカーを無効にしてください。これにより、ブロックの失敗やサイト互換性の問題の原因を切り分けられます。
<img width="1560" height="176" alt="Skill Issue" src="https://assets.kitploit.com/production/public/readmes/9565/a6de7686522f14ac83be4be091c405aef8881625609202420c0bbd5bf4086cd2/7329a16d44d089a6c58e51bd5ac843782b725f112f06eeac58c6fd12ec171850-display-v1.webp" />
</details>
<details>
<summary>追加のフィルタリストを有効にすべきですか?</summary>
<br>
推奨されるデフォルト設定で、ほとんどの広告とトラッカーをカバーできます。追加の汎用リストは既存のルールと重複することが多く、Safari のルール容量を消費し、サイト互換性の問題が発生するリスクを高めます。迷惑要素リストは、Cookie バナー、ポップアップ、ソーシャルウィジェットをカバーします。地域別リストは、英語以外のサイトに対する追加のカバレッジを提供します。
</details>
<details>
<summary>wBlock が HaGeZi のブロックリストを提供していないのはなぜですか?</summary>
<br>
HaGeZi のリストは、主に DNS ブロッキング向けに作られた優れたリストです。Safari では、ブラウザ向けのリストがより有効に活用できるルール領域を消費します。HaGeZi は、モバイル広告ブロッカーにはコンテンツフィルタリストを、DNS レベルでは DNS リストを推奨しており、wBlock も同じ方針に従っています。wBlock は HaGeZi Multi Pro Mini の提供を終了しており、更新すると、それを有効にしていたデバイスから削除されます。
出典を含む詳細な説明は [docs/HAGEZI.md](https://github.com/0xcub3/wblock/blob/main/docs/HAGEZI.md) にあります。
</details>
<details>
<summary>wBlock は Safari を遅くしますか?</summary>
<br>
通常の使用では遅くなりません。Safari はコンパイル済みのルールを wBlock アプリのプロセス外で適用するため、ページの読み込みがアプリを待つことはありません。アイドル時のメモリ使用量は約 40 MB です。
</details>
<details>
<summary>Twitch の広告をブロックするにはどうすればよいですか?</summary>
<br>
Userscripts タブで TwitchAdSolutions(vaft)または AdGuard Extra を有効にしてから、Twitch を再読み込みしてください。TwitchAdSolutions が専用の選択肢です。これらのスクリプトは一度に 1 つだけ使用してください。Twitch は広告の配信方法を頻繁に変更するため、スクリプトが更新されるまでブロックが一時的に影響を受ける場合があります。
</details>
<details>
<summary>プライベートブラウズで Cookie バナーのフィルタやスクリプトレットが機能しないのはなぜですか?</summary>
<br>
Safariでは、拡張機能がプライベートブラウズで動作するために明示的な許可が必要です。ほとんどのCookieバナー除去フィルターは、wBlock Scriptsが提供するスクリプトレットに依存しています。Safari → 設定 → 機能拡張で、wBlock Scriptsと5つのコンテンツブロッカーすべてに対して「プライベートブラウズで許可」を有効にし、その後プライベートウインドウを再読み込みしてください。
保存された同意Cookieが、通常のウインドウでバナーが表示されない理由である可能性があります。通常のブラウズとプライベートブラウズの動作を比較する前に、そのサイトのCookieを消去してください。
</details>
<details>
<summary>ユーザースクリプトのネットワークリクエストはどのように処理されますか?</summary>
<br>
`GM_xmlhttpRequest` を使用するには `@grant GM_xmlhttpRequest` または `@grant GM.xmlHttpRequest` が必要です。リクエストは、スクリプトの `@connect` メタデータで宣言されたホストに制限されます。ホスト名のみを指定すると、そのホストとそのサブドメインが許可されます。`localhost`、`self`、`*` もサポートされています。`@connect` がない場合、リクエストは現在のホストに限定されます。現時点では、ドメインごとの許可プロンプトは利用できません。
サポートされるのはHTTPとHTTPSのみです。リダイレクト先は、リクエストがそれに従う前にチェックされます。Safariがリダイレクト先を拡張機能に公開しない場合、ホスト制限を回避するのではなく、リクエストは失敗します。リクエストにはブラウザのCookieや保存された認証情報は含まれません。`anonymous` とマークされたリクエストは、スクリプトが提供するCookieも除外します。
</details>
<details>
<summary>Tube CleanerとPlayer Cleanerはどこにありますか?</summary>
<br>
どちらのスクリプトも、ユーザースクリプトタブの一般セクションの上部に一覧表示され、デフォルトでは無効になっています。スクリプトを有効にした後、チャプター、キャプション、SponsorBlockなどの個々の機能を個別に設定できます。互換性の問題が発生した場合、Player CleanerはSafariツールバーのポップアップから特定のサイトに対して無効にできます。
</details>
<details>
<summary>フィルターはどのくらいの頻度で更新されますか?また、wBlockを開いたままにする必要がありますか?</summary>
<br>
更新は1時間ごとから週1回までスケジュールするか、手動で実行できます。アプリを開いたままにする必要はありません。macOSでは、アプリが閉じている間も起動エージェントが更新を確認します。この動作は設定で無効にできます。
iOSおよびiPadOSでは、バックグラウンド更新はオペレーティングシステムによってスケジュールされます。バックグラウンドApp更新を無効にしたり、アプリスイッチャーからwBlockを強制終了したりすると、更新頻度が低下するか、アプリを開くまで更新が遅延する可能性があります。
</details>
## サポート
<div align="center">
wBlockは無料のオープンソースです。お役に立てば、Open Collectiveで開発を支援できます。
<br>
<a href="https://opencollective.com/skula/projects/wblock">
<img src="https://assets.kitploit.com/production/public/readmes/9565/888185d078b1763d0469847749dec546281355c97b40f1aeea46a80665c78d92.png" alt="Donate on Open Collective" width="220" />
</a>
<br>
<br>
[バグの報告または機能のリクエスト](https://github.com/0xCUB3/wBlock/issues) · [Discordに参加](https://discord.gg/Y3yTFPpbXr) · [プライバシーポリシー](https://github.com/0xcub3/wblock/blob/main/PRIVACY_POLICY.md)
</div>
## クレジット
<div align="center">
<sub>コントリビューターには [@arjpar](https://github.com/arjpar)、[@ameshkov](https://github.com/ameshkov)、[@shindgew](https://github.com/shindgew) が含まれます。ルール変換とスクリプトレットは [AdGuard](https://github.com/AdguardTeam) から提供されています。SponsorBlockとDeArrowのデータは、CC BY-NC-SA 4.0の下で [Ajay Ramachandran](https://sponsor.ajay.app/) のプロジェクトから提供されています。</sub>
<br>
<br>
</div>
<div align="center">
<a href="https://www.star-history.com/?repos=0xCUB3%2FwBlock&type=date&legend=top-left">
<picture>
<source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/chart?repos=0xCUB3/wBlock&type=date&theme=dark&legend=top-left&sealed_token=FHF3tvPu6mhBn3K4_1fpH1nj2W36bTa6aW6_u-990mCb5zN_PRort245hoHzQEhFBRJo38qUYoOzU1huHG4_mHDsYpO7YxzKOIJEUaQI4NQNRDSdt9aZ_T1PVVSIaXqpdYnrBTTIlKhCEkYdneNsXEnpXhiUB3GW2F-tnsMNC4DPQJUKAmJK90omDnb2" />
<img alt="Star history" src="https://api.star-history.com/chart?repos=0xCUB3/wBlock&type=date&legend=top-left&sealed_token=FHF3tvPu6mhBn3K4_1fpH1nj2W36bTa6aW6_u-990mCb5zN_PRort245hoHzQEhFBRJo38qUYoOzU1huHG4_mHDsYpO7YxzKOIJEUaQI4NQNRDSdt9aZ_T1PVVSIaXqpdYnrBTTIlKhCEkYdneNsXEnpXhiUB3GW2F-tnsMNC4DPQJUKAmJK90omDnb2" />
</picture>
</a>
</div>