How abhinavagarwal31/iobus works
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: ConnectionManager.kt Connection manager · MainActivity.kt App navigation · ControlScreen.kt Control screen · main.py Server startup
Components 27
Android experience
- App navigation
android/app/src/main/java/com/iobus/client/MainActivity.kt - Connection screen
android/app/src/main/java/com/iobus/client/ui/connection/ConnectionScreen.kt - Control screen
android/app/src/main/java/com/iobus/client/ui/control/ControlScreen.kt - Keyboard panel
android/app/src/main/java/com/iobus/client/ui/control/KeyboardPanel.kt - Control center
android/app/src/main/java/com/iobus/client/ui/control/ControlsPanel.kt
Android runtime
- Touch processor
android/app/src/main/java/com/iobus/client/input/TouchProcessor.kt - Key processor
android/app/src/main/java/com/iobus/client/input/KeyProcessor.kt - Connection manager
android/app/src/main/java/com/iobus/client/network/ConnectionManager.kt - TCP client
android/app/src/main/java/com/iobus/client/network/TcpClient.kt - UDP client
android/app/src/main/java/com/iobus/client/network/UdpClient.kt - mDNS discovery
android/app/src/main/java/com/iobus/client/discovery/MdnsDiscovery.kt - Saved servers
android/app/src/main/java/com/iobus/client/network/SavedServersStore.kt - Background service
android/app/src/main/java/com/iobus/client/service/ConnectionService.kt
Shared protocol
- Binary messages
protocol/messages.py - Android messages
android/app/src/main/java/com/iobus/client/protocol/Messages.kt
macOS server
- Server startup
server/main.py - Server configuration
server/config.py - mDNS advertiser
server/discovery.py - TCP control server
server/transport/tcp_server.py - UDP data server
server/transport/udp_server.py - PIN authentication
server/auth.py - Mouse injection
server/input/mouse.py - Keyboard injection
server/input/keyboard.py - System actions and status
server/input/actions.py
Other components
- Phone user
- macOS system
- Local Wi-Fi
Connections 41
- Phone user → App navigation: uses
README.md - App navigation → Connection screen: navigates
android/app/src/main/java/com/iobus/client/MainActivity.kt - App navigation → Control screen: navigates
android/app/src/main/java/com/iobus/client/MainActivity.kt - App navigation → Connection manager: connects
android/app/src/main/java/com/iobus/client/MainActivity.kt - App navigation → Saved servers: loads presets
android/app/src/main/java/com/iobus/client/MainActivity.kt - App navigation → Background service: starts
android/app/src/main/java/com/iobus/client/MainActivity.kt - Connection screen → Connection manager: connects
android/app/src/main/java/com/iobus/client/ui/connection/ConnectionScreen.kt - Connection screen → mDNS discovery: discovers
README.md - Control screen → Touch processor: handles touch
android/app/src/main/java/com/iobus/client/ui/control/ControlScreen.kt - Control screen → Key processor: handles keys
android/app/src/main/java/com/iobus/client/ui/control/ControlScreen.kt - Control screen → Keyboard panel: renders
android/app/src/main/java/com/iobus/client/ui/control/ControlScreen.kt - Control screen → Control center: renders
android/app/src/main/java/com/iobus/client/ui/control/ControlScreen.kt - Control screen → Connection manager: reads status
android/app/src/main/java/com/iobus/client/ui/control/ControlScreen.kt - Touch processor → Connection manager: sends input
android/app/src/main/java/com/iobus/client/input/TouchProcessor.kt - Key processor → Connection manager: sends input
android/app/src/main/java/com/iobus/client/input/KeyProcessor.kt - Control center → Connection manager: sends actions
android/app/src/main/java/com/iobus/client/ui/control/ControlsPanel.kt - Connection manager → TCP client: opens control
android/app/src/main/java/com/iobus/client/network/ConnectionManager.kt - Connection manager → UDP client: opens data
android/app/src/main/java/com/iobus/client/network/ConnectionManager.kt - Connection manager → Saved servers: persists server
android/app/src/main/java/com/iobus/client/network/ConnectionManager.kt - TCP client → Android messages: encodes control
android/app/src/main/java/com/iobus/client/network/TcpClient.kt - UDP client → Local Wi-Fi: sends UDP
README.md - TCP client → Local Wi-Fi: sends TCP
README.md - Android messages → Binary messages: mirrors format
README.md - Local Wi-Fi → Server startup: reaches server
README.md - Server startup → Server configuration: builds config
server/main.py - Server startup → TCP control server: starts
server/main.py - Server startup → UDP data server: starts
server/main.py - Server startup → mDNS advertiser: starts
server/main.py - Server startup → PIN authentication: configures
server/main.py - TCP control server → PIN authentication: verifies PIN
server/transport/tcp_server.py - TCP control server → System actions and status: reads status
server/transport/tcp_server.py - UDP data server → Mouse injection: dispatches mouse
server/transport/udp_server.py - UDP data server → Keyboard injection: dispatches keys
server/transport/udp_server.py - UDP data server → System actions and status: dispatches actions
server/transport/udp_server.py - System actions and status → Keyboard injection: composes shortcuts
server/input/actions.py - Mouse injection → macOS system: injects events
README.md - Keyboard injection → macOS system: injects events
README.md - System actions and status → macOS system: controls and reads
README.md - mDNS advertiser → Local Wi-Fi: advertises service
README.md - Server configuration → TCP control server: sets listener
server/transport/tcp_server.py - Server configuration → UDP data server: sets listener
server/transport/udp_server.py