AdsBypasser

Install releases and read docs on the project's Homepage.

Features

• ✅ Skip countdowns and "continue" redirect pages where possible
• ✅ Prevent common ad pop-up windows/overlays
• ✅ Site-specific handlers for many domains (see Supported Sites)
• ✅ Lightweight client-side userscript — no analytics or phoning home
• ❌ Does not bypass reCAPTCHA or other interactive bot checks

Supported Sites & Platforms

See the full list of supported sites on the homepage and platform notes in the Wiki.

If a site is missing or broken, please open an Issue with:

• A sample URL
• Browser + userscript manager + script version
• Console errors (if any)
• Steps to reproduce

Installation

1. Install a userscript manager:

1. Install AdsBypasser from the homepage

• Full edition: Supports file hosting, link shorteners, and image hosting sites
• Lite edition: Supports file hosting and link shorteners only (smaller size)

Runtime Configuration

AdsBypasser supports runtime configuration to enable/disable handlers and toggle auto-close features.

See the configuration page for details.

Development

Prerequisites

• Node.js (version 22.12.0 or higher)
• npm (version 10.0.0 or higher)

Building

git clone https://github.com/adsbypasser/adsbypasser.git
cd adsbypasser
npm install
npm run build

The built userscripts will be available in the dist/ directory:

• dist/adsbypasser.full.user.js (Full edition)
• dist/adsbypasser.lite.user.js (Lite edition)

Development Workflow

# Build once
npm run build
Run tests
npm test
Lint code
npm run lint
Fix linting issues
npm run lint:fix
Format code
npm run format
Check code formatting
npm run format:check

See the Wiki for detailed build-chain and release instructions.

Contributing

Contributions are welcome! We accept:

• Bug reports
• Feature requests
• Pull requests
• New site handlers

Reporting Issues

When opening an issue for a broken/missing site handler, please include:

1. A reproducible example URL (or local HTML if protected)
2. Browser + userscript manager + script version
3. Console errors and expected behavior

Adding Site Support

To add support for a new site:

1. Create a new file in src/sites/{category}/{domain}.js
2. Follow the pattern in existing site handlers
3. Add JSDoc comments with @domain annotations
4. Test your implementation

Troubleshooting

Q: Why doesn't AdsBypasser bypass reCAPTCHA?

A: reCAPTCHA is an interactive bot check and is intentionally not bypassed.

Q: AdsBypasser doesn't work on a page — what now?

A: Open an issue with the URL, userscript version, browser and a short description; attach console output if available.

Q: How do I update the script?

A: Userscript managers automatically update scripts. You can also manually check for updates in your manager's dashboard.

Security & License

• Client-side userscript, no telemetry by default
• Review dist/ before installing if you have security concerns
• Do not use to bypass payment walls or violate site terms of service
• See our Security Policy for reporting vulnerabilities
• Licensed under the BSD 3-Clause License — see LICENSE.txt

Acknowledgements

Forked from RedirectionHelper by SuYS.

Thanks to all our contributors.