MCPcopy Index your code
hub / github.com/adsbypasser/adsbypasser

github.com/adsbypasser/adsbypasser @v8.19.0

Chat with this repo
repository ↗ · DeepWiki ↗ · release v8.19.0 ↗ · + Follow
225 symbols 455 edges 117 files 47 documented · 21%
What it actually does AI analysis from the code graph — generated when you open this
loading…
README

AdsBypasser

Build Status

A lightweight userscript that automatically skips countdown ads, bypasses continue pages, and prevents ad pop-up windows on many supported sites.

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:
  2. Tampermonkey (Chrome, Firefox, Edge, Safari, Opera)
  3. Violentmonkey (Chrome, Firefox, Edge)
  4. Greasemonkey (Firefox)
  5. FireMonkey (Firefox)

  6. Install AdsBypasser from the homepage

Editions: - 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

If you need help implementing a handler, tag the issue or PR and request guidance — maintainers and community members can advise.

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.

Core symbols most depended-on inside this repo

$
called by 89
templates/userscript/namespace.template.js
register
called by 42
src/lib/dispatcher.js
createPattern
called by 41
tests/dispatcher.js
findHandler
called by 40
src/lib/dispatcher.js
mockLocation
called by 38
tests/dispatcher.js
getAttribute
called by 9
templates/jekyll/assets/js/components.js
find
called by 8
src/lib/core.js
fn
called by 8
tests/core.js

Shape

Function 191
Method 22
Class 12

Languages

TypeScript100%

Modules by API surface

src/lib/ajax.js20 symbols
templates/jekyll/assets/js/components.js16 symbols
src/lib/core.js16 symbols
src/lib/dom.js13 symbols
src/lib/platform.js11 symbols
src/lib/image.js10 symbols
src/lib/dispatcher.js8 symbols
src/main.js7 symbols
src/lib/config.js6 symbols
src/lib/misc.js4 symbols
src/lib/logger.js4 symbols
src/lib/link.js4 symbols

For agents

$ claude mcp add adsbypasser \
  -- python -m otcore.mcp_server <graph>

⬇ download graph artifact

Ask about this repo answers extend the page