whatisgithub

What is aether-gui?

matinsenpai/aether-gui — explained in plain English

Analysis updated 2026-05-18

719TypeScriptAudience · generalComplexity · 3/5LicenseSetup · easy

In one sentence

A one click desktop app that wraps the Aether censorship circumvention tunnel so people on restricted networks do not need a terminal.

Mindmap

mindmap
  root((Aether-GUI))
    What it does
      Wraps Aether tunnel tool
      One click connect
      Automatic setup and prompts
    Tech stack
      React and TypeScript frontend
      Rust backend
      Tauri desktop shell
    Use cases
      Restricted network access
      Advanced protocol control
      Automatic reconnect
    Setup
      Windows installer available
      Build from source elsewhere

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Connect to a censorship circumvention tunnel with a single click instead of using a terminal.

USE CASE 2

Choose an advanced protocol, scan mode, and obfuscation level for a more technical connection setup.

USE CASE 3

Automatically reconnect a dropped tunnel with a visible retry counter instead of failing silently.

What is it built with?

TypeScriptReactRustTauri

How does it compare?

matinsenpai/aether-guiaffaan-m/agentshieldindalok/rzweb
Stars719719723
LanguageTypeScriptTypeScriptTypeScript
Setup difficultyeasyeasyeasy
Complexity3/53/53/5
Audiencegeneraldeveloperdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · easy Time to first run · 5min

Windows installer is provided directly, building on macOS or Linux requires Node.js, Rust, and Tauri's platform prerequisites.

Licensed under the GNU AGPL v3, a copyleft license requiring modified versions, including those run as a network service, to share their source code.

So what is it?

Aether-GUI is a desktop application that wraps a separate command line tool called Aether, which is a censorship circumvention tunnel designed for heavily restricted networks. Aether itself finds a working route out of a blocked network, sets up an encrypted tunnel, and exposes a local proxy that other apps can use, but it only runs from a terminal. Aether-GUI puts a small animated desktop window in front of that tool so a person can just press Connect and let route discovery, setup prompts, and identity provisioning happen automatically in the background, without ever typing a command. Importantly, this project does not rebuild any of the actual tunneling logic. It runs the real Aether program in the background, answers its interactive setup questions on the user's behalf, and reads its output to show progress on screen. All of the real censorship circumvention work, including the traffic obfuscation and route probing, comes from the separate Aether project, not from this GUI. The default screen is a single button that reconnects using the last successful settings, but an advanced panel lets a more technical user choose the underlying protocol, how thoroughly to scan for a working route, which IP version to use, which transport style to disguise traffic as, and how heavily to hide the connection from network inspection. While it searches for a route the app shows a real progress bar once Aether reports its scan budget, and if the tunnel drops unexpectedly it automatically retries a limited number of times with a visible counter rather than failing silently. The app is built with Tauri, using a React and TypeScript frontend and a Rust backend that spawns the real Aether program inside a genuine pseudo terminal and passes the chosen settings as command line flags. It confirms a successful connection by actually testing that the local proxy port is reachable, rather than trusting log text alone. Right now only a Windows installer is provided, though the source can be built on macOS and Linux as well. It is released under the GNU Affero General Public License version 3.

Copy-paste prompts

Prompt 1
Explain what each advanced option in Aether-GUI, like scan mode and MASQUE transport, actually controls.
Prompt 2
Help me build Aether-GUI from source on macOS, including fetching the Aether binary.
Prompt 3
Walk me through how this app confirms a tunnel is actually connected instead of just trusting log output.
Prompt 4
Explain the difference between what Aether-GUI does and what the underlying Aether tool does.

Frequently asked questions

What is aether-gui?

A one click desktop app that wraps the Aether censorship circumvention tunnel so people on restricted networks do not need a terminal.

What language is aether-gui written in?

Mainly TypeScript. The stack also includes TypeScript, React, Rust.

What license does aether-gui use?

Licensed under the GNU AGPL v3, a copyleft license requiring modified versions, including those run as a network service, to share their source code.

How hard is aether-gui to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is aether-gui for?

Mainly general.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.