A TeamSpeak 3 client for Android, Windows & Linux built with Flutter & Rust
- Voice chat — real-time OpusVoice (48kHz mono) with VAD and PTT
- Full mute — one-tap headset button (or the media card play/pause) silences input + output and stops the mic
- Background keep-alive — stays connected in the background like a music player, backed by a foreground service + media session with mute/disconnect notification controls
- Per-client volume — adjust each user's volume locally, remembered by identity across sessions
- Channel chat — send and receive text messages in channels
- Server bookmarks — save and manage server addresses locally
- First-use guide — interactive spotlight coach marks on the real UI (re-viewable from the help icons)
- Voice settings — VAD / PTT / mic gain / threshold tuning from the settings screen, by long-pressing the mic button, or by tapping your own name in the user list, with a live mic level + mic test
- Desktop support — the same Rust core runs on Windows and Linux; mic capture uses a cpal input stream inside the native library, playback negotiates the device format with an automatic fallback chain
- OTA updates (Android) — checks GitHub/Gitee releases (tag format
vx.y.z) on launch, downloads the ABI-matched APK and installs it; check can be disabled and the source chosen in settings
| Layer | Stack |
|---|---|
| UI | Flutter (Dart) + Riverpod |
| Protocol & codec | Rust (tsclientlib, opus-rs) |
| Playback | Rust (cpal — continuous output stream, silence when idle) |
| Mic capture | Android: Kotlin (AudioRecord) → EventChannel → Dart → FFI → RustWindows/Linux: Rust ( cpal input stream) → encode/send pipeline |
| Background persistence | KeepAliveService (foreground service + MediaSession, Android) |
Flutter (Dart) Rust (Native .so)
───────────── ─────────────────
lib/services/ts_ffi.dart ←FFI→ native/src/api.rs
lib/services/audio_service.dart native/src/lib.rs
lib/models/ts_state.dart (tsclientlib + opus-rs + tokio)
Kotlin (Android only)
─────────────────────
MainActivity.kt ←EventChannel→ audio_service.dart (mic via AudioRecord)
KeepAliveService.kt ←MethodChannel→ foreground_service.dart (foreground service,
MediaSession, notification controls, MediaStore saves)
| Tool | Version |
|---|---|
| Flutter | 3.x (Dart >=3.11) |
| Rust | 1.70+ |
| Android SDK | Latest |
| Android NDK | 26+ |
| Linux: alsa-lib, gtk3, ninja, pkg-config | Latest (desktop build) |
| Windows: Visual Studio (C++ desktop workload) | Latest (desktop build) |
Quick way — builds both ABIs and copies the .so files in one step:
# 1. Install Rust Android targets
rustup target add aarch64-linux-android x86_64-linux-android
# 2. Build the native library (requires ANDROID_NDK_HOME pointing at an installed NDK)
python3 pre_build.py android
# 3. Run
flutter runManual alternative (same result, step by step):
cd native
cargo build --release --target aarch64-linux-android
cargo build --release --target x86_64-linux-android
cp target/aarch64-linux-android/release/libtsclient.so ../android/app/src/main/jniLibs/arm64-v8a/
cp target/x86_64-linux-android/release/libtsclient.so ../android/app/src/main/jniLibs/x86_64/libtsclient.so is gitignored — the app runs only after it has been built and copied.
sudo apt install libasound2-dev libgtk-3-dev ninja-build # build deps
python3 pre_build.py linux # host-builds the Rust core into native/prebuilt/linux/
flutter build linux --release # bundle: build/linux/x64/release/bundle/
./build/linux/x64/release/bundle/nek0The bundle's CMake step picks up native/prebuilt/linux/libtsclient.so and installs it
into <bundle>/lib/, where ts_ffi.dart loads it from at runtime.
python3 pre_build.py windows # builds tsclient.dll into native/prebuilt/windows/ (Windows host only)
flutter build windows --release
build\windows\x64\runner\Release\nek0.exeThe CMake build copies tsclient.dll next to nek0.exe, which is where ts_ffi.dart
loads it from at runtime.
adb logcat | grep flutter # Flutter logs
adb logcat | grep RustStdouterr # Rust logs
adb logcat | grep -E "cpal|opus" # Audio logs
adb shell dumpsys media_session # Media session active/playing (keep-alive)
adb shell dumpsys activity services com.senlinjun.nek0 # Foreground service state| Permission | Purpose |
|---|---|
INTERNET |
Connect to TeamSpeak servers |
RECORD_AUDIO |
Microphone capture (requested at runtime) |
FOREGROUND_SERVICE / FOREGROUND_SERVICE_MEDIA_PLAYBACK / FOREGROUND_SERVICE_MICROPHONE |
Background keep-alive service |
POST_NOTIFICATIONS |
Service notification (Android 13+) |
WAKE_LOCK |
Keep the CPU awake for audio while connected |
REQUEST_INSTALL_PACKAGES |
OTA update APK installation |
WRITE_EXTERNAL_STORAGE |
OTA download (API <= 28) |
Nek0/
├── android/app/src/main/
│ ├── jniLibs/ # Pre-built .so files (gitignored, built by pre_build.py)
│ ├── kotlin/.../MainActivity.kt # Mic capture (AudioRecord), platform channels
│ ├── kotlin/.../KeepAliveService.kt # Foreground service + MediaSession
│ ├── kotlin/.../NotificationActionReceiver.kt # Notification button actions
│ ├── res/xml/filepaths.xml # OTA update file provider paths
│ └── AndroidManifest.xml
├── lib/ # Flutter
│ ├── models/ # Data models + Riverpod state
│ ├── screens/ # Home / server / settings screens
│ ├── services/ # FFI bindings, audio, foreground service, OTA
│ └── widgets/ # UI components (spotlight tour, voice panel, ...)
├── linux/ # Flutter Linux runner (bundles native/prebuilt/linux/)
├── windows/ # Flutter Windows runner (bundles native/prebuilt/windows/)
├── native/ # Rust
│ ├── Cargo.toml # Patches tsclientlib/tsproto → local_tsclientlib/
│ ├── local_tsclientlib/ # Vendored tsclientlib/tsproto sources
│ ├── prebuilt/ # Desktop artifacts (gitignored, built by pre_build.py)
│ └── src/
│ ├── lib.rs # State, types, command queue
│ └── api.rs # FFI functions, event loop, audio codec
├── resource/
│ └── logo.png
├── AGENTS.md # Architecture & build guide for AI agents
├── README.md
├── README_ZH.md
├── CONTRIBUTING.md
└── pubspec.yaml
See CONTRIBUTING.md.
For educational use. tsclientlib has its own license.