@titaniumnetwork-dev/ultraviolet

Ultraviolet

A highly advanced web proxy used for evading internet censorship or accessing websites in a controlled sandbox with security and performance in mind.

Ultraviolet works by intercepting HTTP requests with a service worker script that follows the TompHTTP specifications and is the lead for innovative web proxy technologies.

Features

• 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
• Bare server load balancing and performance significantly increased
• Improved resource usage and speed (allows for improved setups with seperation of the bare server on a dedicated instance)

Supported Sites

• Google Services
• CAPTCHA/hCAPTCHA
• Youtube
• Spotify
• Discord
• Reddit
• GeForce NOW
• now.gg
• All static sites
• And more!

--

See the changelog if you're using v1.0.1 or above!

Documentation

Documentation can be found in the wiki.

How do I deploy/run this?

This repository is the bare-bones of Ultraviolet. This only contains the source code required to compile uv. scripts.

See Ultraviolet-Node for easy instructions to deploy an Ultraviolet website.

An example of REALLY using this (API, copying files, etc) is in Ultraviolet-Static. See scripts/build.js.

I don't care about building, where are the scripts for my website?!

You can extract the scripts from the NPM package in the releases section. All the scripts you would typically look for (uv.bundle.js, uv.handler.js, uv.sw.js, and uv.config.js) are found within the dist directory.

If you cannot open the tar.gz (Chrome OS?), use a converter. We can only do so much to make the scripts accessible.

How do I install this?

This will provide built files and the JS API to access the path of dist files.

Currently, we don't have an NPM package. As a current solution, you can install from a GitHub release. Copy the link to the .tgz and install using NPM.

$ npm install https://github.com/titaniumnetwork-dev/Ultraviolet/releases/download/v1.0.1/ultraviolet-1.0.1.tgz

How do I build this?

1. Clone the repository

$ git clone https://github.com/titaniumnetwork-dev/Ultraviolet.git
> Cloning into Ultraviolet...
$ cd Ultraviolet

1. Install dependencies

$ npm install

1. Produce the dist/ directory and compile scripts

$ npm run build

Packaging

This is intended for releasing on hosting the package as a file, not on NPM.

$ npm pack

Package will be named ultraviolet-X.X.X.tgz

Changelog

v1.0.4

• This version of Ultraviolet introduces support for passing a list of Bare servers in the uv.config.js file. This allows users to specify multiple servers that the service worker can choose from, improving reliability and failover.
• Minor bug fixes (caught with ESLint) and improvements.
• The @tomphttp/bare-client package has been implemented, allowing users to use Ultraviolet with Bare server V2 and older versions of the Bare server.
• In previous versions, the uv.client.js script was bundled with uv.bundle.js. In this version, uv.client.js is separate and needs to be included separately in any workflows that use it.