Skip to content

Suurp/uBlock-CustomFilters

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

πŸ›‘οΈ uBlock CustomFilters

Advanced filter lists for enhanced web browsing

License: MIT uBlock Origin Maintenance Stars

πŸ“₯ Quick Install β€’ πŸ“– Documentation β€’ 🀝 Contributing β€’ ❓ FAQ


πŸ“‹ Overview

uBlock CustomFilters is a curated collection of advanced filter lists designed for uBlock Origin, featuring two specialized filter sets:

πŸ”— LinkGuard Filter

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

πŸ’° CryptoBlock Filter

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.


πŸš€ Quick Installation

Method 1: One-Click Subscribe (Recommended)

Click the subscribe button for your desired filter list:

Filter List Purpose Subscribe
πŸ”— LinkGuard Shortlink bypass, ad removal, timer boost Subscribe
πŸ’° CryptoBlock Faucet optimization, PTC boost, auto-claim Subscribe

Method 2: Manual Import

  1. Open uBlock Origin dashboard
  2. Navigate to "Filter lists" tab
  3. Scroll to "Custom" section
  4. 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
  1. Click "Apply changes"

βš™οΈ Required Configuration

Important

Trust configuration is mandatory for filters to work correctly.

These filters use advanced techniques requiring explicit trust configuration:

  1. Open uBlock Origin dashboard β†’ Settings
  2. Enable "I am an advanced user" (βš™οΈ icon appears)
  3. Click the βš™οΈ gear icon
  4. Locate trustedListPrefixes
  5. 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/
  1. Click "Apply changes" and restart browser

✨ Features & Technical Details

πŸ”§ 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)


πŸ› οΈ Advanced Usage

Testing & Verification

After installation:

  1. Visit a test site (e.g., link-to.net, exe.io)
  2. Open uBlock Logger (dashboard β†’ Logger icon)
  3. Observe filter activity in real-time
  4. Verify bypass functionality works as expected

Troubleshooting

Note

Some sites use server-side validation that cannot be bypassed client-side.

Bypass not working?

Checklist:

  • βœ… Verify trustedListPrefixes is 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

Best Practices

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

🀝 Contributing

We welcome contributions! Here's how you can help:

πŸ› Report Issues

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

πŸ’‘ Submit Filters

Important

All contributions must be tested thoroughly and follow ethical guidelines.

To contribute new filters:

  1. Fork this repository
  2. Test your filters on latest uBlock Origin
  3. Document the bypass technique used
  4. Submit a Pull Request with clear description

πŸ“š Improve Documentation

Help improve this README by:

  • Fixing typos or unclear sections
  • Adding examples or use cases
  • Translating to other languages
  • Creating tutorials or guides

❓ FAQ

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?
  1. Open uBlock Origin dashboard
  2. Go to "Filter lists" tab
  3. Click the clock icon πŸ• (Update now)
  4. Wait for update to complete
Can I contribute my own bypass filters?

Absolutely! We welcome contributions:

  1. Test filters thoroughly
  2. Document the technique
  3. Ensure ethical use
  4. Submit detailed Pull Request

See Contributing section for details.


πŸ”— Related Resources


πŸ“œ License

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.


πŸ™ Acknowledgments

  • uBlock Origin Team - For the incredible ad blocker
  • Community Contributors - For testing and feedback
  • Filter List Maintainers - For inspiration and techniques

πŸ“ž Support

Need help?

  • πŸ“§ Open an Issue
  • ⭐ Star this repository if you find it useful!

Made with ❀️ for optimized browsing

⬆ Back to Top


GitHub stars GitHub forks GitHub watchers