browser.js/packages/scramjet

Scramjet

---

Scramjet is an experimental interception-based web proxy designed to evade internet censorship and bypass arbitrary browser restrictions.

Scramjet allows you to sandbox arbitrary web content, bypass CORS restrictions on loading websites, and instrument and debug websites inside the browser itself. This is accomplished through a combination of interception, rewriting, and sandboxing techniques. You can learn more about the technical details here.

Supported Sites

Some of the popular websites that Scramjet supports include:

• Google
• Youtube
• Instagram
• ChatGPT
• Reddit
• Twitter
• Discord
• Spotify
• GeForce NOW
• now.gg

Development

Dependencies

• Recent versions of node.js and pnpm
• rustup
• wasm-bindgen
• Binaryen's wasm-opt
• this wasm-snip fork

Building

• Clone the repository with git clone --recursive https://github.com/MercuryWorkshop/scramjet
• Build everything with ./cv build (.\cv.ps1 on Windows). It installs the dependencies, offers to install the rust tools above through cargo, and only rebuilds what changed. ./cv build wasm builds just the rewriter.

Running Scramjet Locally

You can run the Scramjet dev server when running this command at the root

./cv dev

The demo page for scramjet should now be running at http://localhost:4141 and should rebuild upon a file being changed (excluding the rewriter).