Files
SyncGames/android/README.md
T
DawnsorrowandCursor 0d6b0b2f80 Initial SyncGames tree: agent, Android, deploy, docs.
Session-gated MinIO save sync with AppImage GUI, CLI edit/session flow, and Gitea release helper.

Co-authored-by: Cursor <[email protected]>
2026-07-14 22:06:36 -05:00

1.0 KiB

SyncGames Android (Kotlin + Compose)

Light UI for Path 3 session ops against MinIO over Cloudflare HTTPS.

Features

  • Settings (endpoint, keys in EncryptedSharedPreferences, device id, games JSON)
  • Game list → Start / End / Status / History / Restore
  • Doctor probe (PUT/GET/DELETE) to validate NGINX/Cloudflare
  • Implements the same protocol as the Python agent (docs/protocol.md)

Build

Open android/ in Android Studio, sync Gradle, run on a device/emulator.

cd android
./gradlew :app:assembleDebug   # after generating the Gradle wrapper in Android Studio once

Sideload app/build/outputs/apk/debug/app-debug.apk.

First-run config

  1. Settings → set https://syncgames-s3.<your-domain>
  2. MinIO access/secret keys
  3. device_id e.g. phone-android
  4. Edit games JSON nativePath to the absolute Eden/Yuzu save folder on the device

Note on Storage Access Framework

v1 accepts absolute paths in games JSON for devices where the save tree is readable. A SAF folder picker can be added without changing the protocol layer.