π₯ Quick Install β’ π Documentation β’ π€ Contributing β’ β FAQ
uBlock CustomFilters is a curated collection of advanced filter lists designed for uBlock Origin, featuring two specialized filter sets:
|
Bypass shortlinks automatically with timer acceleration, ad removal, anti-adblock evasion, and automated navigation. Popular services: link-to.net, exe.io, ouo.io, shrinkme.io, linkvertise |
Optimize crypto faucets and PTC sites with claim automation, timer boost, captcha handling, and iframe removal. Popular platforms: FaucetPay, auto-faucets, ClixSense, NeoBux |
Warning
These filters use advanced web manipulation techniques (timer optimization, automated interactions, script modifications). Intended for educational and research purposes. Review website Terms of Service before use.
Click the subscribe button for your desired filter list:
| Filter List | Purpose | Subscribe |
|---|---|---|
| π LinkGuard | Shortlink bypass, ad removal, timer boost | |
| π° CryptoBlock | Faucet optimization, PTC boost, auto-claim |
- Open uBlock Origin dashboard
- Navigate to "Filter lists" tab
- Scroll to "Custom" section
- Check "Import..." and paste the URL:
LinkGuard: https://raw.githubusercontent.com/Suurp/uBlock-CustomFilters/refs/heads/main/filters-shortlinks.txt
CryptoBlock: https://raw.githubusercontent.com/Suurp/uBlock-CustomFilters/refs/heads/main/filters-faucets.txt
- Click "Apply changes"
Important
Trust configuration is mandatory for filters to work correctly.
These filters use advanced techniques requiring explicit trust configuration:
- Open uBlock Origin dashboard β Settings
- Enable "I am an advanced user" (βοΈ icon appears)
- Click the βοΈ gear icon
- Locate
trustedListPrefixes - Add to existing value (space-separated):
https://raw.githubusercontent.com/Suurp/uBlock-CustomFilters/
Tip
Example configuration:
Before: ublock-
After: ublock- https://raw.githubusercontent.com/Suurp/uBlock-CustomFilters/
- Click "Apply changes" and restart browser
π§ How it works
Core Techniques:
- Scriptlet injection for behavior modification
- Timer manipulation and acceleration
- DOM element removal and modification
- Event listener interception
- Automated form interactions
- Client-side captcha bypass (when improperly validated)
Compatible with: All browsers supporting uBlock Origin (Chrome, Firefox, Edge, Opera, Brave)
After installation:
- Visit a test site (e.g., link-to.net, exe.io)
- Open uBlock Logger (dashboard β Logger icon)
- Observe filter activity in real-time
- Verify bypass functionality works as expected
Note
Some sites use server-side validation that cannot be bypassed client-side.
Bypass not working?
Checklist:
- β
Verify
trustedListPrefixesis configured correctly - β Clear browser cache and cookies
- β Check uBlock Origin logger for errors
- β Temporarily disable other extensions
- β Ensure filters are up-to-date
- β Report persistent issues on GitHub
Common Issues:
- Site still shows timer: Server-side validation in use
- Captcha not bypassed: Only client-side captchas work
- Page broken: Possible conflict with other filters
Caution
Recommended: Use only with uBlock Origin's default filters. Adding third-party lists may cause conflicts or errors.
Tip
- Keep filters updated regularly
- Test on a few sites before widespread use
- Report issues on GitHub for quick fixes
- Consider supporting sites you use frequently
We welcome contributions! Here's how you can help:
Note
When reporting issues, please include:
- Site URL and specific problem
- Browser console errors (F12 β Console)
- uBlock Origin logger output
- Which filter list (LinkGuard/CryptoBlock)
Open an issue for:
- Sites not bypassing correctly
- Broken functionality after update
- New site support requests
- Filter conflicts or errors
Important
All contributions must be tested thoroughly and follow ethical guidelines.
To contribute new filters:
- Fork this repository
- Test your filters on latest uBlock Origin
- Document the bypass technique used
- Submit a Pull Request with clear description
Help improve this README by:
- Fixing typos or unclear sections
- Adding examples or use cases
- Translating to other languages
- Creating tutorials or guides
Are these filters legal to use?
These filters use techniques similar to popular browser extensions and userscripts. Legality depends on usage:
- β Personal learning and research: Generally acceptable
- β Understanding web technologies: Completely fine
β οΈ Website ToS compliance: User's responsibility to review- β Large-scale abuse: Against site policies and not recommended
Bottom line: Use responsibly, respect policies, and you'll be fine. These are educational tools.
Will these filters speed up timers?
Yes, many timers can be accelerated or bypassed. However:
- Effectiveness varies by site implementation
- Server-side validated timers cannot be bypassed
- Some sites detect and block timer manipulation
- Results depend on bypass method available
Do I need both filter lists?
No, choose based on your needs:
- LinkGuard only: For shortlink services
- CryptoBlock only: For crypto faucets and PTC sites
- Both: If you use both types of services
Lists are independent and can be used separately.
Why trust configuration required?
Advanced techniques (scriptlet injection, timer manipulation) require explicit trust for security. This is a uBlock Origin safety feature preventing arbitrary code execution.
Do these work on mobile?
Yes, but only on:
- β Firefox for Android (with uBlock Origin)
- β Kiwi Browser (with Chrome extensions)
- β Chrome mobile (no extension support)
- β Safari mobile (limited extension support)
How to update filters manually?
- Open uBlock Origin dashboard
- Go to "Filter lists" tab
- Click the clock icon π (Update now)
- Wait for update to complete
Can I contribute my own bypass filters?
Absolutely! We welcome contributions:
- Test filters thoroughly
- Document the technique
- Ensure ethical use
- Submit detailed Pull Request
See Contributing section for details.
- π uBlock Origin Wiki
- π‘οΈ uBlock Resources Library
- π Scriptlet Documentation
- π¬ r/uBlockOrigin Community
- π§ Filter Syntax Guide
This project is licensed under the MIT License - see the LICENSE file for details.
In simple terms: Free to use, modify, and share. Provided as-is for educational purposes. Use responsibly.
- uBlock Origin Team - For the incredible ad blocker
- Community Contributors - For testing and feedback
- Filter List Maintainers - For inspiration and techniques
Need help?
- π§ Open an Issue
- β Star this repository if you find it useful!