ClashFest is an Android client in the Clash Meta / Mihomo family with a redesigned Home experience, cleaner subscription/node flows, routing-focused tools, and practical safety defaults for everyday use.
Status: work in progress · Active branch:
feat/init-clashfest
| Area | What you get |
|---|---|
| Home | Active node card, compact subscription actions, circular tab swipe, import from URL / QR / clipboard |
| Modes | Rule / Global quick switch from Home |
| Rules & routing | Dedicated Routing hub, rule snippets, effective rules, app routing (per‑app VPN policy) |
| Network | DNS / VPN options, security-oriented toggles where we wire them |
| Features | Safe “every‑day” toggles (unified delay, geodata mode, TCP concurrent) + entry to Geo Data Source |
| Geo Data Source | Presets for geox-url mirrors (same upstream data, different CDN paths), custom URLs, on-device geo DB import |
| Subscriptions | HTTP(S) / content: profiles; mierus:// shares parsed via the same pipeline as other URL imports |
| Quick start | Quick Settings tile flow with VPN permission handling and one-tap startup |
| Connections | Live connections view with resilient snapshot decoding and lower polling load |
| App | Dark mode, optional UI language (system / EN / RU / ZH), notification & recents options |
| Look | Material 3 dark-first direction with refreshed ClashFest branding |
- Stability and regression-free releases on top of the redesigned Home
- Routing and profile management polish without breaking upstream compatibility
- Performance and battery optimizations in high-refresh screens
- Localization quality (EN / RU / ZH first, others incremental)
- Post-release cleanup of medium-risk technical debt
| Module | Role |
|---|---|
app/ |
Activities, navigation, packaging |
common/ |
Shared helpers (imports, naming, ping helpers, …) |
core/ |
JNI bridge, native Mihomo integration |
design/ |
UI, themes, layouts, preference screens |
service/ |
VPN service, profiles, rule merge / Geo presets |
- Android Studio (or compatible IDE)
- Android SDK + NDK as required by the project
- JDK matching the Gradle toolchain (see project / CI notes)
- Gradle wrapper (included)
Linux / macOS
./gradlew assembleAlphaDebugWindows
.\gradlew.bat assembleAlphaDebug- App shield:
app/src/main/res/drawable-nodpi/clashfest_shield.png - Optional:
branding/— source art ·docs/— screenshots & notes
Licensed under the GNU General Public License v3.0. See LICENSE and NOTICE.
ClashFest is provided as-is, without warranty. Use it responsibly and in compliance with local law, provider terms, and upstream licenses.
Right now development is focused on the ClashFest fork and branch workflow; contribution guidelines may expand later.
ClashFest builds on the open Clash / Meta stack. If you use or ship derivatives, keep copyright and license notices intact.
If ClashFest is useful for you, consider giving the project a star ⭐
| Project | What it is | Link |
|---|---|---|
| Clash Meta for Android | Upstream Android client this tree forked from | MetaCubeX/ClashMetaForAndroid |
| mihomo | Clash.Meta core (Go) used under the hood | MetaCubeX/mihomo |
| Meta rules dat | Community geo / ruleset data releases (our Geo Data Source presets mirror these) | MetaCubeX/meta-rules-dat |
| Mieru | UDP port hopping VPN protocol; mierus:// subscription links are supported as imports | enfein/mieru |
| SlothClash (Desktop) | Companion desktop client in the same ecosystem (Wails · Go · React) | Nemu-x/SlothClash |
| Documentation | Mihomo / Meta docs (rules, parsers, …) | wiki.metacubex.one |