Advanced web proxy used for evading internet censorship or accessing websites in a controlled sandbox.

Ultraviolet works by intercepting HTTP requests with a service worker script that follows the [TompHTTP](https://github.com/tomphttp) specifications

• CAPTCHA support along with hCAPTCHA support
• URL encoding settings to further hide activity when using Ultraviolet
• Configuration all done on the client-side via service-workers
• Speed in comparison to other web proxies that fully proxy content
• Blacklist setting and more for easy hosting
• Security in mind and leak prevention
• Frequent updates to improve site support or fix security issues

• Youtube
• CAPTCHA/hCAPTCHA
• Spotify
• Discord
• Reddit
• GeForce NOW (Partially Supported)
• And more!

• Service Workers
• HTML, JS, CSS rewriting
• Parse5
• Acorn.js

• Incognito, a popular web proxy service with focus on privacy
• Holy-Unblocker, a popular web proxy service focusing on bypassing web filters and more
• Hypertabs, a web proxy service using a PWA browser as its frontend

• Installation And Setup
• Basic Guide
• Replit Setup Guide
• Comprehensive Guide
• Configuration
• Frontend
• Core Scripts

Installation of Ultraviolet is simple. You can find a Tl;DR of the installation and setup process just below. If you are unfamiliar with the "standard" installation process, look a bit farther down for a more comprehensive installation and setup guide.

$ git clone https://github.com/titaniumnetwork-dev/Ultraviolet-Node --recursive
$ cd Ultraviolet-Node
$ npm install
$ npm start

To setup on Replit, first click on the "Run on Replit" button. After loading into your repl, run the following commands:

$ npm install
$ chmod +x main.sh
$ ./main.sh

You will only have to run the second command once. It just allows main.sh to be executed. By running main.sh, you will update any submodules and will start the app.

Note: If you choose not to use main.sh, but would rather just run all commands manually, please note that you will have to manually install submodules by running git update submodules --init. Without it, static will not be installed, and that is a required directory.

Below will describe a comprehensive guide to install Ultraviolet on Linux machines.

To clone the repository, simply run the following command:

$ git clone https://github.com/titaniumnetwork-dev/Ultraviolet-Node --recursive

The --recursive flag will clone the repository and all submodules.

To begin work on the actual setup, cd into the repository. You can do so by running the following command:

$ cd Ultraviolet-Node

From here, you can update your submodules and install your dependencies. To do so, run the following command:

$ npm install

Finally, to start Ultraviolet, run the following command:

$ npm start

You can then find Ultraviolet on http://127.0.0.1:8080. If you would like to change the port UV will be running on, edit the last line in index.mjs.

Please note that UV will not function without HTTPS. If you are hosting on Replit or Heroku, this won't be a problem as they provide you with SSL/TLS by default and will automatically apply it to your instance, however if you are attempting to host UV on a different platform, such as a personal server, you WILL need to use HTTPS.

Configuring Ultraviolet is very simple. Simple descriptions of each configurable option are provided as a comment in the block below. More detailed documentation can be found just below mentioned block.

uv.config.js

self.__uv$config = {
    prefix: '/sw/', // Proxy url prefix
    bare: '/bare/', // Bare server location
    encodeUrl: Ultraviolet.codec.xor.encode, // URL Encoding function
    decodeUrl: Ultraviolet.codec.xor.decode, // Decode URL function
    handler: '/uv.handler.js', // Handler script
    bundle: '/uv.bundle.js', // Bundled script
    config: '/uv.config.js', // Configuration script
    sw: '/uv.sw.js', // Service Worker Script
};

Static files is the frontend for Ultraviolet. A standalone repository for it can be found here.

location / {
	proxy_busy_buffers_size  512k;
	proxy_buffers  4 512k;
	proxy_buffer_size  256k;
 	proxy_pass http://localhost:8080;
	proxy_http_version 1.1;
	proxy_set_header Upgrade $http_upgrade;
	proxy_set_header Connection 'Upgrade';
    	proxy_set_header X-Real-IP $remote_addr;
    	proxy_set_header X-Forwarded-Host $host:$server_port;
    	proxy_set_header X-Forwarded-Server $host;
	proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
	proxy_set_header Host $host;
}

Configuration mentions a few scripts that make up Ultraviolet. To get documentation for what each of the scripts do, check out the documentation for them in their standalone repository.

The client-hooking & service worker scripts required for UV are located in ultraviolet-scripts

• Scripts
  • uv.sw.js Service worker gateway
  • uv.sw-handler.js - Service worker handler
  • uv.bundle.js Webpack compiled Ultraviolet rewriter
  • uv.handler.js Client-side hooking
  • uv.config.js Configuration

• Caracal.js (Creator of Ultraviolet)
• Divide (Creator of TOMP)

• https://github.com/tomphttp