tinyShield blocks Ad-Shield reinstable advertisements and bypasses Ad-Shield's virtual integrity layer.
tinyShield userscript is managed by the adblock community.
If you need help or have any questions during installation or usage, please use GitHub Discussions.
If you believe this userscript is causing issues while in use, please use GitHub Issues.
Important
tinyShield userscript maintainer recommends using one of the following adblockers with tinyShield userscript:
- AdGuard
- uBlock Origin
Supporting other adblockers is not guaranteed and even if requested, it may be rejected.
Discord Bot or Telegram @filteringdev_noti_bot can be used to receive update notifications.
Just click the following URL to detect this userscript.
https://cdn.jsdelivr.net/npm/@filteringdev/tinyshield@latest/dist/tinyShield.user.js
Important
The grouped subscription URLs below are only for Apple Safari Extension users.
If you use AdGuard's userscript support, keep using the default URL (dist/tinyShield.user.js).
- Build output structure:
- Default script:
https://cdn.jsdelivr.net/npm/@filteringdev/tinyshield@latest/dist/tinyShield.user.js - Domain-grouped scripts:
https://cdn.jsdelivr.net/npm/@filteringdev/tinyshield@latest/dist/grouped/<initial>/tinyShield-<domain-group>.user.js
- Default script:
- How to choose the subscription file for your domain group:
- Open
https://cdn.jsdelivr.net/npm/@filteringdev/tinyshield@latest/dist/grouped/. - Open the
<initial>/subdirectory that matches the first character of your target grouped file name. - Select one
tinyShield-<domain-group>.user.jsfile for the website you use. - Open that file once and confirm its metadata
@matchincludes your target domain. - Subscribe to that exact grouped file URL in your Safari userscript extension.
- Open
This domain-group split is intended to reduce the impact scope of #38 as much as possible.
Violentmonkey is recommended for Firefox and Chromium-based browsers. wBlock is recommended for Safari on macOS, iOS, and iPadOS. Tampermonkey is not recommended.
-
Violentmonkey (Recommended) - Firefox and Chromium-based browser extension
- Open
Dashboard. - Click
Newbutton. - Click
Install from URLbutton. - Input the following URL:
https://cdn.jsdelivr.net/npm/@filteringdev/tinyshield@latest/dist/tinyShield.user.js- Click
OKbutton. - Confirm metadata of the userscript and click
Confirm installation. - Return to a tab opening the website protected by Ad-Shield and reload the tab by pressing F5 or Ctrl + R or clicking the reload button.
Compatibility Table
Browser Extension License Compatibility Recommendation Tampermonkey Proprietary (Donationware) ✔ Not recommended Greasemonkey MIT ✘ Not recommended Violentmonkey MIT ✔ Recommended - Open
-
AdGuard for Windows
- Click
Settings. - Click
Extensions. - Click
Add extension. - Input the following URL:
https://cdn.jsdelivr.net/npm/@filteringdev/tinyshield@latest/dist/tinyShield.user.js - Click
Install. - Confirm metadata of the userscript and click
Install. - Return to a tab opening the website protected by Ad-Shield and reload the tab by pressing F5 or Ctrl + R or clicking the reload button.
- Click
-
AdGuard for Android
- Go to Settings -> Extension.
- Touch
New extension. - Input the following URL:
https://cdn.jsdelivr.net/npm/@filteringdev/tinyshield@latest/dist/tinyShield.user.js - Touch
Next. - Confirm metadata of the userscript and touch
Add. - Return to a tab opening the website protected by Ad-Shield and reload the tab by touching the reload button.
-
wBlock (Recommended) - Safari on macOS, iOS, and iPadOS
Installing with wBlock in Safari
- Install and open wBlock, then follow its initial setup instructions.
- Enable wBlock Scripts in Safari's extension settings and allow it to run on all websites.
- macOS:
Safari>Settings>Extensions - iOS/iPadOS 18+:
Settings>Apps>Safari>Extensions - iOS/iPadOS 17 and older:
Settings>Safari>Extensions
- macOS:
- Follow the domain group subscription guide above to choose your grouped script URL (
tinyShield-<domain-group>.user.js) and check its@matchmetadata. - In the wBlock app's
Userscriptsscreen, disable the built-in tinyShield entry to avoid running it alongside the grouped script. - On the same screen, open the add menu (
+) >Userscript>URL>Single URLand enter the grouped script URL. Do not use the full script URL from Quick Start. - Select
Next, review the metadata, then selectAddto add and enable the grouped script. - Return to your target website's tab in Safari and reload it.