Aether-GUI is a one-click desktop GUI for the Aether censorship-circumvention tunnel, wrapping its terminal tool in an animated, easy-to-use app that automates connection and setup.

Stars

802

7-day growth

No data

Forks

36

Open issues

8

License

AGPL-3.0

Last updated

2026-07-25

AI repository intelligence
FR-AI / ANALYSIS

Why it is worth attention

It makes a powerful but complex CLI censorship-bypass tool accessible to non-technical users with a single button, while still offering advanced options for those who want control.

Who it is for

  • Users in heavily restricted networks needing internet access
  • Privacy-conscious individuals who prefer GUI over CLI
  • Developers or researchers evaluating censorship-circumvention tools
  • System administrators managing secure tunnels for users

Use cases

  • Bypassing internet censorship and accessing blocked websites
  • Establishing encrypted tunnels for secure communication
  • Testing different circumvention protocols and scan modes
  • Providing a simple, configurable VPN-like experience on Windows

Strengths

  • Auto mode requires no configuration; just press Connect
  • Live progress with elapsed time, percentage, and progress bar during route discovery
  • Automatic reconnection with backoff and visible retry count for dropped tunnels
  • Lightweight and performant: animations freeze when window is unfocused

Considerations

  • Windows x64 only; no macOS or Linux installer provided
  • Depends on the external Aether binary, which must be fetched separately (or manually on Windows)
  • No mobile support or cross-platform builds for other architectures

README quick start

Aether-GUI

English · فارسی

A one-click desktop GUI for Aether, a censorship-circumvention tunnel built for heavily restricted networks. Aether itself is a terminal tool: it discovers a working route out, establishes an encrypted tunnel, and exposes a local SOCKS5 proxy. Aether-GUI wraps that terminal tool in a small, animated desktop app so you don't have to touch a command line to use it — press Connect, and everything else (identity provisioning, route discovery, prompt answering) happens automatically in the background.

This project does not reimplement any of Aether's tunneling logic. It drives the real aether binary in a pseudo-terminal, answers its interactive setup prompts on your behalf, and watches its output to tell you what's happening. All the actual censorship-circumvention work — MASQUE/QUIC obfuscation, WireGuard, route probing — is Aether's, not this repo's.

Features

  • Auto mode — the default screen is just a single button. No configuration is required; it connects using your last-successful settings (or sensible defaults on first run).

  • Advanced panel — for when you want control, a collapsible panel exposes the real options Aether's setup supports:

    • Protocol: MASQUE (disguises traffic as normal HTTPS), WireGuard (lighter, faster), or WARP-in-WARP/gool (two nested WireGuard tunnels for extra security at a speed cost)
    • Scan Mode: Turbo, Balanced, Thorough, Stealth, or Ironclad — trading route-discovery speed against how much probe traffic it generates; Ironclad opens a real tunnel through each candidate and sends a real HTTP request before trusting it (slowest, but guaranteed working)
    • IP Version: IPv4, IPv6, or both
    • MASQUE Transport: HTTP/3 (QUIC — fastest handshake) or HTTP/2 (TCP — looks like ordinary HTTPS, works where UDP is blocked or throttled)
    • Obfuscation: how heavily the handshake is disguised from DPI — profiles adapt to the selected protocol; escalate if the default can't get through
    • Quick reconnect: remember the last working gateway and re-test it first, skipping the full scan when it still works

    Each option has an explanation on hover.

  • Live progress — while Aether searches

Description

One-click desktop GUI for the Aether censorship-circumvention tunnel — Tauri v2, React 19, Rust

Related repositories

Similar projects matched by category, topics, and programming language.

NUber-dev
Featured
NUber-dev GitHub avatar

YTubic

YTubic is a fast, responsive, open-source YouTube Music desktop client for Windows, Linux, and macOS that uses direct InnerTube API communication and aggressive caching to provide instant navigation and playback.

Web DevelopmentFrontend Frameworks
226
TanStack
Featured
TanStack GitHub avatar

router

TanStack Router is a type-safe, data-driven React router with built-in caching, prefetching, and nested layouts, while TanStack Start extends it into a full-stack SSR framework.

Web DevelopmentFrontend Frameworks
14,861
makecindy
Featured
makecindy GitHub avatar

cindy

Cindy is an open-source AI agent that runs locally on your machine, integrates multiple AI harnesses and models, and provides memory, skills, and automation to perform real work in your projects and apps.

AI & Machine LearningLarge Language Models
958