How asjohn720/ola-s1-mods works
S1Mods is both an Android utility and a Windows/Python setup tool for enabling reversible ADB access and installing infotainment mods on compatible MoveOS scooters. The main Android workflow discovers a scooter, connects through diagnostics gRPC, temporarily authorizes ADB, and installs selected APKs; separate screens provide sideloading and diagnostic controls. The Python setup tool offers a PC-based route through its gRPC helper. Edges reflect the supplied excerpts, SOURCE INDEX references, and README; unsampled module details are not assumed.
Main entry points: MainActivity.kt App shell · ScooterManager.kt Scooter manager · S1GrpcClient.kt Diagnostics client · CustomApkScreen.kt APK manager
Components 22
Android app
- App shell
android/app/src/main/java/com/asjohn720/s1mods/MainActivity.kt
Vehicle access
- Scooter manager
android/app/src/main/java/com/asjohn720/s1mods/model/ScooterManager.kt - Network discovery
android/app/src/main/java/com/asjohn720/s1mods/discovery/NetworkScanner.kt - Diagnostics client
android/app/src/main/java/com/asjohn720/s1mods/grpc/S1GrpcClient.kt - Protocol codec
android/app/src/main/java/com/asjohn720/s1mods/grpc/ProtoUtils.kt - ADB manager
android/app/src/main/java/com/asjohn720/s1mods/adb/AdbManager.kt
App workflows
- Setup screen
android/app/src/main/java/com/asjohn720/s1mods/ui/screens/SetupScreen.kt - Connection UI
android/app/src/main/java/com/asjohn720/s1mods/ui/screens/ConnectVehicleScreen.kt - Automated setup
android/app/src/main/java/com/asjohn720/s1mods/model/ScooterManager.kt - Diagnostics toolbox
android/app/src/main/java/com/asjohn720/s1mods/ui/screens/ToolboxScreen.kt - Remote shell
android/app/src/main/java/com/asjohn720/s1mods/ui/screens/ShellScreen.kt - APK manager
android/app/src/main/java/com/asjohn720/s1mods/ui/screens/CustomApkScreen.kt - APK downloader
android/app/src/main/java/com/asjohn720/s1mods/util/ApkDownloader.kt - Bundled mod APKs
android/app/src/main/assets - Release checker
android/app/src/main/java/com/asjohn720/s1mods/util/UpdateChecker.kt
PC setup
- PC setup tool
setup.py - Python diagnostics
ola.py
External systems
- MoveOS scooter
- GitHub releases
- Android phone
- Windows PC
Other components
- Vehicle owner
Connections 26
- Vehicle owner → App shell: uses
README.md - Android phone → App shell: runs
README.md - App shell → Setup screen: shows
android/app/src/main/java/com/asjohn720/s1mods/MainActivity.kt - App shell → Connection UI: shows
android/app/src/main/java/com/asjohn720/s1mods/MainActivity.kt - App shell → Diagnostics toolbox: shows
android/app/src/main/java/com/asjohn720/s1mods/MainActivity.kt - App shell → Remote shell: shows
android/app/src/main/java/com/asjohn720/s1mods/MainActivity.kt - App shell → APK manager: shows
android/app/src/main/java/com/asjohn720/s1mods/MainActivity.kt - App shell → Scooter manager: creates
android/app/src/main/java/com/asjohn720/s1mods/MainActivity.kt - App shell → Release checker: checks updates
android/app/src/main/java/com/asjohn720/s1mods/MainActivity.kt - Setup screen → Scooter manager: runs setup
android/app/src/main/java/com/asjohn720/s1mods/ui/screens/SetupScreen.kt - Diagnostics toolbox → Scooter manager: requests diagnostics
android/app/src/main/java/com/asjohn720/s1mods/ui/screens/ToolboxScreen.kt - APK manager → Scooter manager: installs APK
android/app/src/main/java/com/asjohn720/s1mods/ui/screens/CustomApkScreen.kt - APK manager → APK downloader: downloads
android/app/src/main/java/com/asjohn720/s1mods/ui/screens/CustomApkScreen.kt - Scooter manager → Network discovery: discovers scooter
android/app/src/main/java/com/asjohn720/s1mods/model/ScooterManager.kt - Scooter manager → Diagnostics client: connects diagnostics
android/app/src/main/java/com/asjohn720/s1mods/model/ScooterManager.kt - Scooter manager → ADB manager: uses ADB
android/app/src/main/java/com/asjohn720/s1mods/model/ScooterManager.kt - Diagnostics client → Protocol codec: decodes responses
android/app/src/main/java/com/asjohn720/s1mods/grpc/S1GrpcClient.kt - Diagnostics client → MoveOS scooter: calls port 50005
README.md - ADB manager → MoveOS scooter: authorizes and installs
android/app/src/main/java/com/asjohn720/s1mods/adb/AdbManager.kt - Scooter manager → Bundled mod APKs: installs assets
README.md - Release checker → GitHub releases: fetches releases
android/app/src/main/java/com/asjohn720/s1mods/util/UpdateChecker.kt - Vehicle owner → Windows PC: runs setup
README.md - Windows PC → PC setup tool: runs
README.md - PC setup tool → Python diagnostics: uses helper
setup.py - PC setup tool → MoveOS scooter: sets up locally
README.md - Python diagnostics → MoveOS scooter: diagnoses locally
README.md