Scramjet Browser
Scramjet is a high-performance web proxy designed by Mercury Workshop to bypass internet censorship and enterprise-level web filters. Unlike older proxies, it uses a Service Worker-based architecture to rewrite web traffic in real-time, allowing it to proxy complex sites like Discord, YouTube, and Reddit with high stability. Setting Up Scramjet on Your Own Site
If you are a developer looking to host your own instance of the Scramjet proxy, follow these steps:
Install the PackageUse pnpm to install the latest alpha version of Scramjet:pnpm i @mercuryworkshop/scramjet@2.0.0-alpha
Configure Your Server RouteSet up a transport route to serve the Scramjet build. A common practice is to use /scram/ as the dedicated route: javascript
import scramjetPath from "@mercuryworkshop/scramjet/path" // Use this path to serve the distribution files Use code with caution. Copied to clipboard
Include Core Distribution FilesEnsure the following files are accessible via your web server in your /public/ directory: scramjet.all.js scramjet.wasm.wasm scramjet.sync.js
Register the Service WorkerCreate a sw.js file and include a script in your main application to register it. This is critical for intercepting and proxying requests: javascript
if ('serviceWorker' in navigator) navigator.serviceWorker.register('/sw.js', scope: '/' ) .then(reg => console.log('Scramjet registered:', reg)) .catch(err => console.error('Registration failed:', err)); Use code with caution. Copied to clipboard Advanced Browser Features
For building a full "browser-in-a-browser" interface, Scramjet provides a ScramjetController to manage isolated browsing contexts called Frames.
Create a Frame: Initialize the controller and append a frame to your site's DOM. javascript
const scramjet = new ScramjetController( prefix: '/scramjet/' ); await scramjet.init(); const frame = scramjet.createFrame(); document.body.appendChild(frame.frame); Use code with caution. Copied to clipboard
Navigation: Use the .go() method to navigate to a specific URL.frame.go('https://example.com');
Customization: You can apply CSS styles directly to the frame.frame element (the raw iframe) to adjust height, width, and borders. Best Practices & Performance
Browser Choice: Google Chrome is the primary testing environment for the Scramjet team and is currently the most stable browser for running the proxy.
Troubleshooting: If a site fails to load, clearing all site data for your proxy domain often resolves issues.
Documentation: For more technical guides on custom codecs or cookie management, refer to the official Scramjet Mintlify docs. Basic setup - Scramjet - Mintlify
is an experimental, interception-based web proxy framework designed primarily to evade internet censorship and bypass web browser restrictions. It is often used to create isolated browsing contexts that can run on a variety of sites while prioritizing security and performance. Key Features Censorship Evasion
: Built to bypass enterprise web filters and arbitrary restrictions. Isolated Contexts
: Enables developers to set up isolated browsing environments using a Basic Setup Guide Developer Friendly scramjet browser
: Offers a TypeScript API, custom URL encoding (codecs), and event listeners for handling navigation or downloads. Performance
: Designed to be high-speed and capable of acting as middleware for other open-source projects. Getting Started
To use or host Scramjet, developers typically follow these steps: Environment : Ensure you have a POSIX terminal and (v18.x LTS recommended) installed. Installation : Install the framework or use the Scramjet-App example provided by MercuryWorkshop on Customization
: You can customize Scramjet's behavior using feature flags or by implementing custom URL encoding strategies. : Scramjet should not be confused with the Scramjet Data Processing Platform
is a high-performance web proxy framework developed by Mercury Workshop
designed to bypass internet censorship and browser-based web filters. It is built using a service worker-based architecture that intercepts and rewrites web traffic, allowing users to access restricted sites like Google, YouTube, and Discord. Key Features Interception-Based Proxying
: Uses a service worker to intercept requests and rewrite them to bypass filters. Security & Isolation
: Provides isolated browsing contexts and focuses on maintaining performance without compromising security. Developer Friendly
: Offers a pluggable architecture with custom codecs and transport libraries like Compatibility
: Supports a wide range of popular websites and can be integrated into custom web applications. Technical Setup To implement Scramjet, you can use the official Quickstart guide Mercury Workshop Register a Service Worker : The proxy requires a service worker ( ) to be registered on your domain. Initialize the Controller : Load the ScramjetController to manage proxied frames. Create a Proxied Frame scramjet.createFrame()
to generate an iframe that can navigate to any URL through the proxy. Alternative Meanings
While you may be looking for the browser proxy, "Scramjet" also refers to: Working with frames - Scramjet - Mintlify
The Frontier of Connectivity: Understanding the Scramjet Browser
In the modern digital landscape, the web browser acts as the primary portal through which humanity accesses information, commerce, and communication. For decades, the market has been dominated by a few titans—Google Chrome, Safari, and Microsoft Edge—built on rendering engines like Blink and WebKit. However, the demand for privacy, speed, and novel architectures has given rise to a new wave of challengers. Among these emerging technologies is the Scramjet browser, a tool that represents a distinct shift in how users interact with the World Wide Web, emphasizing privacy, open-source transparency, and experimental performance.
To understand the significance of the Scramjet browser, it is essential first to decode its namesake. The term "scramjet" is an acronym for "Supersonic Combustion Ramjet," a type of high-speed air-breathing engine designed for hypersonic flight. By adopting this name, the developers signal a clear intent: to create a browsing experience that breaks the sound barrier of speed and operates on the cutting edge of technology. While traditional browsers often become bloated with background processes and tracking scripts that slow performance, Scramjet aims to strip away these inefficiencies to provide a streamlined, "hypersonic" user experience.
One of the defining characteristics of the Scramjet browser is its architectural foundation. Unlike proprietary giants such as Chrome, which operate on a closed-source model (despite being based on the open-source Chromium project), Scramjet is often developed as a fully open-source project. This distinction is vital for user trust. In an era where data is frequently commodified, open-source software allows the global community to inspect the code, ensuring there are no "backdoors" for corporations or governments to exploit. This transparency appeals to the growing demographic of privacy-conscious users and developers who wish to contribute to the browser's evolution.
Privacy is arguably the most compelling feature driving the adoption of browsers like Scramjet. Mainstream browsers have faced criticism for extensive tracking mechanisms, such as cookies and fingerprinting, which monitor user behavior across the web. Scramjet typically integrates aggressive privacy protections directly into its core. This includes built-in ad-blocking, tracker prevention, and the isolation of "supercookies." By blocking these elements at the engine level rather than relying on third-party extensions, the browser reduces the digital footprint users leave behind, effectively creating a "stealth" mode for everyday browsing.
Furthermore, the Scramjet browser caters to the developer and power-user community through its support for experimental web standards and extension ecosystems. Because it is built to be modular, it allows users greater customization. Where mainstream browsers often remove support for older protocols or enforce strict rules that limit user choice, Scramjet often embraces a philosophy of user agency. This flexibility makes it an attractive "daily driver" for those who find the constraints of the "Big Tech" browsers stifling, offering a balance between modern web compatibility and user control. Scramjet is a high-performance web proxy designed by
However, like any emerging technology, Scramjet faces challenges. The dominance of the Chromium engine means many websites are optimized specifically for Chrome-based browsers. As a result, niche or experimental browsers may occasionally encounter rendering issues on complex, modern web applications. Additionally, because Scramjet often operates with a smaller development team than its trillion-dollar competitors, the frequency of updates and security patches may differ. Yet, the open-source nature of the project often mitigates this, as a dedicated community of contributors can rapidly identify and fix vulnerabilities.
In conclusion, the Scramjet browser represents a critical evolution in how we access the internet. It is more than just a window to the web; it is a statement against the monopolization and data-harvesting practices of the current digital status quo. By combining the ideals of open-source transparency, rigorous privacy standards, and a focus on streamlined performance, Scramjet offers a glimpse into a future where the browser serves the user, not the advertiser. As the internet continues to expand, tools like Scramjet ensure that the pursuit of speed remains coupled with the fundamental right to privacy.
Scramjet browser technology is redefining web freedom by actively bypassing heavy network restrictions and providing unmatched client-side control.
Originally developed as a lightweight, highly efficient interception-based web proxy by the Mercury Workshop team on GitHub, Scramjet acts as a functional "browser inside a browser". It allows developers and privacy advocates to overcome restrictive firewalls, test web applications, and escape corporate or educational censorship. 🚀 What is the Scramjet Browser?
Scramjet is an advanced, interception-based web proxy that operates entirely within client-side JavaScript. Unlike traditional proxy tools that require massive external server resources, Scramjet relies on browser service workers and rewriting scripts to reroute HTTP traffic safely. The Core Capabilities
Full Interception: Captures web requests before they leave the client, allowing for real-time traffic modification.
Filter Bypassing: Evades aggressive enterprise and school web filters.
CORS Unlocking: Bypasses Cross-Origin Resource Sharing (CORS) blocks natively.
Headless Capability: Highly suited as middleware for open-source frameworks and automated environments. 🛠️ How Scramjet Works Under the Hood
To understand why Scramjet is gaining massive traction among developers, it is important to look at its core architecture. Traditional proxies act simply as middle routers, but Scramjet fundamentally alters how the browser processes information. 🛡️ 1. Service Worker Interception
Scramjet hooks directly into the browser's Service Worker API. When you request a blocked web page, the request is intercepted before it reaches the network. Scramjet then processes this through secure transports, like the Wisp Protocol or specialized WebSocket arrays, keeping your traffic completely hidden from external monitoring. 📜 2. Dynamic DOM and JS Rewriting
Loading an entire webpage via proxy without breaking dynamic scripts (like React or Vue) is famously difficult. Scramjet solves this by injecting an advanced JavaScript rewriter. Every script, iframe, and stylesheet is rewritten dynamically in the browser, tricking the loaded page into thinking it is running on its native domain. 🗃️ 3. Client-Side Sandboxing
Scramjet enforces isolated sandboxing for arbitrary web content. This means that tracking cookies, local storage attacks, and malicious scripts are contained strictly within the Scramjet ecosystem, protecting your actual host browser from external threats. ⚖️ Scramjet vs. Ultraviolet: The Proxy Evolution
For a long time, the open-source community relied on "Ultraviolet" as the gold standard for web proxy bypassing. However, Scramjet has stepped in to drastically push the needle forward. Scramjet Browser Proxy Traditional Proxies (Ultraviolet) Code Base Highly optimized TypeScript Older, heavier JavaScript CAPTCHA Support Advanced native support Highly limited / Breaks easily Speed Minimized server latency Heavy server load Developer Friendly Modular middleware Monolithic structure
Because it operates at maximum efficiency, developers have successfully adapted it into deployment apps like the official Scramjet App or standalone cloud operations. 💼 Primary Use Cases for Scramjet
Scramjet fits a variety of niches, solving problems across cybersecurity, software development, and digital freedom.
Bypassing Restrictive Networks: Millions of users in heavily censored regions or strict environments rely on Scramjet to surf the web freely.
Debugging and Instrumentation: Because Scramjet can stop and inspect any packet moving through it, security researchers use it to debug complex web applications in real-time. In less than 15 lines
Web Scraping: Headless developers utilize Scramjet's interception capabilities to extract complex data without getting blocked by typical anti-bot systems. 🌐 The Future: Scramjet in the Cloud
While Scramjet began purely as a browser web-proxy project, its architecture perfectly mirrors the demands of modern edge computing. By running code execution as close to the data as possible, Scramjet-inspired data frameworks simplify heavy data pipelines. Whether it is for lightweight IoT devices or massive server clusters, Scramjet technologies are setting the standard for the next generation of web processing.
Scramjet is a versatile web proxy designed to bypass ... - GitHub
1. True Multi-threading (Clusters)
JavaScript is famously single-threaded. The Scramjet Browser ignores this limitation by leveraging native Node.js worker_threads and clusters automatically. Your scramjet program will, by default, spread the load across every available CPU core without a single line of parallelization code.
The Problem with Legacy Browsers (Status Quo)
Modern browsers—even speedy ones like Chrome, Edge, or Brave—follow a similar request-response model:
- User types URL or clicks link.
- Browser does DNS lookup.
- TCP/TLS handshake (if HTTPS).
- HTTP request sent.
- Server responds with HTML.
- Browser parses HTML, discovers CSS/JS.
- Downloads, parses, executes, and finally paints.
Even with HTTP/2, caching, and service workers, the average mobile page takes over 15 seconds to become interactive. The problem isn’t bandwidth; it’s latency and architecture. Browsers are reactive, not proactive.
A Scramjet browser solves this by turning the model inside out.
1. Cloud-Native Architecture
Unlike Puppeteer, which assumes you have a local Chrome installation, Scramjet runs entirely in the cloud. You don't manage processes, kill hung tabs, or worry about memory leaks. You simply call an API.
4. Built-in Stealth & Fingerprinting Management
Because the browser is managed by the platform, it can automatically rotate user agents, manage proxies, and mitigate fingerprinting. This is crucial for e-commerce monitoring, SEO tracking, or ad verification.
3. Ad Verification
Advertisers need to ensure their ads appear correctly on publisher sites. Scramjet can spawn a browser in a specific geographic region, load a page, take a screenshot of the ad placement, and verify the DOM—all in under 2 seconds.
Getting Started: Your First Scramjet "Tab"
Let’s break the myth that data engineering is hard. Installing the Scramjet framework is as easy as installing any Node package. You don't even need a browser window open.
npm install @scramjet/types @scramjet/core
Here is a practical example. Imagine you want to fetch all images from a site. In standard JS, you'd use callbacks or Promises. In Scramjet, you use Streams:
const Host = require('@scramjet/core');// Create a Scramjet "Browser" instance (the Host) const host = new Host();
async function main() // The "from()" method starts a stream of data await host .from([1, 2, 3, 4, 5]) // Simulate 5 pages .map(page =>
https://example.com/page/$page) // Build URLs .flatMap(async (url) => fetch(url).then(res => res.text())) // Fetch HTML .map(html => html.match(/<img src="(.*?)"/g)) // Regex images .filter(Boolean) // Remove empty results .reduce((acc, images) => [...acc, ...images], []) // Combine .toArray() // Wait for result .then(console.log); // Output all image URLs
main();
In less than 15 lines, you have a concurrent, memory-safe, multi-threaded web scraper. Try doing that with vanilla axios without hitting memory limits.