# kakaxiaeofficial/opendroid-webos architecture

> Architecture diagram of the GitHub repository kakaxiaeofficial/opendroid-webos, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-09). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/kakaxiaeofficial/opendroid-webos
- Repository: https://github.com/kakaxiaeofficial/opendroid-webos

## Overview

OpenDroid WebOS is an Android-to-browser remote device control product. Its documented workflow is a user opening the Web OS, signing in, and controlling a bound Android phone over cloud MQTT or local Wi-Fi. The README describes screen, camera, file, telephony/location, and anti-theft capabilities, which are represented as separate product stages. The supplied source excerpts cover only Gradle configuration, so implementation-level wiring between these stages is not verified; dashed edges mark those links as unverified.

Main entry points: [`index.html`](https://github.com/kakaxiaeofficial/opendroid-webos/blob/main/index.html) (Web OS), [`app/src/main/java/com/example/localutility/MainActivity.kt`](https://github.com/kakaxiaeofficial/opendroid-webos/blob/main/app/src/main/java/com/example/localutility/MainActivity.kt) (Android app), [`app/src/main/java/com/example/localutility/DirectScreenStreamer.kt`](https://github.com/kakaxiaeofficial/opendroid-webos/blob/main/app/src/main/java/com/example/localutility/DirectScreenStreamer.kt) (Direct screen stream), [`app/src/main/java/com/example/localutility/CameraStreamService.kt`](https://github.com/kakaxiaeofficial/opendroid-webos/blob/main/app/src/main/java/com/example/localutility/CameraStreamService.kt) (Camera stream)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web and connectivity"]
  node_webos["Web OS<br/>[index.html]"]
  node_mqtt{{"EMQX MQTT"}}
  node_localweb["Bundled web UI<br/>[index.html]"]
  node_discovery["Network discovery"]
end

subgraph group_mobile["Android control"]
  node_phone["Android app<br/>[MainActivity.kt]"]
end

subgraph group_media["Capture and streaming"]
  node_screen["Screen capture"]
  node_screenstream["Direct screen stream"]
  node_camera["Camera stream"]
  node_directcamera["Direct camera feed"]
  node_webrtc["WebRTC<br/>[WebRtcManager.kt]"]
  node_audio["Audio streaming"]
  node_recording["Call recording"]
end

subgraph group_device["Device capabilities"]
  node_files["File explorer service"]
  node_telephony["Telephony and GPS"]
  node_remoteinput["Remote input"]
  node_notifications["Notification mirror"]
  node_stealth["Stealth capture"]
  node_admin["Device admin<br/>[AdminReceiver.kt]"]
  node_boot["Boot receiver<br/>[BootReceiver.kt]"]
  node_secret["Secret code access"]
end

node_user(("PC user"))

node_user -->|"opens"| node_webos
node_webos -->|"signals through"| node_mqtt
node_mqtt -.->|"connects account"| node_phone
node_user -.->|"binds account"| node_phone
node_webos -.->|"views screen"| node_screenstream
node_screenstream -.->|"captures display"| node_screen
node_webos -.->|"sends controls"| node_remoteinput
node_webos -.->|"requests camera"| node_camera
node_camera -.->|"streams feed"| node_directcamera
node_webos -.->|"uses two-way audio"| node_audio
node_webos -.->|"uses streaming"| node_webrtc
node_webos -.->|"manages files"| node_files
node_webos -.->|"requests phone data"| node_telephony
node_webos -.->|"views notifications"| node_notifications
node_webos -.->|"requests device actions"| node_admin
node_phone -.->|"supports stealth"| node_stealth
node_phone -.->|"supports local discovery"| node_discovery
node_phone -.->|"bundles interface"| node_localweb
node_phone -.->|"uses boot receiver"| node_boot
node_phone -.->|"supports secret access"| node_secret
node_phone -.->|"supports call recording"| node_recording

click node_webos "https://github.com/kakaxiaeofficial/opendroid-webos/blob/main/index.html"
click node_phone "https://github.com/kakaxiaeofficial/opendroid-webos/blob/main/app/src/main/java/com/example/localutility/MainActivity.kt"
click node_localweb "https://github.com/kakaxiaeofficial/opendroid-webos/blob/main/app/src/main/assets/index.html"
click node_screen "https://github.com/kakaxiaeofficial/opendroid-webos/blob/main/app/src/main/java/com/example/localutility/ScreenCaptureService.kt"
click node_screenstream "https://github.com/kakaxiaeofficial/opendroid-webos/blob/main/app/src/main/java/com/example/localutility/DirectScreenStreamer.kt"
click node_camera "https://github.com/kakaxiaeofficial/opendroid-webos/blob/main/app/src/main/java/com/example/localutility/CameraStreamService.kt"
click node_directcamera "https://github.com/kakaxiaeofficial/opendroid-webos/blob/main/app/src/main/java/com/example/localutility/DirectCameraStreamer.kt"
click node_webrtc "https://github.com/kakaxiaeofficial/opendroid-webos/blob/main/app/src/main/java/com/example/localutility/WebRtcManager.kt"
click node_audio "https://github.com/kakaxiaeofficial/opendroid-webos/blob/main/app/src/main/java/com/example/AudioStreamManager.kt"
click node_files "https://github.com/kakaxiaeofficial/opendroid-webos/blob/main/app/src/main/java/com/example/localutility/LocalFileServerService.kt"
click node_telephony "https://github.com/kakaxiaeofficial/opendroid-webos/blob/main/app/src/main/java/com/example/localutility/TelephonyAndLocationManager.kt"
click node_remoteinput "https://github.com/kakaxiaeofficial/opendroid-webos/blob/main/app/src/main/java/com/example/localutility/RemoteInputService.kt"
click node_notifications "https://github.com/kakaxiaeofficial/opendroid-webos/blob/main/app/src/main/java/com/example/localutility/NotificationMirrorService.kt"
click node_stealth "https://github.com/kakaxiaeofficial/opendroid-webos/blob/main/app/src/main/java/com/example/localutility/StealthCaptureManager.kt"
click node_admin "https://github.com/kakaxiaeofficial/opendroid-webos/blob/main/app/src/main/java/com/example/localutility/AdminReceiver.kt"
click node_discovery "https://github.com/kakaxiaeofficial/opendroid-webos/blob/main/app/src/main/java/com/example/localutility/NsdDiscoveryManager.kt"
click node_boot "https://github.com/kakaxiaeofficial/opendroid-webos/blob/main/app/src/main/java/com/example/localutility/BootReceiver.kt"
click node_secret "https://github.com/kakaxiaeofficial/opendroid-webos/blob/main/app/src/main/java/com/example/localutility/SecretCodeReceiver.kt"
click node_recording "https://github.com/kakaxiaeofficial/opendroid-webos/blob/main/app/src/main/java/com/example/localutility/CallRecordingManager.kt"

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_webos,node_mqtt,node_localweb,node_discovery,node_user toneBlue
class node_phone toneAmber
class node_screen,node_screenstream,node_camera,node_directcamera,node_webrtc,node_audio,node_recording toneMint
class node_files,node_telephony,node_remoteinput,node_notifications,node_stealth,node_admin,node_boot,node_secret toneRose
```

## Components

### Web and connectivity

- [Web OS](https://github.com/kakaxiaeofficial/opendroid-webos/blob/main/index.html): `index.html`
- **EMQX MQTT**
- [Bundled web UI](https://github.com/kakaxiaeofficial/opendroid-webos/blob/main/app/src/main/assets/index.html): `app/src/main/assets/index.html`
- [Network discovery](https://github.com/kakaxiaeofficial/opendroid-webos/blob/main/app/src/main/java/com/example/localutility/NsdDiscoveryManager.kt): `app/src/main/java/com/example/localutility/NsdDiscoveryManager.kt`

### Android control

- [Android app](https://github.com/kakaxiaeofficial/opendroid-webos/blob/main/app/src/main/java/com/example/localutility/MainActivity.kt): `app/src/main/java/com/example/localutility/MainActivity.kt`

### Capture and streaming

- [Screen capture](https://github.com/kakaxiaeofficial/opendroid-webos/blob/main/app/src/main/java/com/example/localutility/ScreenCaptureService.kt): `app/src/main/java/com/example/localutility/ScreenCaptureService.kt`
- [Direct screen stream](https://github.com/kakaxiaeofficial/opendroid-webos/blob/main/app/src/main/java/com/example/localutility/DirectScreenStreamer.kt): `app/src/main/java/com/example/localutility/DirectScreenStreamer.kt`
- [Camera stream](https://github.com/kakaxiaeofficial/opendroid-webos/blob/main/app/src/main/java/com/example/localutility/CameraStreamService.kt): `app/src/main/java/com/example/localutility/CameraStreamService.kt`
- [Direct camera feed](https://github.com/kakaxiaeofficial/opendroid-webos/blob/main/app/src/main/java/com/example/localutility/DirectCameraStreamer.kt): `app/src/main/java/com/example/localutility/DirectCameraStreamer.kt`
- [WebRTC](https://github.com/kakaxiaeofficial/opendroid-webos/blob/main/app/src/main/java/com/example/localutility/WebRtcManager.kt): `app/src/main/java/com/example/localutility/WebRtcManager.kt`
- [Audio streaming](https://github.com/kakaxiaeofficial/opendroid-webos/blob/main/app/src/main/java/com/example/AudioStreamManager.kt): `app/src/main/java/com/example/AudioStreamManager.kt`
- [Call recording](https://github.com/kakaxiaeofficial/opendroid-webos/blob/main/app/src/main/java/com/example/localutility/CallRecordingManager.kt): `app/src/main/java/com/example/localutility/CallRecordingManager.kt`

### Device capabilities

- [File explorer service](https://github.com/kakaxiaeofficial/opendroid-webos/blob/main/app/src/main/java/com/example/localutility/LocalFileServerService.kt): `app/src/main/java/com/example/localutility/LocalFileServerService.kt`
- [Telephony and GPS](https://github.com/kakaxiaeofficial/opendroid-webos/blob/main/app/src/main/java/com/example/localutility/TelephonyAndLocationManager.kt): `app/src/main/java/com/example/localutility/TelephonyAndLocationManager.kt`
- [Remote input](https://github.com/kakaxiaeofficial/opendroid-webos/blob/main/app/src/main/java/com/example/localutility/RemoteInputService.kt): `app/src/main/java/com/example/localutility/RemoteInputService.kt`
- [Notification mirror](https://github.com/kakaxiaeofficial/opendroid-webos/blob/main/app/src/main/java/com/example/localutility/NotificationMirrorService.kt): `app/src/main/java/com/example/localutility/NotificationMirrorService.kt`
- [Stealth capture](https://github.com/kakaxiaeofficial/opendroid-webos/blob/main/app/src/main/java/com/example/localutility/StealthCaptureManager.kt): `app/src/main/java/com/example/localutility/StealthCaptureManager.kt`
- [Device admin](https://github.com/kakaxiaeofficial/opendroid-webos/blob/main/app/src/main/java/com/example/localutility/AdminReceiver.kt): `app/src/main/java/com/example/localutility/AdminReceiver.kt`
- [Boot receiver](https://github.com/kakaxiaeofficial/opendroid-webos/blob/main/app/src/main/java/com/example/localutility/BootReceiver.kt): `app/src/main/java/com/example/localutility/BootReceiver.kt`
- [Secret code access](https://github.com/kakaxiaeofficial/opendroid-webos/blob/main/app/src/main/java/com/example/localutility/SecretCodeReceiver.kt): `app/src/main/java/com/example/localutility/SecretCodeReceiver.kt`

### Other components

- **PC user**

## Connections

- PC user → Web OS: opens (evidence: `README.md`)
- Web OS → EMQX MQTT: signals through (evidence: `README.md`)
- EMQX MQTT → Android app: connects account
- PC user → Android app: binds account
- Web OS → Direct screen stream: views screen
- Direct screen stream → Screen capture: captures display
- Web OS → Remote input: sends controls
- Web OS → Camera stream: requests camera
- Camera stream → Direct camera feed: streams feed
- Web OS → Audio streaming: uses two-way audio
- Web OS → WebRTC: uses streaming
- Web OS → File explorer service: manages files
- Web OS → Telephony and GPS: requests phone data
- Web OS → Notification mirror: views notifications
- Web OS → Device admin: requests device actions
- Android app → Stealth capture: supports stealth
- Android app → Network discovery: supports local discovery
- Android app → Bundled web UI: bundles interface
- Android app → Boot receiver: uses boot receiver
- Android app → Secret code access: supports secret access
- Android app → Call recording: supports call recording
