Orbit Easytier For Android

---

A polished Android client for EasyTier — secure, P2P mesh VPN, rebuilt from the ground up with a modern UI.

While the official EasyTier already has an Android build (supports Android 7.0+ / API 24+), Orbit extends one version further to Android 6.0 (API 23) and ships a richer native experience with Material3 design, multi-profile configuration, and real-time peer visualization.

Feature	Official Android	Orbit
Minimum Android	7.0+ (API 24)	6.0+ (API 23)
UI Framework	System default	Material3 (Jetpack Compose)
Theme	N/A	Purple gradient, light/dark
Configuration UI	Basic	Full editor with TOML support
P2P status indicator	Text only	Green tag + visual distinction
Real-time dashboard	—	Speed, latency, peers, logs

---

Features

• 📱 Android 6.0 ~ 15 — full backward compatibility, tested on devices from 2015 to 2025
• 🎨 Material3 purple gradient — light and dark themes, smooth animations
• 🛡️ VPNService based — uses Android's VpnService with tun2io virtual interface
• 🔒 Encrypted P2P mesh — NAT traversal, relay fallback, end-to-end encryption
• 🟢 P2P / relay detection — real-time green tag for P2P connections
• 📊 Live status — IP, latency, bandwidth, uptime at a glance
• 📝 On-device log viewer — scrollable, pausable, shareable
• 🔄 Background persistence — stays connected after app is closed (foreground service)
• 🔋 Battery optimization exclusion — exempt from Android Doze mode
• 🚨 VPN conflict detection — auto-detects other active VPNs
• 🌐 Bilingual (Chinese / English) — follows system locale
• 📋 Multi-profile config management — import, export, edit, switch

---

Screenshots

Light mode	Dark mode	Peers panel
Purple gradient Clean layout	Night-friendly Deep purple background	Green P2P tag Latency & type

Config editor	Log viewer	About
Transparent inputs TOML editing	Real-time scrolling Shareable	Version, uptime Build info

---

Architecture

orbit/
├── src/main/java/com/easytier/
│   ├── MainActivity.kt           # Main entry point
│   ├── ConfigEditActivity.kt     # TOML configuration editor
│   ├── NotificationHelper.kt     # Foreground service notification
│   ├── AppLogger.kt              # Ring-buffer log (memory safe)
│   ├── jni/
│   │   ├── EasyTierManager.kt    # Singleton lifecycle manager
│   │   └── EasyTierJNI.kt        # Rust JNI bridge
│   ├── vpn/
│   │   └── EasyTierVpnService.kt # VpnService with auto-reconnect
│   └── ui/
│       ├── AppText.kt            # Localized strings
│       ├── MainScreen.kt         # Compose main screen
│       ├── ConfigForm.kt         # Config form components
│       ├── ConfigState.kt        # Local config persistence
│       ├── ConnectionButton.kt   # Start/stop button with animation
│       ├── PeerInfoSection.kt    # P2P peer panel with status tags
│       └── theme/                # Purple gradient Material3 theme

Tech Stack

Layer	Technology
UI	Jetpack Compose + Material3
Theme	Custom purple gradient
VPN	VpnService.Builder + tun2io
Core	EasyTier Rust via JNI (libeasytier_jni.so)
Notifications	NotificationCompat + foreground service
Build	Gradle + Android SDK 34 + Kotlin

---

Building from source

git clone https://github.com/amelia4angela/orbit-easytier-android.git
cd orbit-easytier-android
./gradlew :orbit:assembleRelease

APK output: orbit/build/outputs/apk/release/EasyTier-Android-v*.apk

Prerequisites: Android SDK 34, NDK (or use prebuilt jniLibs), Java 17+

---

Download

⬇️ Download APK (latest release)

---

Changelog

v0.1.4

• 🐛 Config persistence fix — last_config_name now saved on every config load, preventing config loss on app restart
• 🔄 Coroutine-based polling — migrated from Handler+Runnable to lifecycleScope coroutines, eliminating main thread blocking (~200-500ms per JNI call)
• 🧹 TOML builder refactored — extracted shared ConfigState↔JSON↔TOML logic into TomlUtils, removed ~73 lines of duplicated code across two activities
• 🛡️ Code quality fixes — fixed credential exposure in defaults, socks5 TOML quoting, API 30 guard for external storage, log dialog coroutine leak, unbounded prevPeerStats growth
• ⚡ Faster UI updates — increased poll frequency from 1s to 500ms for more responsive latency/peer display

v0.1.3

• 🎨 UI polish — layout adjustments for small screens, transparent input backgrounds, shorter action labels
• 🐛 Bug fixes — ConfigEditActivity fields now correctly sync to buildTomlConfig and mgr.start() args
• 📝 Better logging — enhanced log detail for connection lifecycle

v0.1.2

• 🟢 P2P green tag — peers are now visually distinguished by connection type
• 🚫 Removed (via relay) suffix from labels
• 🐛 Fixed latency unit conversion (μs → ms)
• 🎯 Improved P2P / relay detection accuracy
• ⏱️ Always poll every second

v0.1.0

• 🎉 Initial release
• 🎨 Material3 purple gradient theme (light/dark)
• 📱 Android 6+ support
• 🌐 Bilingual UI (Chinese / English)
• 🦀 Rust JNI core engine
• 📡 P2P mesh networking + NAT traversal + encryption
• 📋 Multi-profile configuration management
• 📊 Real-time peer dashboard
• 🔔 Notification bar with live status
• 🔄 Background keep-alive (foreground service)
• 🔋 Battery optimization exclusion
• 🚨 VPN conflict detection

---

友情链接

Project	Description
Moonlight V+	增强版 Moonlight 游戏串流客户端
Sunshine 基地版	增强版 Sunshine 游戏串流服务端
EasyTier	轻量级 P2P Mesh VPN（本项目底层引擎）

License

Apache 2.0

---

Acknowledgements

Built on top of EasyTier — a lightweight, cross-platform P2P mesh VPN written in Rust. The core networking engine (NAT traversal, encryption, virtual interface) is entirely theirs; this project wraps it in a native Android UI.