# asjohn720/ola-s1-mods architecture

> Architecture diagram of the GitHub repository asjohn720/ola-s1-mods, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-18). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/asjohn720/ola-s1-mods
- Repository: https://github.com/asjohn720/ola-s1-mods

## Overview

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: [`android/app/src/main/java/com/asjohn720/s1mods/MainActivity.kt`](https://github.com/asjohn720/ola-s1-mods/blob/main/android/app/src/main/java/com/asjohn720/s1mods/MainActivity.kt) (App shell), [`android/app/src/main/java/com/asjohn720/s1mods/model/ScooterManager.kt`](https://github.com/asjohn720/ola-s1-mods/blob/main/android/app/src/main/java/com/asjohn720/s1mods/model/ScooterManager.kt) (Scooter manager), [`android/app/src/main/java/com/asjohn720/s1mods/grpc/S1GrpcClient.kt`](https://github.com/asjohn720/ola-s1-mods/blob/main/android/app/src/main/java/com/asjohn720/s1mods/grpc/S1GrpcClient.kt) (Diagnostics client), [`android/app/src/main/java/com/asjohn720/s1mods/ui/screens/CustomApkScreen.kt`](https://github.com/asjohn720/ola-s1-mods/blob/main/android/app/src/main/java/com/asjohn720/s1mods/ui/screens/CustomApkScreen.kt) (APK manager)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_android["Android app"]
  node_app["App shell<br/>[MainActivity.kt]"]
end

subgraph group_vehicle["Vehicle access"]
  node_manager["Scooter manager<br/>[ScooterManager.kt]"]
  node_scanner["Network discovery<br/>[NetworkScanner.kt]"]
  node_grpc["Diagnostics client<br/>[S1GrpcClient.kt]"]
  node_proto["Protocol codec<br/>[ProtoUtils.kt]"]
  node_adb["ADB manager<br/>[AdbManager.kt]"]
end

subgraph group_features["App workflows"]
  node_setup_ui["Setup screen<br/>[SetupScreen.kt]"]
  node_vehicle_ui["Connection UI"]
  node_setup_flow["Automated setup<br/>[ScooterManager.kt]"]
  node_toolbox["Diagnostics toolbox<br/>[ToolboxScreen.kt]"]
  node_shell["Remote shell<br/>[ShellScreen.kt]"]
  node_custom_apk["APK manager<br/>[CustomApkScreen.kt]"]
  node_apk_download["APK downloader<br/>[ApkDownloader.kt]"]
  node_bundled_apks["Bundled mod APKs"]
  node_release_check["Release checker<br/>[UpdateChecker.kt]"]
end

subgraph group_desktop["PC setup"]
  node_desktop_setup["PC setup tool<br/>[setup.py]"]
  node_python_grpc["Python diagnostics<br/>[ola.py]"]
end

subgraph group_external["External systems"]
  node_scooter(("MoveOS scooter"))
  node_github(("GitHub releases"))
  node_phone(("Android phone"))
  node_windows(("Windows PC"))
end

node_user(("Vehicle owner"))

node_user -->|"uses"| node_app
node_phone -->|"runs"| node_app
node_app -->|"shows"| node_setup_ui
node_app -->|"shows"| node_vehicle_ui
node_app -->|"shows"| node_toolbox
node_app -->|"shows"| node_shell
node_app -->|"shows"| node_custom_apk
node_app -->|"creates"| node_manager
node_app -->|"checks updates"| node_release_check
node_setup_ui -->|"runs setup"| node_manager
node_toolbox -->|"requests diagnostics"| node_manager
node_custom_apk -->|"installs APK"| node_manager
node_custom_apk -->|"downloads"| node_apk_download
node_manager -->|"discovers scooter"| node_scanner
node_manager -->|"connects diagnostics"| node_grpc
node_manager -->|"uses ADB"| node_adb
node_grpc -->|"decodes responses"| node_proto
node_grpc -->|"calls port 50005"| node_scooter
node_adb -->|"authorizes and installs"| node_scooter
node_manager -->|"installs assets"| node_bundled_apks
node_release_check -->|"fetches releases"| node_github
node_user -->|"runs setup"| node_windows
node_windows -->|"runs"| node_desktop_setup
node_desktop_setup -->|"uses helper"| node_python_grpc
node_desktop_setup -->|"sets up locally"| node_scooter
node_python_grpc -->|"diagnoses locally"| node_scooter

click node_app "https://github.com/asjohn720/ola-s1-mods/blob/main/android/app/src/main/java/com/asjohn720/s1mods/MainActivity.kt"
click node_setup_ui "https://github.com/asjohn720/ola-s1-mods/blob/main/android/app/src/main/java/com/asjohn720/s1mods/ui/screens/SetupScreen.kt"
click node_vehicle_ui "https://github.com/asjohn720/ola-s1-mods/blob/main/android/app/src/main/java/com/asjohn720/s1mods/ui/screens/ConnectVehicleScreen.kt"
click node_manager "https://github.com/asjohn720/ola-s1-mods/blob/main/android/app/src/main/java/com/asjohn720/s1mods/model/ScooterManager.kt"
click node_scanner "https://github.com/asjohn720/ola-s1-mods/blob/main/android/app/src/main/java/com/asjohn720/s1mods/discovery/NetworkScanner.kt"
click node_grpc "https://github.com/asjohn720/ola-s1-mods/blob/main/android/app/src/main/java/com/asjohn720/s1mods/grpc/S1GrpcClient.kt"
click node_proto "https://github.com/asjohn720/ola-s1-mods/blob/main/android/app/src/main/java/com/asjohn720/s1mods/grpc/ProtoUtils.kt"
click node_adb "https://github.com/asjohn720/ola-s1-mods/blob/main/android/app/src/main/java/com/asjohn720/s1mods/adb/AdbManager.kt"
click node_setup_flow "https://github.com/asjohn720/ola-s1-mods/blob/main/android/app/src/main/java/com/asjohn720/s1mods/model/ScooterManager.kt"
click node_toolbox "https://github.com/asjohn720/ola-s1-mods/blob/main/android/app/src/main/java/com/asjohn720/s1mods/ui/screens/ToolboxScreen.kt"
click node_shell "https://github.com/asjohn720/ola-s1-mods/blob/main/android/app/src/main/java/com/asjohn720/s1mods/ui/screens/ShellScreen.kt"
click node_custom_apk "https://github.com/asjohn720/ola-s1-mods/blob/main/android/app/src/main/java/com/asjohn720/s1mods/ui/screens/CustomApkScreen.kt"
click node_apk_download "https://github.com/asjohn720/ola-s1-mods/blob/main/android/app/src/main/java/com/asjohn720/s1mods/util/ApkDownloader.kt"
click node_bundled_apks "https://github.com/asjohn720/ola-s1-mods/tree/main/android/app/src/main/assets"
click node_release_check "https://github.com/asjohn720/ola-s1-mods/blob/main/android/app/src/main/java/com/asjohn720/s1mods/util/UpdateChecker.kt"
click node_desktop_setup "https://github.com/asjohn720/ola-s1-mods/blob/main/setup.py"
click node_python_grpc "https://github.com/asjohn720/ola-s1-mods/blob/main/ola.py"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_app toneBlue
class node_manager,node_scanner,node_grpc,node_proto,node_adb toneAmber
class node_setup_ui,node_vehicle_ui,node_setup_flow,node_toolbox,node_shell,node_custom_apk,node_apk_download,node_bundled_apks,node_release_check toneMint
class node_desktop_setup,node_python_grpc toneRose
class node_scooter,node_github,node_phone,node_windows,node_user toneIndigo
```

## Components

### Android app

- [App shell](https://github.com/asjohn720/ola-s1-mods/blob/main/android/app/src/main/java/com/asjohn720/s1mods/MainActivity.kt): `android/app/src/main/java/com/asjohn720/s1mods/MainActivity.kt`

### Vehicle access

- [Scooter manager](https://github.com/asjohn720/ola-s1-mods/blob/main/android/app/src/main/java/com/asjohn720/s1mods/model/ScooterManager.kt): `android/app/src/main/java/com/asjohn720/s1mods/model/ScooterManager.kt`
- [Network discovery](https://github.com/asjohn720/ola-s1-mods/blob/main/android/app/src/main/java/com/asjohn720/s1mods/discovery/NetworkScanner.kt): `android/app/src/main/java/com/asjohn720/s1mods/discovery/NetworkScanner.kt`
- [Diagnostics client](https://github.com/asjohn720/ola-s1-mods/blob/main/android/app/src/main/java/com/asjohn720/s1mods/grpc/S1GrpcClient.kt): `android/app/src/main/java/com/asjohn720/s1mods/grpc/S1GrpcClient.kt`
- [Protocol codec](https://github.com/asjohn720/ola-s1-mods/blob/main/android/app/src/main/java/com/asjohn720/s1mods/grpc/ProtoUtils.kt): `android/app/src/main/java/com/asjohn720/s1mods/grpc/ProtoUtils.kt`
- [ADB manager](https://github.com/asjohn720/ola-s1-mods/blob/main/android/app/src/main/java/com/asjohn720/s1mods/adb/AdbManager.kt): `android/app/src/main/java/com/asjohn720/s1mods/adb/AdbManager.kt`

### App workflows

- [Setup screen](https://github.com/asjohn720/ola-s1-mods/blob/main/android/app/src/main/java/com/asjohn720/s1mods/ui/screens/SetupScreen.kt): `android/app/src/main/java/com/asjohn720/s1mods/ui/screens/SetupScreen.kt`
- [Connection UI](https://github.com/asjohn720/ola-s1-mods/blob/main/android/app/src/main/java/com/asjohn720/s1mods/ui/screens/ConnectVehicleScreen.kt): `android/app/src/main/java/com/asjohn720/s1mods/ui/screens/ConnectVehicleScreen.kt`
- [Automated setup](https://github.com/asjohn720/ola-s1-mods/blob/main/android/app/src/main/java/com/asjohn720/s1mods/model/ScooterManager.kt): `android/app/src/main/java/com/asjohn720/s1mods/model/ScooterManager.kt`
- [Diagnostics toolbox](https://github.com/asjohn720/ola-s1-mods/blob/main/android/app/src/main/java/com/asjohn720/s1mods/ui/screens/ToolboxScreen.kt): `android/app/src/main/java/com/asjohn720/s1mods/ui/screens/ToolboxScreen.kt`
- [Remote shell](https://github.com/asjohn720/ola-s1-mods/blob/main/android/app/src/main/java/com/asjohn720/s1mods/ui/screens/ShellScreen.kt): `android/app/src/main/java/com/asjohn720/s1mods/ui/screens/ShellScreen.kt`
- [APK manager](https://github.com/asjohn720/ola-s1-mods/blob/main/android/app/src/main/java/com/asjohn720/s1mods/ui/screens/CustomApkScreen.kt): `android/app/src/main/java/com/asjohn720/s1mods/ui/screens/CustomApkScreen.kt`
- [APK downloader](https://github.com/asjohn720/ola-s1-mods/blob/main/android/app/src/main/java/com/asjohn720/s1mods/util/ApkDownloader.kt): `android/app/src/main/java/com/asjohn720/s1mods/util/ApkDownloader.kt`
- [Bundled mod APKs](https://github.com/asjohn720/ola-s1-mods/tree/main/android/app/src/main/assets): `android/app/src/main/assets`
- [Release checker](https://github.com/asjohn720/ola-s1-mods/blob/main/android/app/src/main/java/com/asjohn720/s1mods/util/UpdateChecker.kt): `android/app/src/main/java/com/asjohn720/s1mods/util/UpdateChecker.kt`

### PC setup

- [PC setup tool](https://github.com/asjohn720/ola-s1-mods/blob/main/setup.py): `setup.py`
- [Python diagnostics](https://github.com/asjohn720/ola-s1-mods/blob/main/ola.py): `ola.py`

### External systems

- **MoveOS scooter**
- **GitHub releases**
- **Android phone**
- **Windows PC**

### Other components

- **Vehicle owner**

## Connections

- Vehicle owner → App shell: uses (evidence: `README.md`)
- Android phone → App shell: runs (evidence: `README.md`)
- App shell → Setup screen: shows (evidence: `android/app/src/main/java/com/asjohn720/s1mods/MainActivity.kt`)
- App shell → Connection UI: shows (evidence: `android/app/src/main/java/com/asjohn720/s1mods/MainActivity.kt`)
- App shell → Diagnostics toolbox: shows (evidence: `android/app/src/main/java/com/asjohn720/s1mods/MainActivity.kt`)
- App shell → Remote shell: shows (evidence: `android/app/src/main/java/com/asjohn720/s1mods/MainActivity.kt`)
- App shell → APK manager: shows (evidence: `android/app/src/main/java/com/asjohn720/s1mods/MainActivity.kt`)
- App shell → Scooter manager: creates (evidence: `android/app/src/main/java/com/asjohn720/s1mods/MainActivity.kt`)
- App shell → Release checker: checks updates (evidence: `android/app/src/main/java/com/asjohn720/s1mods/MainActivity.kt`)
- Setup screen → Scooter manager: runs setup (evidence: `android/app/src/main/java/com/asjohn720/s1mods/ui/screens/SetupScreen.kt`)
- Diagnostics toolbox → Scooter manager: requests diagnostics (evidence: `android/app/src/main/java/com/asjohn720/s1mods/ui/screens/ToolboxScreen.kt`)
- APK manager → Scooter manager: installs APK (evidence: `android/app/src/main/java/com/asjohn720/s1mods/ui/screens/CustomApkScreen.kt`)
- APK manager → APK downloader: downloads (evidence: `android/app/src/main/java/com/asjohn720/s1mods/ui/screens/CustomApkScreen.kt`)
- Scooter manager → Network discovery: discovers scooter (evidence: `android/app/src/main/java/com/asjohn720/s1mods/model/ScooterManager.kt`)
- Scooter manager → Diagnostics client: connects diagnostics (evidence: `android/app/src/main/java/com/asjohn720/s1mods/model/ScooterManager.kt`)
- Scooter manager → ADB manager: uses ADB (evidence: `android/app/src/main/java/com/asjohn720/s1mods/model/ScooterManager.kt`)
- Diagnostics client → Protocol codec: decodes responses (evidence: `android/app/src/main/java/com/asjohn720/s1mods/grpc/S1GrpcClient.kt`)
- Diagnostics client → MoveOS scooter: calls port 50005 (evidence: `README.md`)
- ADB manager → MoveOS scooter: authorizes and installs (evidence: `android/app/src/main/java/com/asjohn720/s1mods/adb/AdbManager.kt`)
- Scooter manager → Bundled mod APKs: installs assets (evidence: `README.md`)
- Release checker → GitHub releases: fetches releases (evidence: `android/app/src/main/java/com/asjohn720/s1mods/util/UpdateChecker.kt`)
- Vehicle owner → Windows PC: runs setup (evidence: `README.md`)
- Windows PC → PC setup tool: runs (evidence: `README.md`)
- PC setup tool → Python diagnostics: uses helper (evidence: `setup.py`)
- PC setup tool → MoveOS scooter: sets up locally (evidence: `README.md`)
- Python diagnostics → MoveOS scooter: diagnoses locally (evidence: `README.md`)
