gitwtfhub

wtf is aethery?

zethrise/aethery — explained in plain English

Analysis updated 2026-05-18

232KotlinAudience · generalComplexity · 4/5LicenseSetup · moderate

TL;DR

Aethery is a native Android app that wraps the Aether censorship-circumvention network core, adding a VPN or SOCKS5 proxy interface with MASQUE, WireGuard, and WARP-on-WARP protocol support.

Mindmap

mindmap
  root((Aethery))
    What it does
      Android UI for Aether core
      VPN or SOCKS5 proxy modes
      Live connection logs
    Tech stack
      Kotlin
      Rust
      Android
      WireGuard
    Use cases
      Circumvent network censorship
      Route apps via local proxy
      Build custom Android APKs
    Audience
      Privacy-focused mobile users

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

Why would anyone build with this?

REASON 1

Connect to the Aether network on Android through a full-device VPN tunnel or a local SOCKS5 proxy for specific apps.

REASON 2

Switch between MASQUE, WireGuard, and WARP-on-WARP transport protocols depending on which one a network allows through.

REASON 3

Build the Android app from source, including compiling the bundled Rust core, for custom or debug builds.

What's in the stack?

KotlinRustAndroidWireGuard

How it stacks up

zethrise/aetheryskydoves/compose-nav-graphtrooped/quickbars
Stars232228289
LanguageKotlinKotlinKotlin
Setup difficultymoderateeasy
Complexity4/52/5
Audiencegeneraldevelopergeneral

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

How do you spin it up?

Difficulty · moderate Time to first run · 5min

Prebuilt APKs install in minutes, building from source requires Android Studio, a specific NDK/CMake version, and a Rust Android toolchain.

GNU AGPL-3.0: you can use and modify the app, but if you distribute a modified version or run it as a network service, you must release your source code too.

Wtf does this do

Aethery is an Android app that gives people a native mobile interface for the Aether network core, a separate open source project focused on private, censorship resistant connections. Aethery itself is not a networking engine. It handles the Android side, things like the app interface, the VPN and TUN system integration, connection state, a protocol picker, and live connection logs, while the actual work of finding routes, establishing tunnels, and encrypting traffic is done by the Aether core underneath it. Inside the app, a user can choose between two connection types. VPN mode routes all of the device's traffic through Android's built in VPN service, while Proxy mode exposes a local SOCKS5 proxy that other apps can be configured to use individually. Aethery supports several transport protocols through the Aether core, including MASQUE over HTTP/3 as the recommended default with an HTTP/2 fallback, WireGuard where it is reachable, and a nested WireGuard mode called WARP-on-WARP. The app also does automatic endpoint scanning with diagnostics and reconnects to a cached working gateway when needed. The README is upfront that network filtering varies by internet provider and location, and that a protocol showing as connected only means Aethery's own readiness check passed, not that every destination will actually be reachable. Prebuilt APKs for 64 bit and 32 bit ARM devices are published on the project's GitHub Releases page. Building it from source requires Android Studio, a specific Android NDK and CMake version, JDK 17, and a Rust toolchain with Android targets added, since part of the app is a compiled Rust library bridged in through JNI. The project is licensed under the GNU AGPL-3.0 license, while the underlying Aether core and its dependencies keep their own separate license terms.

Yoink these prompts

Prompt 1
Explain the difference between Aethery's VPN mode and Proxy mode and when I'd use each.
Prompt 2
Walk me through building Aethery from source, including the Rust and NDK setup it needs.
Prompt 3
What is WARP-on-WARP in Aethery and why does it still need a reachable outer WireGuard path?
Prompt 4
Summarize how Aethery and the separate Aether core divide responsibilities in this project.

Frequently asked questions

wtf is aethery?

Aethery is a native Android app that wraps the Aether censorship-circumvention network core, adding a VPN or SOCKS5 proxy interface with MASQUE, WireGuard, and WARP-on-WARP protocol support.

What language is aethery written in?

Mainly Kotlin. The stack also includes Kotlin, Rust, Android.

What license does aethery use?

GNU AGPL-3.0: you can use and modify the app, but if you distribute a modified version or run it as a network service, you must release your source code too.

How hard is aethery to set up?

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

Who is aethery for?

Mainly general.

View the repo → Decode another repo

This repo across BitVibe Labs

Don't trust strangers blindly. Verify against the repo.