How luarvique/openwebrx works
OpenWebRX+ is a multi-user web-based software-defined radio receiver. The main workflow is that an operator configures an SDR, listeners tune and select demodulation in the browser, and the server runs a source and processing chain whose audio and spectrum data are presented to listeners. The README also documents diverse decoders, recording, scanning, chat, maps, reporting, and administration. Several relationships below are documented at product level; unsampled wiring is shown as dashed with no evidence path rather than asserted as a verified call.
Main entry points: service/__init__.py Service manager · openwebrx.js Receiver interface · websocket.py WebSocket controller · source/__init__.py SDR sources
Components 23
Receiver runtime
- WebSocket controller
owrx/controllers/websocket.py - SDR sources
owrx/source/__init__.py - Service manager
owrx/service/__init__.py - Signal chains
csdr/chain - Decoder modules
csdr/module - Audio recording
owrx/audio/queue.py
Browser experience
- Browser audio
htdocs/lib/AudioEngine.js - Receiver interface
htdocs/openwebrx.js - Map interface
htdocs/lib/MapManager.js - Bookmarks and scanner
owrx/bookmarks.py
Operations and configuration
- Configuration
owrx/config/__init__.py - Settings controllers
owrx/controllers/settings - Client registry
owrx/client.py - Client administration
owrx/controllers/clients.py
Maps and reporting
- Aircraft tracking
owrx/aircraft/manager.py - Map and band data
owrx/map.py - Reporting engine
owrx/reporting/__init__.py - Reporting integrations
owrx/reporting - Broadcast and receiver data
owrx/web/eibi.py
Other components
- Receiver operator
- Radio listener
- SDR hardware
- Reporting services
Connections 22
- Receiver operator → Settings controllers: configures
- Settings controllers → Configuration: updates
- Radio listener → Receiver interface: tunes
- Receiver interface → WebSocket controller: sends controls
- WebSocket controller → Service manager: dispatches tuning
- Service manager → SDR sources: uses sources
owrx/service/__init__.py - SDR sources → SDR hardware: controls hardware
- Service manager → Signal chains: constructs processing
owrx/service/__init__.py - Signal chains → Decoder modules: runs demodulation
- Service manager → Configuration: reads settings
owrx/service/__init__.py - WebSocket controller → Browser audio: streams audio
- Browser audio → Radio listener: plays audio
- Receiver interface → Map interface: renders maps
- Aircraft tracking → Map and band data: updates locations
owrx/aircraft/manager.py - Map interface → Map and band data: presents map data
- Receiver interface → Bookmarks and scanner: uses bookmarks
- Service manager → Audio recording: supports recording
- Client administration → Client registry: bans clients
owrx/controllers/clients.py - Client registry → Reporting engine: reports client events
owrx/client.py - Reporting engine → Reporting integrations: dispatches spots
owrx/reporting/__init__.py - Reporting integrations → Reporting services: uploads reports
- Service manager → Broadcast and receiver data: lists services