Files

clients: default server URL → https://tether.pecord.io

Replace the dead tether.lan / localhost / emulator-host placeholders with the
live public relay across all clients (iOS, macOS, Android, agent), so a fresh
install connects out of the box. All remain overridable (UI field / --server).

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

2026-06-21 01:01:58 -05:00

app

clients: default server URL → https://tether.pecord.io

2026-06-21 01:01:58 -05:00

.gitignore

android: Compose client scaffold on tethercore (Kotlin/UniFFI)

2026-06-20 23:42:36 -05:00

build.gradle.kts

android: Compose client scaffold on tethercore (Kotlin/UniFFI)

2026-06-20 23:42:36 -05:00

gradle.properties

android: Compose client scaffold on tethercore (Kotlin/UniFFI)

2026-06-20 23:42:36 -05:00

README.md

android: Compose client scaffold on tethercore (Kotlin/UniFFI)

2026-06-20 23:42:36 -05:00

settings.gradle.kts

android: Compose client scaffold on tethercore (Kotlin/UniFFI)

2026-06-20 23:42:36 -05:00

README.md

tether — Android client

Compose UI over the shared tethercore Rust engine (SSE + RTC) via UniFFI Kotlin bindings. Same engine as the iOS/macOS apps and the desktop agent; only the UI and the binding language differ.

Build (requires the Android NDK)

This machine had no Android toolchain when the app was scaffolded, so the native .so and Kotlin bindings are not committed — they're generated:

Install the toolchain:
- Android Studio (SDK + NDK), or sdkmanager "ndk;26.x"
- cargo install cargo-ndk
- rustup target add aarch64-linux-android x86_64-linux-android
- export ANDROID_NDK_HOME=/path/to/ndk
Generate native libs + bindings:
```
../core/build-android.sh
```
This places libtethercore.so under app/src/main/jniLibs/<abi>/ and the Kotlin binding under app/src/main/java/uniffi/tethercore/.
Build/run the app: open android/ in Android Studio (it generates the Gradle wrapper on first sync), then Run. From the CLI, generate the wrapper once with gradle wrapper, then ./gradlew :app:assembleDebug.

Notes

Default server is http://10.0.2.2:8765 — the emulator's alias for the host machine's localhost. On a physical device use the relay's LAN address.
Android (unlike iOS) lets a foreground app observe clipboard changes, so the app auto-sends via OnPrimaryClipChangedListener. A foreground Service would extend that to the background (future work).
The room id is a per-install UUID (RoomIdentity); account-derived shared rooms are future work, matching the iOS plan.