This repo is an open-source repository of PIE's adblock rules and scriptlets reader. We are constantly adding new rules as our users report ads and hope to create a stronger adblocking community together. Our filters are constantly being updated by our team here in the US!
In filterlists/, you will find our custom text filters that include cosmetic EasyList-style rules as well as scriptlet-based rules that tackle more persistent issues on certain sites. These rules may or may not be covered by other filter lists but were generated in response to users reporting ads/annoyances on specific sites.
To add our list to your adblocker's filter list rules, you can download or reference it from here! https://cdn.pie.org/adb-filters/pie_custom.txt
In scriptlets/, you will find our scriptlet reader source code and scriptlet source functions. Pie believes this scriptlet reader to be more plug-and-play ready than the other AST-based rule readers available online. Our scriptlet reader works on both UBO and ADG style scriptlet rules.
In scriptlets/example.js, you will find a simple example usage reading a scriptlet text rule (like those you will find in filterlists/scriptlet-rules.txt) and then calling on Chrome's executeScript API to run it. We hope this helps you get off the ground using scriptlets!
Scriptlets were built from AdguardTeam/Scriptlets with slight modifications. To generate a new version of the built scriptlets, or for much more detailed documentation, please refer to their repo.
Our modifications primarily include:
- Adding deduping if the scriptlet with the same source has already been called on this page
- Debug logging
- Refactoring out plain "javascript"-style rules #%#(() => into scriptlet/site-unique, to avoid adding remote JS snippets to our rules text files
We will continue to develop tools to make adblocking accessible for the public, and commit to improving both our tools and our filterlists going forward.
To test the scriptlets, see the example in scriptlets/example.js or run while inside scriptlets/ with:
npm run testPortions of the Adblock Rules are modified versions of text rules from [uAssets] and scriplets from [AdGuard Scriptlets], which is also licensed under the GPL v3 license.
© The People’s Internet Experiment 2025. Repository open source licensed under GNU GPLv3 License.