# noobishsvk/fm-dx-webserver architecture

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

- Interactive diagram: https://gitdiagram.com/noobishsvk/fm-dx-webserver
- Repository: https://github.com/noobishsvk/fm-dx-webserver

## Overview

FM-DX Webserver lets DXers control a radio receiver through a browser, receive live tuner/RDS data, identify stations, and listen to low-latency audio. The server entry point starts HTTP/WebSocket services and coordinates receiver data, configuration, plugins, chat, and audio streaming; browser code supplies the user interface and 3LAS playback. The README documents device and plugin support, but sampled excerpts do not show every device integration or browser request path, so those links are not inferred.

Main entry points: [`server/index.js`](https://github.com/noobishsvk/fm-dx-webserver/blob/main/server/index.js) (Server coordinator), [`server/endpoints.js`](https://github.com/noobishsvk/fm-dx-webserver/blob/main/server/endpoints.js) (HTTP routes), [`server/datahandler.js`](https://github.com/noobishsvk/fm-dx-webserver/blob/main/server/datahandler.js) (Tuner and RDS data), [`server/stream/index.js`](https://github.com/noobishsvk/fm-dx-webserver/blob/main/server/stream/index.js) (Audio capture)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Browser experience"]
  node_ui["Control interface<br/>[main.js]"]
  node_browserchat["Browser chat<br/>[chat.js]"]
  node_browserplugins["Plugin interface<br/>[plugins.js]"]
  node_player["3LAS playback<br/>[3las.js]"]
end

subgraph group_server["Server services"]
  node_entry["Server coordinator<br/>[index.js]"]
  node_routes["HTTP routes<br/>[endpoints.js]"]
  node_chat["Chat service<br/>[chat.js]"]
  node_plugins["Plugin manager<br/>[plugins.js]"]
  node_pluginapi["Plugin API<br/>[plugins_api.js]"]
  node_tunnel["Remote tunnel<br/>[tunnel.js]"]
  node_fmdx["FM-DX list<br/>[fmdx_list.js]"]
end

subgraph group_radio["Receiver and DX data"]
  node_receiver["Receiver protocol<br/>[receiver.js]"]
  node_data["Tuner and RDS data<br/>[datahandler.js]"]
  node_tx["Transmitter search<br/>[tx_search.js]"]
  node_profiles["Tuner profiles<br/>[tuner_profiles.js]"]
end

subgraph group_audio["Audio streaming"]
  node_stream["Audio capture<br/>[index.js]"]
  node_streamserver["3LAS server<br/>[3las.server.js]"]
  node_streamparser["Device discovery<br/>[parser.js]"]
  node_ffmpeg["FFmpeg selection<br/>[checkFFmpeg.js]"]
end

subgraph group_state["Configuration and state"]
  node_config["Server configuration<br/>[server_config.js]"]
  node_storage[("Session state<br/>[storage.js]")]
end

node_dxer(("DXer"))

node_dxer -->|"controls receiver"| node_ui
node_entry -->|"mounts routes"| node_routes
node_entry -->|"starts streaming"| node_stream
node_entry -->|"initializes chat"| node_chat
node_entry -->|"initializes API"| node_pluginapi
node_entry -->|"initializes plugins"| node_plugins
node_entry -->|"initializes tunnel"| node_tunnel
node_entry -->|"updates list"| node_fmdx
node_entry -->|"serves static files"| node_ui
node_routes -->|"reads tuner data"| node_data
node_routes -->|"uses profiles"| node_profiles
node_routes -->|"uses plugins"| node_plugins
node_data -->|"creates receiver"| node_receiver
node_data -->|"fetches transmitter data"| node_tx
node_stream -->|"selects executable"| node_ffmpeg
node_stream -->|"feeds audio"| node_streamserver
node_streamparser -->|"enumerates devices"| node_ffmpeg
node_dxer -->|"listens to stream"| node_player

click node_ui "https://github.com/noobishsvk/fm-dx-webserver/blob/main/web/js/main.js"
click node_browserchat "https://github.com/noobishsvk/fm-dx-webserver/blob/main/web/js/chat.js"
click node_browserplugins "https://github.com/noobishsvk/fm-dx-webserver/blob/main/web/js/plugins.js"
click node_player "https://github.com/noobishsvk/fm-dx-webserver/blob/main/web/js/3las/3las.js"
click node_entry "https://github.com/noobishsvk/fm-dx-webserver/blob/main/server/index.js"
click node_routes "https://github.com/noobishsvk/fm-dx-webserver/blob/main/server/endpoints.js"
click node_chat "https://github.com/noobishsvk/fm-dx-webserver/blob/main/server/chat.js"
click node_plugins "https://github.com/noobishsvk/fm-dx-webserver/blob/main/server/plugins.js"
click node_pluginapi "https://github.com/noobishsvk/fm-dx-webserver/blob/main/server/plugins_api.js"
click node_tunnel "https://github.com/noobishsvk/fm-dx-webserver/blob/main/server/tunnel.js"
click node_fmdx "https://github.com/noobishsvk/fm-dx-webserver/blob/main/server/fmdx_list.js"
click node_receiver "https://github.com/noobishsvk/fm-dx-webserver/blob/main/server/receiver.js"
click node_data "https://github.com/noobishsvk/fm-dx-webserver/blob/main/server/datahandler.js"
click node_tx "https://github.com/noobishsvk/fm-dx-webserver/blob/main/server/tx_search.js"
click node_profiles "https://github.com/noobishsvk/fm-dx-webserver/blob/main/server/tuner_profiles.js"
click node_stream "https://github.com/noobishsvk/fm-dx-webserver/blob/main/server/stream/index.js"
click node_streamserver "https://github.com/noobishsvk/fm-dx-webserver/blob/main/server/stream/3las.server.js"
click node_streamparser "https://github.com/noobishsvk/fm-dx-webserver/blob/main/server/stream/parser.js"
click node_ffmpeg "https://github.com/noobishsvk/fm-dx-webserver/blob/main/server/stream/checkFFmpeg.js"
click node_config "https://github.com/noobishsvk/fm-dx-webserver/blob/main/server/server_config.js"
click node_storage "https://github.com/noobishsvk/fm-dx-webserver/blob/main/server/storage.js"

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_ui,node_browserchat,node_browserplugins,node_player toneBlue
class node_entry,node_routes,node_chat,node_plugins,node_pluginapi,node_tunnel,node_fmdx toneAmber
class node_receiver,node_data,node_tx,node_profiles toneMint
class node_stream,node_streamserver,node_streamparser,node_ffmpeg toneRose
class node_config,node_storage,node_dxer toneIndigo
```

## Components

### Browser experience

- [Control interface](https://github.com/noobishsvk/fm-dx-webserver/blob/main/web/js/main.js): `web/js/main.js`
- [Browser chat](https://github.com/noobishsvk/fm-dx-webserver/blob/main/web/js/chat.js): `web/js/chat.js`
- [Plugin interface](https://github.com/noobishsvk/fm-dx-webserver/blob/main/web/js/plugins.js): `web/js/plugins.js`
- [3LAS playback](https://github.com/noobishsvk/fm-dx-webserver/blob/main/web/js/3las/3las.js): `web/js/3las/3las.js`

### Server services

- [Server coordinator](https://github.com/noobishsvk/fm-dx-webserver/blob/main/server/index.js): `server/index.js`
- [HTTP routes](https://github.com/noobishsvk/fm-dx-webserver/blob/main/server/endpoints.js): `server/endpoints.js`
- [Chat service](https://github.com/noobishsvk/fm-dx-webserver/blob/main/server/chat.js): `server/chat.js`
- [Plugin manager](https://github.com/noobishsvk/fm-dx-webserver/blob/main/server/plugins.js): `server/plugins.js`
- [Plugin API](https://github.com/noobishsvk/fm-dx-webserver/blob/main/server/plugins_api.js): `server/plugins_api.js`
- [Remote tunnel](https://github.com/noobishsvk/fm-dx-webserver/blob/main/server/tunnel.js): `server/tunnel.js`
- [FM-DX list](https://github.com/noobishsvk/fm-dx-webserver/blob/main/server/fmdx_list.js): `server/fmdx_list.js`

### Receiver and DX data

- [Receiver protocol](https://github.com/noobishsvk/fm-dx-webserver/blob/main/server/receiver.js): `server/receiver.js`
- [Tuner and RDS data](https://github.com/noobishsvk/fm-dx-webserver/blob/main/server/datahandler.js): `server/datahandler.js`
- [Transmitter search](https://github.com/noobishsvk/fm-dx-webserver/blob/main/server/tx_search.js): `server/tx_search.js`
- [Tuner profiles](https://github.com/noobishsvk/fm-dx-webserver/blob/main/server/tuner_profiles.js): `server/tuner_profiles.js`

### Audio streaming

- [Audio capture](https://github.com/noobishsvk/fm-dx-webserver/blob/main/server/stream/index.js): `server/stream/index.js`
- [3LAS server](https://github.com/noobishsvk/fm-dx-webserver/blob/main/server/stream/3las.server.js): `server/stream/3las.server.js`
- [Device discovery](https://github.com/noobishsvk/fm-dx-webserver/blob/main/server/stream/parser.js): `server/stream/parser.js`
- [FFmpeg selection](https://github.com/noobishsvk/fm-dx-webserver/blob/main/server/stream/checkFFmpeg.js): `server/stream/checkFFmpeg.js`

### Configuration and state

- [Server configuration](https://github.com/noobishsvk/fm-dx-webserver/blob/main/server/server_config.js): `server/server_config.js`
- [Session state](https://github.com/noobishsvk/fm-dx-webserver/blob/main/server/storage.js): `server/storage.js`

### Other components

- **DXer**

## Connections

- DXer → Control interface: controls receiver (evidence: `README.md`)
- Server coordinator → HTTP routes: mounts routes (evidence: `server/index.js`)
- Server coordinator → Audio capture: starts streaming (evidence: `server/index.js`)
- Server coordinator → Chat service: initializes chat (evidence: `server/index.js`)
- Server coordinator → Plugin API: initializes API (evidence: `server/index.js`)
- Server coordinator → Plugin manager: initializes plugins (evidence: `server/index.js`)
- Server coordinator → Remote tunnel: initializes tunnel (evidence: `server/index.js`)
- Server coordinator → FM-DX list: updates list (evidence: `server/index.js`)
- Server coordinator → Control interface: serves static files (evidence: `server/index.js`)
- HTTP routes → Tuner and RDS data: reads tuner data (evidence: `server/endpoints.js`)
- HTTP routes → Tuner profiles: uses profiles (evidence: `server/endpoints.js`)
- HTTP routes → Plugin manager: uses plugins (evidence: `server/endpoints.js`)
- Tuner and RDS data → Receiver protocol: creates receiver (evidence: `server/datahandler.js`)
- Tuner and RDS data → Transmitter search: fetches transmitter data (evidence: `server/datahandler.js`)
- Audio capture → FFmpeg selection: selects executable (evidence: `server/stream/index.js`)
- Audio capture → 3LAS server: feeds audio (evidence: `server/stream/index.js`)
- Device discovery → FFmpeg selection: enumerates devices (evidence: `server/stream/parser.js`)
- DXer → 3LAS playback: listens to stream (evidence: `README.md`)
