Skip to main content

​
Introduction to Scramjet

Scramjet is an interception-based web proxy designed to bypass arbitrary web browser restrictions, support a wide range of sites, and act as middleware for open-source projects. It prioritizes security, developer friendliness, and performance.

​
What is Scramjet?

Scramjet uses a service worker-based architecture to intercept and rewrite web traffic, allowing you to:
  • Bypass web browser restrictions and filters
  • Proxy popular websites including Google, YouTube, Discord, Reddit, and more
  • Build privacy-focused web applications
  • Create custom proxy solutions with full developer control

​
Key features

CAPTCHA support

Built-in support for CAPTCHAs on major sites like Google and YouTube

Wide site compatibility

Works with Twitter, Instagram, Spotify, Discord, Reddit, GeForce NOW, and more

Service worker architecture

Uses modern browser APIs for powerful request interception

Developer friendly

Clean API with TypeScript support and comprehensive documentation

Flexible configuration

Customize codecs, flags, and behavior to suit your needs

Performance optimized

Efficient WASM-based rewriting for fast page loads

​
Supported sites

Scramjet has been tested and works with:
  • Google
  • Twitter
  • Instagram
  • YouTube
  • Spotify
  • Discord
  • Reddit
  • GeForce NOW
Ensure you are not hosting on a datacenter IP for CAPTCHAs to work reliably. Heavy amounts of traffic on a single IP may cause some sites to stop working. Consider rotating IPs or routing through Wireguard.

​
How it works

Scramjet operates in two main contexts:
  1. Window context - Uses the ScramjetController to manage frames and communicate with the service worker
  2. Service worker context - Uses ScramjetServiceWorker to intercept and rewrite requests
The service worker intercepts fetch requests, rewrites URLs and content, and returns modified responses that bypass restrictions while maintaining site functionality.

​
Get started

Installation

Install Scramjet via npm, yarn, or pnpm

Quickstart

Get a working proxy setup in minutes

​
Next steps

Ready to get started? Follow our installation guide to set up Scramjet, then check out the quickstart tutorial to create your first proxy.