Meow

A Clash/mihomo Android client with Flutter UI, powered by meow-rs and netstack-smoltcp tun2socks.

An iOS port is in public beta — see madeye/meow-ios.

Download

Architecture

Flutter UI (Dart)
    |  MethodChannel / EventChannel
    v
Android Native (Kotlin)
    |  VpnService + AIDL IPC
    |  JNI (System.loadLibrary)
    v
Rust FFI (libmihomo_android_ffi.so)
    |  netstack-smoltcp tun2socks
    |  Per-socket VpnService.protect() via JNI
    v
meow-rs (Cargo dependency)
    |  Tunnel, Config, Proxy, API
    v
Network

Features

• Proxy Protocols: Shadowsocks, Trojan, AnyTLS, Direct
  • Shadowsocks plugins: built-in simple-obfs (HTTP/TLS) and v2ray-plugin (WebSocket, optional TLS) — no external SIP003 binary required
• Transports: TLS (with ECH), WebSocket, gRPC, HTTP/2, HTTPUpgrade
• Rule Engine: Domain, IP, port, geo-based routing, rule-providers, proxy groups
• tun2socks: Pure Rust via netstack-smoltcp (no C dependencies)
• DNS: Engine-owned fake-IP resolver; every in-TUN DNS query is answered in-process and upstream lookups bypass the tunnel via protected sockets
• Socket Protection: Per-socket VpnService.protect(fd) via JNI callback
• REST API: Embedded external controller (127.0.0.1:9090) drives the live connections, logs, rules, and traffic views
• Flutter UI: Shadowrocket-style tab view
  • Home: VPN toggle, proxy group & node selection, connection status
  • Subscribe: Add/edit/remove subscriptions, YAML editor, import/export config
  • Traffic: Real-time speed chart, session upload/download stats
  • Connections / Logs / Rules: Live views powered by the REST API
  • Settings: Version, network config, per-app VPN proxy/bypass, connectivity diagnostics, about
• i18n: English, Chinese (zh_CN)
• E2E Tests: Automated with ssserver + Android emulator (SS and HTTP-proxy harnesses)

Building

Prerequisites

• Android SDK (API 36) with NDK
• Rust toolchain with Android targets:

  rustup target add aarch64-linux-android armv7-linux-androideabi i686-linux-android x86_64-linux-android
  

• Flutter SDK (3.x)
• JDK 17

Build

# Generate Flutter module files
cd flutter_module && flutter pub get && cd ..

# Build debug APK (arm64 only, release Rust)
export JAVA_HOME=/path/to/jdk17
./gradlew :mobile:assembleDebug -PTARGET_ABI=arm64 -PCARGO_PROFILE=release

The APK is at mobile/build/outputs/apk/debug/mobile-arm64-v8a-debug.apk.

E2E Test

# Requires: ssserver, Android emulator, adb
./test-e2e.sh

Project Structure

core/                           Android library module
  src/main/java/                Kotlin: VPN service, AIDL, Room DB
  src/main/rust/
    mihomo-android-ffi/         Rust FFI crate (JNI + tun2socks)
flutter_module/                 Flutter UI module
  lib/screens/                  Home, Subscriptions, Traffic, Connections,
                                Logs, Rules, Per-app proxy, Settings
  lib/services/                 VPN channel, REST API client, traffic history
  lib/l10n/                     Localization (en, zh_CN)
mobile/                         Android app module (FlutterActivity host)
test-e2e.sh                     End-to-end test script (Shadowsocks)
test-e2e-http.sh                End-to-end test script (HTTP proxy)

License

MIT - Max Lv max.c.lv@gmail.com