Subscription import · Smart routing · Mihomo core · No accounts needed
Anneal is an Android VPN client powered by the Mihomo proxy core. Import a subscription link or a config file, tap Connect — that's it. No sign-ups, no telemetry, no extra services required.
Works with any proxy subscription in standard formats (Clash/Mihomo YAML, share links).
| 🔒 One-tap connect | Connect and disconnect with a single button |
| 📦 Subscription import | Paste a URL or load a file from your device |
| ⚡ Smart routing | Local networks bypass the proxy; everything else goes through VPN |
| 📊 Traffic stats | Live sent / received counters per session |
| 🌐 Proxy list | Browse and ping all proxies from your subscription |
| 🌍 Localization | English and Russian out of the box |
| Module | Purpose |
|---|---|
app |
Android application — UI, VPN service, subscription handling |
core |
Native Mihomo integration (JNI / shared library) |
service |
VPN background service and traffic metering |
local |
Local configuration and state (not committed) |
- Android Studio Hedgehog or newer
- JDK 17+
- Android SDK, build-tools installed via SDK Manager
git clone https://github.com/Anneal-Team/Anneal-App.git
cd Anneal-AppOpen the project in Android Studio and let Gradle sync. The Mihomo native core is pulled automatically during the build.
| Variant | Description |
|---|---|
debug |
Local development build |
release |
Optimized build, requires a signing keystore |
To build a debug APK from the command line:
./gradlew assembleDebugAnneal App works standalone with any Clash-compatible subscription. If you run Anneal Panel — the self-hosted subscription server — grab the subscription link from the panel and paste it into the app.
Bug reports, feature ideas, and PRs are welcome. For anything beyond a small fix, open an issue first so we can align before you write the code.
Note: The project is in active development — keep PRs focused and tested.
GNU Affero General Public License v3.0 — free to use, modify, and distribute under the same license. If you run a modified version as a network service, you must publish your source changes.