# luarvique/openwebrx architecture

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

- Interactive diagram: https://gitdiagram.com/luarvique/openwebrx
- Repository: https://github.com/luarvique/openwebrx

## Overview

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: [`owrx/service/__init__.py`](https://github.com/luarvique/openwebrx/blob/master/owrx/service/__init__.py) (Service manager), [`htdocs/openwebrx.js`](https://github.com/luarvique/openwebrx/blob/master/htdocs/openwebrx.js) (Receiver interface), [`owrx/controllers/websocket.py`](https://github.com/luarvique/openwebrx/blob/master/owrx/controllers/websocket.py) (WebSocket controller), [`owrx/source/__init__.py`](https://github.com/luarvique/openwebrx/blob/master/owrx/source/__init__.py) (SDR sources)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_receiver["Receiver runtime"]
  node_websocket["WebSocket controller<br/>[websocket.py]"]
  node_source["SDR sources<br/>[__init__.py]"]
  node_service["Service manager<br/>[__init__.py]"]
  node_signalchains["Signal chains"]
  node_decoders["Decoder modules"]
  node_recording["Audio recording<br/>[queue.py]"]
end

subgraph group_browser["Browser experience"]
  node_audio["Browser audio<br/>[AudioEngine.js]"]
  node_browserui["Receiver interface<br/>[openwebrx.js]"]
  node_mapui["Map interface<br/>[MapManager.js]"]
  node_bookmarks["Bookmarks and scanner<br/>[bookmarks.py]"]
end

subgraph group_operations["Operations and configuration"]
  node_configuration["Configuration<br/>[__init__.py]"]
  node_settings["Settings controllers"]
  node_clients["Client registry<br/>[client.py]"]
  node_admin["Client administration<br/>[clients.py]"]
end

subgraph group_data["Maps and reporting"]
  node_aircraft["Aircraft tracking<br/>[manager.py]"]
  node_mapdata["Map and band data<br/>[map.py]"]
  node_reporting["Reporting engine<br/>[__init__.py]"]
  node_reporters["Reporting integrations"]
  node_servicesdata["Broadcast and receiver data<br/>[eibi.py]"]
end

node_operator(("Receiver operator"))
node_listener(("Radio listener"))
node_sdr["SDR hardware"]
node_externalreports["Reporting services"]

node_operator -.->|"configures"| node_settings
node_settings -.->|"updates"| node_configuration
node_listener -.->|"tunes"| node_browserui
node_browserui -.->|"sends controls"| node_websocket
node_websocket -.->|"dispatches tuning"| node_service
node_service -->|"uses sources"| node_source
node_source -.->|"controls hardware"| node_sdr
node_service -->|"constructs processing"| node_signalchains
node_signalchains -.->|"runs demodulation"| node_decoders
node_service -->|"reads settings"| node_configuration
node_websocket -.->|"streams audio"| node_audio
node_audio -.->|"plays audio"| node_listener
node_browserui -.->|"renders maps"| node_mapui
node_aircraft -->|"updates locations"| node_mapdata
node_mapui -.->|"presents map data"| node_mapdata
node_browserui -.->|"uses bookmarks"| node_bookmarks
node_service -.->|"supports recording"| node_recording
node_admin -->|"bans clients"| node_clients
node_clients -->|"reports client events"| node_reporting
node_reporting -->|"dispatches spots"| node_reporters
node_reporters -.->|"uploads reports"| node_externalreports
node_service -.->|"lists services"| node_servicesdata

click node_configuration "https://github.com/luarvique/openwebrx/blob/master/owrx/config/__init__.py"
click node_settings "https://github.com/luarvique/openwebrx/tree/master/owrx/controllers/settings"
click node_websocket "https://github.com/luarvique/openwebrx/blob/master/owrx/controllers/websocket.py"
click node_source "https://github.com/luarvique/openwebrx/blob/master/owrx/source/__init__.py"
click node_service "https://github.com/luarvique/openwebrx/blob/master/owrx/service/__init__.py"
click node_signalchains "https://github.com/luarvique/openwebrx/tree/master/csdr/chain"
click node_decoders "https://github.com/luarvique/openwebrx/tree/master/csdr/module"
click node_audio "https://github.com/luarvique/openwebrx/blob/master/htdocs/lib/AudioEngine.js"
click node_browserui "https://github.com/luarvique/openwebrx/blob/master/htdocs/openwebrx.js"
click node_mapui "https://github.com/luarvique/openwebrx/blob/master/htdocs/lib/MapManager.js"
click node_clients "https://github.com/luarvique/openwebrx/blob/master/owrx/client.py"
click node_admin "https://github.com/luarvique/openwebrx/blob/master/owrx/controllers/clients.py"
click node_aircraft "https://github.com/luarvique/openwebrx/blob/master/owrx/aircraft/manager.py"
click node_mapdata "https://github.com/luarvique/openwebrx/blob/master/owrx/map.py"
click node_reporting "https://github.com/luarvique/openwebrx/blob/master/owrx/reporting/__init__.py"
click node_reporters "https://github.com/luarvique/openwebrx/tree/master/owrx/reporting"
click node_recording "https://github.com/luarvique/openwebrx/blob/master/owrx/audio/queue.py"
click node_bookmarks "https://github.com/luarvique/openwebrx/blob/master/owrx/bookmarks.py"
click node_servicesdata "https://github.com/luarvique/openwebrx/blob/master/owrx/web/eibi.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_websocket,node_source,node_service,node_signalchains,node_decoders,node_recording toneBlue
class node_audio,node_browserui,node_mapui,node_bookmarks toneAmber
class node_configuration,node_settings,node_clients,node_admin toneMint
class node_aircraft,node_mapdata,node_reporting,node_reporters,node_servicesdata toneRose
class node_operator,node_listener,node_sdr,node_externalreports toneIndigo
```

## Components

### Receiver runtime

- [WebSocket controller](https://github.com/luarvique/openwebrx/blob/master/owrx/controllers/websocket.py): `owrx/controllers/websocket.py`
- [SDR sources](https://github.com/luarvique/openwebrx/blob/master/owrx/source/__init__.py): `owrx/source/__init__.py`
- [Service manager](https://github.com/luarvique/openwebrx/blob/master/owrx/service/__init__.py): `owrx/service/__init__.py`
- [Signal chains](https://github.com/luarvique/openwebrx/tree/master/csdr/chain): `csdr/chain`
- [Decoder modules](https://github.com/luarvique/openwebrx/tree/master/csdr/module): `csdr/module`
- [Audio recording](https://github.com/luarvique/openwebrx/blob/master/owrx/audio/queue.py): `owrx/audio/queue.py`

### Browser experience

- [Browser audio](https://github.com/luarvique/openwebrx/blob/master/htdocs/lib/AudioEngine.js): `htdocs/lib/AudioEngine.js`
- [Receiver interface](https://github.com/luarvique/openwebrx/blob/master/htdocs/openwebrx.js): `htdocs/openwebrx.js`
- [Map interface](https://github.com/luarvique/openwebrx/blob/master/htdocs/lib/MapManager.js): `htdocs/lib/MapManager.js`
- [Bookmarks and scanner](https://github.com/luarvique/openwebrx/blob/master/owrx/bookmarks.py): `owrx/bookmarks.py`

### Operations and configuration

- [Configuration](https://github.com/luarvique/openwebrx/blob/master/owrx/config/__init__.py): `owrx/config/__init__.py`
- [Settings controllers](https://github.com/luarvique/openwebrx/tree/master/owrx/controllers/settings): `owrx/controllers/settings`
- [Client registry](https://github.com/luarvique/openwebrx/blob/master/owrx/client.py): `owrx/client.py`
- [Client administration](https://github.com/luarvique/openwebrx/blob/master/owrx/controllers/clients.py): `owrx/controllers/clients.py`

### Maps and reporting

- [Aircraft tracking](https://github.com/luarvique/openwebrx/blob/master/owrx/aircraft/manager.py): `owrx/aircraft/manager.py`
- [Map and band data](https://github.com/luarvique/openwebrx/blob/master/owrx/map.py): `owrx/map.py`
- [Reporting engine](https://github.com/luarvique/openwebrx/blob/master/owrx/reporting/__init__.py): `owrx/reporting/__init__.py`
- [Reporting integrations](https://github.com/luarvique/openwebrx/tree/master/owrx/reporting): `owrx/reporting`
- [Broadcast and receiver data](https://github.com/luarvique/openwebrx/blob/master/owrx/web/eibi.py): `owrx/web/eibi.py`

### Other components

- **Receiver operator**
- **Radio listener**
- **SDR hardware**
- **Reporting services**

## Connections

- 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 (evidence: `owrx/service/__init__.py`)
- SDR sources → SDR hardware: controls hardware
- Service manager → Signal chains: constructs processing (evidence: `owrx/service/__init__.py`)
- Signal chains → Decoder modules: runs demodulation
- Service manager → Configuration: reads settings (evidence: `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 (evidence: `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 (evidence: `owrx/controllers/clients.py`)
- Client registry → Reporting engine: reports client events (evidence: `owrx/client.py`)
- Reporting engine → Reporting integrations: dispatches spots (evidence: `owrx/reporting/__init__.py`)
- Reporting integrations → Reporting services: uploads reports
- Service manager → Broadcast and receiver data: lists services
