How saprecar/otter works
Otter turns an Android camera or mobile-browser camera into a PC webcam, with desktop controls for connection, camera settings, backgrounds, and virtual-camera output. The principal workflow is mobile capture and streaming, desktop reception and frame processing, then delivery to an OS virtual camera or browser stream. The repository also contains a browser-based controller/streamer and duplicated stable desktop and Android editions. Edges reflect shown imports and calls or README-described behavior; unsampled web and Android internals are represented cautiously.
Main entry points: cambridge_receiver.py Stream Receiver · otter_web_server.py Web Controller · otter_app.py Desktop Controller · OtterStreamService.java Android Stream Service
Components 18
Mobile Capture
- Android Camera App
Dev/android/app/src/main/java/org/understory/cambridge/MainActivity.java - Android Stream Service
Dev/android/app/src/main/java/org/understory/cambridge/OtterStreamService.java - Mobile Web Streamer
Dev/desktop/otter_web_server.py - Stable Android Editions
Stable/stable_playstore_version/app/src/main/java/org/understory/cambridge/MainActivity.java
Desktop Control
- Desktop Controller
Dev/desktop/otter_app.py - Web Controller
Dev/desktop/otter_web_server.py - Network Discovery
Dev/desktop/network_discovery.py - ADB Management
Dev/desktop/manage_adb.py - Stable Desktop Edition
Stable/Stable_Desktop_Client
Connection and Receive
- ADB Tunnel
Dev/desktop/adb_tunnel.py - Stream Receiver
Dev/desktop/cambridge_receiver.py - Camera Control Client
Dev/desktop/cambridge_control.py - Background Processing
Dev/desktop/cambridge_receiver.py
Video Outputs
- Linux V4L2 Bridge
Dev/desktop/driver/linux_v4l2_bridge.py - OBS Camera Bridge
Dev/desktop/driver/obs_virtualcam_bridge.py - Unity Camera Bridge
Dev/desktop/driver/unity_capture_bridge.py
Other components
- User
- Video Applications
Connections 25
- User → Android Camera App: configures camera
README.md - Android Camera App → Android Stream Service: starts streaming
- Android Stream Service → Stream Receiver: streams video
README.md - User → Mobile Web Streamer: opens streamer
README.md - Mobile Web Streamer → Web Controller: sends camera frames
README.md - User → Desktop Controller: controls session
README.md - Desktop Controller → Stream Receiver: starts receiver
Dev/desktop/otter_app.py - Desktop Controller → Web Controller: launches controller
Dev/desktop/otter_app.py - Desktop Controller → Network Discovery: detects network
Dev/desktop/otter_app.py - Desktop Controller → ADB Management: manages ADB
Dev/desktop/otter_app.py - Web Controller → Stream Receiver: starts receiver
Dev/desktop/otter_web_server.py - Web Controller → ADB Tunnel: sets USB forwarding
Dev/desktop/otter_web_server.py - Web Controller → Network Discovery: detects adapters
Dev/desktop/otter_web_server.py - ADB Tunnel → ADB Management: locates portable ADB
Dev/desktop/adb_tunnel.py - Stream Receiver → Camera Control Client: queries device
Dev/desktop/cambridge_receiver.py - Stream Receiver → Background Processing: processes frames
Dev/desktop/cambridge_receiver.py - Stream Receiver → Linux V4L2 Bridge: writes frames
Dev/desktop/cambridge_receiver.py - Stream Receiver → OBS Camera Bridge: writes frames
Dev/desktop/cambridge_receiver.py - Stream Receiver → Unity Camera Bridge: writes frames
Dev/desktop/cambridge_receiver.py - Linux V4L2 Bridge → Video Applications: exposes webcam
README.md - OBS Camera Bridge → Video Applications: exposes webcam
README.md - Unity Camera Bridge → Video Applications: exposes webcam
README.md - Web Controller → Video Applications: serves MJPEG
README.md - Stable Desktop Edition → Stream Receiver: duplicates runtime
Stable/Stable_Desktop_Client/otter_app.py - Stable Android Editions → Android Stream Service: duplicates mobile app