Thanks to visit codestin.com
Credit goes to github.com

Skip to content

tenclips/ethereal

ethereal.

/iˈTHirēəl/
/uh-thee-ree-uhl/

a sleek proxy with speed, design, and usability in mind. easy to deploy to any static host.

Netlify Build Status

table of contents

  • about
    • features
    • proxy support
    • customisation
    • roadmap
    • bug reporting
    • security reporting
  • faq
  • deployment
    • static hosts
      • deployment buttons
      • firebase instructions
      • github pages instructions
    • local deployment
    • development
  • credits

about

features

  • ultraviolet
  • super fast speeds
  • tab title cloaking
  • icon cloaking
  • about:blank cloaking
  • server selection
  • theming
  • super customisable
  • support for popular sites
  • support for emulators

(back to the top)

proxy support

  • easyfun.gg (now.gg alternative)
  • youtube/tiktok
  • github
  • geforce now (partial)
  • emulatorjs
  • vscode
  • discord/guilded
  • google services
  • lots of other websites

(back to the top)

customisation

a lot of things can be customised on this website, including the following

  • favicon
  • tab title
  • colors
  • wisp server
  • bare server
  • wisp or bare (toggle)
  • panic link
  • panic keybind
  • adblock (on/off)

(back to the top)

roadmap

  1. add tabbing
  2. add bookmarks
  3. add scramjet support
  4. add auto cloaking
  5. add support via netlify (on-site form)
  6. get a domain (e.g. ethereal.net)

more will be added soon.

(back to the top)

reporting bugs

if you found a bug on the website, report it to us using the issues page. we have bug templates, so we request you use those. if your issue is not equipped with necessary info or is not clear (e.g. 'the website isnt working'), we will ignore it.

going the extra mile? open a pr if you have a patch for the bug. truly appreciated + you will be credited.

(back to the top)

reporting security issues

same thing as above

(back to the top)

faq

q: what do i do if it fails to load?

a: hard refresh (ctrl/cmd + shift + r) and try again. if the issue persists, please report it.

q: why doesn't this work on windows?

a: this is discussed in local deployment. it's because the build scripts only work on linux for some reason.

q: why is it so slow?

a: depends on your network and traffic. if lots of people are proxying things or your network is slow, it will take lots of time to load.

q: why do none of your websites work?

a: if you are using a site such as easyfun.gg, and it isn't working, that isn't our problem. go report it to them instead.

q: why won't cloudflare turnstile load?

a: it thinks you are a bot.

q: why is youtube blocking me?

a: it thinks you are a bot.

q: why can't i watch full youtube videos? this sucks.

a: this is because youtube still thinks you are a bot.

*this is a live document and is subject to change

(back to the top)

deployment

static hosts

you can deploy to any static host basically, including the following

  • vercel (not recommended, some sites will break)
  • cloudflare pages
  • netlify (recommended)
  • firebase
  • github pages (not recommended, some sites will break)

you could also use the dedicated buttons below for deployments

Deploy with Vercel Deploy to Netlify

Deploy to Cloudflare

if you don't know how to deploy to firebase or github pages, follow the guides below.

firebase hosting

first, clone the repo by running

git clone https://github.com/tenclips/ethereal

then install fb tools

pnpm i -g firebase-tools

now initialize a project with hosting (be sure to change project name in .firebaserc)

firebase init hosting

follow the steps in the cli setup and finally deploy

firebase deploy

github pages

first, either fork or clone this repo

git clone https://github.com/tenclips/ethereal

if you cloned, initialize a repo on github by uploading it or using the initialize button in vscode source control.

now go to your repo page > settings > pages

there is a dropdown where you can select the deployment folder. select dist.

then hit deploy.

wait and you're done.

(back to the top)

local deployment

Caution

building with vite will fail 11 times out of 10 on windows systems. if you are locally deploying this, we strongly recommend using a unix based environment or an ide with a unix based environment (e.g. firebase studio, formerly project idx)

first, clone the repository by running this command

git clone https://github.com/tenclips/ethereal
cd ethereal

then install the dependencies using your package manager of choice

pnpm i

now build the files

pnpm run build

and finally run a server

pnpm start

(back to the top)

development

now if you're tryna develop for this program, the process is similar

install the dependencies using your package manager

pnpm i

build the files

pnpm run build

and finally start a server

pnpm dev

(back to the top)

credits

made with <3 by x8r

thanks to corn unblocked and zeroxoneafour for making ultraviolet completely static

thank you to titanium network and mercury workshop for ultraviolet, scramjet (support soon!), libcurl, epoxy, wisp, and more.

and thank you to all the contributors.

(back to the top)

alr have a nice day