# abhinavagarwal31/iobus architecture

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

- Interactive diagram: https://gitdiagram.com/abhinavagarwal31/iobus
- Repository: https://github.com/abhinavagarwal31/iobus

## Overview

IOBus is an Android-to-macOS remote-control system over local Wi-Fi. A user discovers or selects a server, connects over TCP for handshake and status/keepalive, then sends keyboard, trackpad, and system-control events over UDP; the server translates these into macOS input and system actions. The graph also includes discovery, saved connections, background persistence, and the live status path. Edges follow README descriptions and the supplied source index; unsampled feature details are included only where documented.

Main entry points: [`android/app/src/main/java/com/iobus/client/network/ConnectionManager.kt`](https://github.com/abhinavagarwal31/iobus/blob/main/android/app/src/main/java/com/iobus/client/network/ConnectionManager.kt) (Connection manager), [`android/app/src/main/java/com/iobus/client/MainActivity.kt`](https://github.com/abhinavagarwal31/iobus/blob/main/android/app/src/main/java/com/iobus/client/MainActivity.kt) (App navigation), [`android/app/src/main/java/com/iobus/client/ui/control/ControlScreen.kt`](https://github.com/abhinavagarwal31/iobus/blob/main/android/app/src/main/java/com/iobus/client/ui/control/ControlScreen.kt) (Control screen), [`server/main.py`](https://github.com/abhinavagarwal31/iobus/blob/main/server/main.py) (Server startup)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_android_ui["Android experience"]
  node_main_activity["App navigation<br/>[MainActivity.kt]"]
  node_connection_screen["Connection screen"]
  node_control_screen["Control screen<br/>[ControlScreen.kt]"]
  node_keyboard_panel["Keyboard panel<br/>[KeyboardPanel.kt]"]
  node_controls_panel["Control center<br/>[ControlsPanel.kt]"]
end

subgraph group_android_runtime["Android runtime"]
  node_touch_processor["Touch processor<br/>[TouchProcessor.kt]"]
  node_key_processor["Key processor<br/>[KeyProcessor.kt]"]
  node_connection_manager["Connection manager"]
  node_tcp_client["TCP client<br/>[TcpClient.kt]"]
  node_udp_client["UDP client<br/>[UdpClient.kt]"]
  node_mdns_client["mDNS discovery<br/>[MdnsDiscovery.kt]"]
  node_saved_servers[("Saved servers")]
  node_connection_service["Background service"]
end

subgraph group_wire["Shared protocol"]
  node_protocol_messages["Binary messages<br/>[messages.py]"]
  node_android_messages["Android messages<br/>[Messages.kt]"]
end

subgraph group_server["macOS server"]
  node_server_main["Server startup<br/>[main.py]"]
  node_server_config["Server configuration<br/>[config.py]"]
  node_server_discovery["mDNS advertiser<br/>[discovery.py]"]
  node_tcp_server["TCP control server<br/>[tcp_server.py]"]
  node_udp_server["UDP data server<br/>[udp_server.py]"]
  node_authenticator["PIN authentication<br/>[auth.py]"]
  node_mouse_controller["Mouse injection<br/>[mouse.py]"]
  node_keyboard_controller["Keyboard injection<br/>[keyboard.py]"]
  node_system_actions["System actions and status<br/>[actions.py]"]
end

node_user(("Phone user"))
node_macos(("macOS system"))
node_lan(("Local Wi-Fi"))

node_user -->|"uses"| node_main_activity
node_main_activity -->|"navigates"| node_connection_screen
node_main_activity -->|"navigates"| node_control_screen
node_main_activity -->|"connects"| node_connection_manager
node_main_activity -->|"loads presets"| node_saved_servers
node_main_activity -->|"starts"| node_connection_service
node_connection_screen -->|"connects"| node_connection_manager
node_connection_screen -.->|"discovers"| node_mdns_client
node_control_screen -->|"handles touch"| node_touch_processor
node_control_screen -->|"handles keys"| node_key_processor
node_control_screen -->|"renders"| node_keyboard_panel
node_control_screen -->|"renders"| node_controls_panel
node_control_screen -->|"reads status"| node_connection_manager
node_touch_processor -->|"sends input"| node_connection_manager
node_key_processor -->|"sends input"| node_connection_manager
node_controls_panel -->|"sends actions"| node_connection_manager
node_connection_manager -->|"opens control"| node_tcp_client
node_connection_manager -->|"opens data"| node_udp_client
node_connection_manager -->|"persists server"| node_saved_servers
node_tcp_client -->|"encodes control"| node_android_messages
node_udp_client -->|"sends UDP"| node_lan
node_tcp_client -->|"sends TCP"| node_lan
node_android_messages -->|"mirrors format"| node_protocol_messages
node_lan -->|"reaches server"| node_server_main
node_server_main -->|"builds config"| node_server_config
node_server_main -->|"starts"| node_tcp_server
node_server_main -->|"starts"| node_udp_server
node_server_main -->|"starts"| node_server_discovery
node_server_main -->|"configures"| node_authenticator
node_tcp_server -->|"verifies PIN"| node_authenticator
node_tcp_server -->|"reads status"| node_system_actions
node_udp_server -->|"dispatches mouse"| node_mouse_controller
node_udp_server -->|"dispatches keys"| node_keyboard_controller
node_udp_server -->|"dispatches actions"| node_system_actions
node_system_actions -->|"composes shortcuts"| node_keyboard_controller
node_mouse_controller -->|"injects events"| node_macos
node_keyboard_controller -->|"injects events"| node_macos
node_system_actions -->|"controls and reads"| node_macos
node_server_discovery -->|"advertises service"| node_lan
node_server_config -->|"sets listener"| node_tcp_server
node_server_config -->|"sets listener"| node_udp_server

click node_main_activity "https://github.com/abhinavagarwal31/iobus/blob/main/android/app/src/main/java/com/iobus/client/MainActivity.kt"
click node_connection_screen "https://github.com/abhinavagarwal31/iobus/blob/main/android/app/src/main/java/com/iobus/client/ui/connection/ConnectionScreen.kt"
click node_control_screen "https://github.com/abhinavagarwal31/iobus/blob/main/android/app/src/main/java/com/iobus/client/ui/control/ControlScreen.kt"
click node_keyboard_panel "https://github.com/abhinavagarwal31/iobus/blob/main/android/app/src/main/java/com/iobus/client/ui/control/KeyboardPanel.kt"
click node_controls_panel "https://github.com/abhinavagarwal31/iobus/blob/main/android/app/src/main/java/com/iobus/client/ui/control/ControlsPanel.kt"
click node_touch_processor "https://github.com/abhinavagarwal31/iobus/blob/main/android/app/src/main/java/com/iobus/client/input/TouchProcessor.kt"
click node_key_processor "https://github.com/abhinavagarwal31/iobus/blob/main/android/app/src/main/java/com/iobus/client/input/KeyProcessor.kt"
click node_connection_manager "https://github.com/abhinavagarwal31/iobus/blob/main/android/app/src/main/java/com/iobus/client/network/ConnectionManager.kt"
click node_tcp_client "https://github.com/abhinavagarwal31/iobus/blob/main/android/app/src/main/java/com/iobus/client/network/TcpClient.kt"
click node_udp_client "https://github.com/abhinavagarwal31/iobus/blob/main/android/app/src/main/java/com/iobus/client/network/UdpClient.kt"
click node_mdns_client "https://github.com/abhinavagarwal31/iobus/blob/main/android/app/src/main/java/com/iobus/client/discovery/MdnsDiscovery.kt"
click node_saved_servers "https://github.com/abhinavagarwal31/iobus/blob/main/android/app/src/main/java/com/iobus/client/network/SavedServersStore.kt"
click node_connection_service "https://github.com/abhinavagarwal31/iobus/blob/main/android/app/src/main/java/com/iobus/client/service/ConnectionService.kt"
click node_protocol_messages "https://github.com/abhinavagarwal31/iobus/blob/main/protocol/messages.py"
click node_android_messages "https://github.com/abhinavagarwal31/iobus/blob/main/android/app/src/main/java/com/iobus/client/protocol/Messages.kt"
click node_server_main "https://github.com/abhinavagarwal31/iobus/blob/main/server/main.py"
click node_server_config "https://github.com/abhinavagarwal31/iobus/blob/main/server/config.py"
click node_server_discovery "https://github.com/abhinavagarwal31/iobus/blob/main/server/discovery.py"
click node_tcp_server "https://github.com/abhinavagarwal31/iobus/blob/main/server/transport/tcp_server.py"
click node_udp_server "https://github.com/abhinavagarwal31/iobus/blob/main/server/transport/udp_server.py"
click node_authenticator "https://github.com/abhinavagarwal31/iobus/blob/main/server/auth.py"
click node_mouse_controller "https://github.com/abhinavagarwal31/iobus/blob/main/server/input/mouse.py"
click node_keyboard_controller "https://github.com/abhinavagarwal31/iobus/blob/main/server/input/keyboard.py"
click node_system_actions "https://github.com/abhinavagarwal31/iobus/blob/main/server/input/actions.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_main_activity,node_connection_screen,node_control_screen,node_keyboard_panel,node_controls_panel,node_user toneBlue
class node_touch_processor,node_key_processor,node_connection_manager,node_tcp_client,node_udp_client,node_mdns_client,node_saved_servers,node_connection_service toneAmber
class node_protocol_messages,node_android_messages toneMint
class node_server_main,node_server_config,node_server_discovery,node_tcp_server,node_udp_server,node_authenticator,node_mouse_controller,node_keyboard_controller,node_system_actions toneRose
class node_macos,node_lan toneIndigo
```

## Components

### Android experience

- [App navigation](https://github.com/abhinavagarwal31/iobus/blob/main/android/app/src/main/java/com/iobus/client/MainActivity.kt): `android/app/src/main/java/com/iobus/client/MainActivity.kt`
- [Connection screen](https://github.com/abhinavagarwal31/iobus/blob/main/android/app/src/main/java/com/iobus/client/ui/connection/ConnectionScreen.kt): `android/app/src/main/java/com/iobus/client/ui/connection/ConnectionScreen.kt`
- [Control screen](https://github.com/abhinavagarwal31/iobus/blob/main/android/app/src/main/java/com/iobus/client/ui/control/ControlScreen.kt): `android/app/src/main/java/com/iobus/client/ui/control/ControlScreen.kt`
- [Keyboard panel](https://github.com/abhinavagarwal31/iobus/blob/main/android/app/src/main/java/com/iobus/client/ui/control/KeyboardPanel.kt): `android/app/src/main/java/com/iobus/client/ui/control/KeyboardPanel.kt`
- [Control center](https://github.com/abhinavagarwal31/iobus/blob/main/android/app/src/main/java/com/iobus/client/ui/control/ControlsPanel.kt): `android/app/src/main/java/com/iobus/client/ui/control/ControlsPanel.kt`

### Android runtime

- [Touch processor](https://github.com/abhinavagarwal31/iobus/blob/main/android/app/src/main/java/com/iobus/client/input/TouchProcessor.kt): `android/app/src/main/java/com/iobus/client/input/TouchProcessor.kt`
- [Key processor](https://github.com/abhinavagarwal31/iobus/blob/main/android/app/src/main/java/com/iobus/client/input/KeyProcessor.kt): `android/app/src/main/java/com/iobus/client/input/KeyProcessor.kt`
- [Connection manager](https://github.com/abhinavagarwal31/iobus/blob/main/android/app/src/main/java/com/iobus/client/network/ConnectionManager.kt): `android/app/src/main/java/com/iobus/client/network/ConnectionManager.kt`
- [TCP client](https://github.com/abhinavagarwal31/iobus/blob/main/android/app/src/main/java/com/iobus/client/network/TcpClient.kt): `android/app/src/main/java/com/iobus/client/network/TcpClient.kt`
- [UDP client](https://github.com/abhinavagarwal31/iobus/blob/main/android/app/src/main/java/com/iobus/client/network/UdpClient.kt): `android/app/src/main/java/com/iobus/client/network/UdpClient.kt`
- [mDNS discovery](https://github.com/abhinavagarwal31/iobus/blob/main/android/app/src/main/java/com/iobus/client/discovery/MdnsDiscovery.kt): `android/app/src/main/java/com/iobus/client/discovery/MdnsDiscovery.kt`
- [Saved servers](https://github.com/abhinavagarwal31/iobus/blob/main/android/app/src/main/java/com/iobus/client/network/SavedServersStore.kt): `android/app/src/main/java/com/iobus/client/network/SavedServersStore.kt`
- [Background service](https://github.com/abhinavagarwal31/iobus/blob/main/android/app/src/main/java/com/iobus/client/service/ConnectionService.kt): `android/app/src/main/java/com/iobus/client/service/ConnectionService.kt`

### Shared protocol

- [Binary messages](https://github.com/abhinavagarwal31/iobus/blob/main/protocol/messages.py): `protocol/messages.py`
- [Android messages](https://github.com/abhinavagarwal31/iobus/blob/main/android/app/src/main/java/com/iobus/client/protocol/Messages.kt): `android/app/src/main/java/com/iobus/client/protocol/Messages.kt`

### macOS server

- [Server startup](https://github.com/abhinavagarwal31/iobus/blob/main/server/main.py): `server/main.py`
- [Server configuration](https://github.com/abhinavagarwal31/iobus/blob/main/server/config.py): `server/config.py`
- [mDNS advertiser](https://github.com/abhinavagarwal31/iobus/blob/main/server/discovery.py): `server/discovery.py`
- [TCP control server](https://github.com/abhinavagarwal31/iobus/blob/main/server/transport/tcp_server.py): `server/transport/tcp_server.py`
- [UDP data server](https://github.com/abhinavagarwal31/iobus/blob/main/server/transport/udp_server.py): `server/transport/udp_server.py`
- [PIN authentication](https://github.com/abhinavagarwal31/iobus/blob/main/server/auth.py): `server/auth.py`
- [Mouse injection](https://github.com/abhinavagarwal31/iobus/blob/main/server/input/mouse.py): `server/input/mouse.py`
- [Keyboard injection](https://github.com/abhinavagarwal31/iobus/blob/main/server/input/keyboard.py): `server/input/keyboard.py`
- [System actions and status](https://github.com/abhinavagarwal31/iobus/blob/main/server/input/actions.py): `server/input/actions.py`

### Other components

- **Phone user**
- **macOS system**
- **Local Wi-Fi**

## Connections

- Phone user → App navigation: uses (evidence: `README.md`)
- App navigation → Connection screen: navigates (evidence: `android/app/src/main/java/com/iobus/client/MainActivity.kt`)
- App navigation → Control screen: navigates (evidence: `android/app/src/main/java/com/iobus/client/MainActivity.kt`)
- App navigation → Connection manager: connects (evidence: `android/app/src/main/java/com/iobus/client/MainActivity.kt`)
- App navigation → Saved servers: loads presets (evidence: `android/app/src/main/java/com/iobus/client/MainActivity.kt`)
- App navigation → Background service: starts (evidence: `android/app/src/main/java/com/iobus/client/MainActivity.kt`)
- Connection screen → Connection manager: connects (evidence: `android/app/src/main/java/com/iobus/client/ui/connection/ConnectionScreen.kt`)
- Connection screen → mDNS discovery: discovers (evidence: `README.md`)
- Control screen → Touch processor: handles touch (evidence: `android/app/src/main/java/com/iobus/client/ui/control/ControlScreen.kt`)
- Control screen → Key processor: handles keys (evidence: `android/app/src/main/java/com/iobus/client/ui/control/ControlScreen.kt`)
- Control screen → Keyboard panel: renders (evidence: `android/app/src/main/java/com/iobus/client/ui/control/ControlScreen.kt`)
- Control screen → Control center: renders (evidence: `android/app/src/main/java/com/iobus/client/ui/control/ControlScreen.kt`)
- Control screen → Connection manager: reads status (evidence: `android/app/src/main/java/com/iobus/client/ui/control/ControlScreen.kt`)
- Touch processor → Connection manager: sends input (evidence: `android/app/src/main/java/com/iobus/client/input/TouchProcessor.kt`)
- Key processor → Connection manager: sends input (evidence: `android/app/src/main/java/com/iobus/client/input/KeyProcessor.kt`)
- Control center → Connection manager: sends actions (evidence: `android/app/src/main/java/com/iobus/client/ui/control/ControlsPanel.kt`)
- Connection manager → TCP client: opens control (evidence: `android/app/src/main/java/com/iobus/client/network/ConnectionManager.kt`)
- Connection manager → UDP client: opens data (evidence: `android/app/src/main/java/com/iobus/client/network/ConnectionManager.kt`)
- Connection manager → Saved servers: persists server (evidence: `android/app/src/main/java/com/iobus/client/network/ConnectionManager.kt`)
- TCP client → Android messages: encodes control (evidence: `android/app/src/main/java/com/iobus/client/network/TcpClient.kt`)
- UDP client → Local Wi-Fi: sends UDP (evidence: `README.md`)
- TCP client → Local Wi-Fi: sends TCP (evidence: `README.md`)
- Android messages → Binary messages: mirrors format (evidence: `README.md`)
- Local Wi-Fi → Server startup: reaches server (evidence: `README.md`)
- Server startup → Server configuration: builds config (evidence: `server/main.py`)
- Server startup → TCP control server: starts (evidence: `server/main.py`)
- Server startup → UDP data server: starts (evidence: `server/main.py`)
- Server startup → mDNS advertiser: starts (evidence: `server/main.py`)
- Server startup → PIN authentication: configures (evidence: `server/main.py`)
- TCP control server → PIN authentication: verifies PIN (evidence: `server/transport/tcp_server.py`)
- TCP control server → System actions and status: reads status (evidence: `server/transport/tcp_server.py`)
- UDP data server → Mouse injection: dispatches mouse (evidence: `server/transport/udp_server.py`)
- UDP data server → Keyboard injection: dispatches keys (evidence: `server/transport/udp_server.py`)
- UDP data server → System actions and status: dispatches actions (evidence: `server/transport/udp_server.py`)
- System actions and status → Keyboard injection: composes shortcuts (evidence: `server/input/actions.py`)
- Mouse injection → macOS system: injects events (evidence: `README.md`)
- Keyboard injection → macOS system: injects events (evidence: `README.md`)
- System actions and status → macOS system: controls and reads (evidence: `README.md`)
- mDNS advertiser → Local Wi-Fi: advertises service (evidence: `README.md`)
- Server configuration → TCP control server: sets listener (evidence: `server/transport/tcp_server.py`)
- Server configuration → UDP data server: sets listener (evidence: `server/transport/udp_server.py`)
