# imamimam13/ninjaradio architecture

> Architecture diagram of the GitHub repository imamimam13/ninjaradio, 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/imamimam13/ninjaradio
- Repository: https://github.com/imamimam13/ninjaradio

## Overview

NinjaRadio is a multi-client digital/analog radio and VoIP platform. Radio clients and external radio/voice networks reach the core radio engine directly or through protocol bridges; web users reach frontend features backed by the FastAPI service and its database. The README documents the main service relationships and capabilities; source excerpts confirm selected Android, backend, and core behavior, but do not expose most bridge or frontend wiring.

Main entry points: [`backend/app/api/endpoints.py`](https://github.com/imamimam13/ninjaradio/blob/main/backend/app/api/endpoints.py) (REST and WebSocket API), [`core/core_engine.py`](https://github.com/imamimam13/ninjaradio/blob/main/core/core_engine.py) (Core DV Engine), [`backend/app/main.py`](https://github.com/imamimam13/ninjaradio/blob/main/backend/app/main.py) (Backend Runtime), [`core/dmr_server.py`](https://github.com/imamimam13/ninjaradio/blob/main/core/dmr_server.py) (DMR Master)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_clients["Radio Clients"]
  node_android_dmr["Android DMR"]
  node_lite_dmr["Lite DMR<br/>[DmrService.kt]"]
  node_svx_app["SvxLink Client"]
  node_svx_simple["Simple Svx Client"]
  node_pwa_app["PWA Shell<br/>[MainActivity.kt]"]
end

subgraph group_radio["Radio Core"]
  node_core_engine["Core DV Engine<br/>[core_engine.py]"]
  node_direct_dmr["Direct DMR<br/>[direct_dmr.py]"]
  node_dmr_server["DMR Master<br/>[dmr_server.py]"]
  node_dmr_codec["DMR Codec<br/>[dmr_codec.cpp]"]
end

subgraph group_gateways["Voice Gateways"]
  node_mumble_bridge["Mumble Bridge<br/>[bridge_mumble.py]"]
  node_svx_bridge["SvxLink Bridge<br/>[bridge_svxlink.py]"]
  node_zello_bridge["Zello Bridge<br/>[bridge_zello.py]"]
  node_teamspeak_bridge["TeamSpeak Bridge"]
end

subgraph group_web["Web Platform"]
  node_frontend["Web Interface"]
end

subgraph group_backend["Backend Services"]
  node_api["REST and WebSocket API<br/>[endpoints.py]"]
  node_backend_main["Backend Runtime<br/>[main.py]"]
  node_callbook["Callbook Service"]
  node_database[("SQLite Data<br/>[database.py]")]
  node_backend_bridges["Bridge Management<br/>[bridge_service.py]"]
  node_monitor["Live Monitor<br/>[dv_monitor.py]"]
  node_logbook["Logbook Service<br/>[logbook_service.py]"]
  node_selfcare["Account Services"]
  node_teamspeak_service["TeamSpeak Service"]
end

node_web_users(("Web Users"))
node_dmr_radios(("DMR Radios"))
node_analog_nodes(("Analog Nodes"))
node_mumble_users(("Mumble Users"))
node_zello_users(("Zello Users"))

node_web_users -->|"use"| node_frontend
node_frontend -->|"request API"| node_api
node_api -->|"serve routes"| node_backend_main
node_backend_main -->|"initialize"| node_database
node_backend_main -->|"register service"| node_callbook
node_callbook -->|"read and write"| node_database
node_api -.->|"provide telemetry"| node_monitor
node_api -.->|"provide logbook"| node_logbook
node_api -.->|"provide accounts"| node_selfcare
node_api -.->|"manage bridges"| node_backend_bridges
node_api -.->|"manage TeamSpeak"| node_teamspeak_service
node_backend_main -->|"send TX events"| node_core_engine
node_android_dmr -.->|"connect DMR"| node_dmr_server
node_lite_dmr -.->|"connect HomeBrew"| node_dmr_server
node_dmr_radios -->|"send UDP"| node_dmr_server
node_dmr_server -.->|"serve radio traffic"| node_core_engine
node_core_engine -->|"configure engine"| node_direct_dmr
node_core_engine -.->|"encode and decode"| node_dmr_codec
node_mumble_users -.->|"send voice"| node_mumble_bridge
node_mumble_bridge -->|"bridge NPTT audio"| node_core_engine
node_analog_nodes -.->|"send voice"| node_svx_bridge
node_svx_bridge -->|"bridge NSVX audio"| node_core_engine
node_zello_users -.->|"send voice"| node_zello_bridge
node_zello_bridge -->|"bridge audio"| node_core_engine
node_teamspeak_bridge -.->|"integrate service"| node_teamspeak_service
node_svx_app -.->|"connect reflector"| node_analog_nodes
node_svx_simple -.->|"connect reflector"| node_analog_nodes
node_pwa_app -.->|"open web app"| node_frontend

click node_android_dmr "https://github.com/imamimam13/ninjaradio/blob/main/app-android/app/src/main/java/com/ninjadmr/app/DmrForegroundService.kt"
click node_lite_dmr "https://github.com/imamimam13/ninjaradio/blob/main/app-lite/app/src/main/java/com/ninjadmr/lite/service/DmrService.kt"
click node_svx_app "https://github.com/imamimam13/ninjaradio/blob/main/app-svx/app/src/main/java/com/ninjaradio/svx/SvxReflectorClient.kt"
click node_svx_simple "https://github.com/imamimam13/ninjaradio/blob/main/app-svx-simple/app/src/main/java/com/ninjaradio/svx/SvxReflectorClient.kt"
click node_pwa_app "https://github.com/imamimam13/ninjaradio/blob/main/app-pwa/app/src/main/java/com/ninjadmr/pwa/MainActivity.kt"
click node_core_engine "https://github.com/imamimam13/ninjaradio/blob/main/core/core_engine.py"
click node_direct_dmr "https://github.com/imamimam13/ninjaradio/blob/main/core/direct_dmr.py"
click node_dmr_server "https://github.com/imamimam13/ninjaradio/blob/main/core/dmr_server.py"
click node_dmr_codec "https://github.com/imamimam13/ninjaradio/blob/main/core/opendmr/dmr_codec.cpp"
click node_mumble_bridge "https://github.com/imamimam13/ninjaradio/blob/main/bridge-mumble/bridge_mumble.py"
click node_svx_bridge "https://github.com/imamimam13/ninjaradio/blob/main/bridge-svxlink/bridge_svxlink.py"
click node_zello_bridge "https://github.com/imamimam13/ninjaradio/blob/main/bridge-zello/bridge_zello.py"
click node_teamspeak_bridge "https://github.com/imamimam13/ninjaradio/blob/main/bridge-teamspeak/plugins/NinjaRadioBridge.cs"
click node_frontend "https://github.com/imamimam13/ninjaradio/tree/main/frontend/src/app"
click node_api "https://github.com/imamimam13/ninjaradio/blob/main/backend/app/api/endpoints.py"
click node_backend_main "https://github.com/imamimam13/ninjaradio/blob/main/backend/app/main.py"
click node_callbook "https://github.com/imamimam13/ninjaradio/blob/main/backend/app/services/callbook_service.py"
click node_database "https://github.com/imamimam13/ninjaradio/blob/main/backend/app/core/database.py"
click node_backend_bridges "https://github.com/imamimam13/ninjaradio/blob/main/backend/app/services/bridge_service.py"
click node_monitor "https://github.com/imamimam13/ninjaradio/blob/main/backend/app/services/dv_monitor.py"
click node_logbook "https://github.com/imamimam13/ninjaradio/blob/main/backend/app/services/logbook_service.py"
click node_selfcare "https://github.com/imamimam13/ninjaradio/blob/main/backend/app/services/selfcare_service.py"
click node_teamspeak_service "https://github.com/imamimam13/ninjaradio/blob/main/backend/app/services/teamspeak_service.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_android_dmr,node_lite_dmr,node_svx_app,node_svx_simple,node_pwa_app,node_web_users,node_mumble_users,node_zello_users toneBlue
class node_core_engine,node_direct_dmr,node_dmr_server,node_dmr_codec toneAmber
class node_mumble_bridge,node_svx_bridge,node_zello_bridge,node_teamspeak_bridge toneMint
class node_frontend toneRose
class node_api,node_backend_main,node_callbook,node_database,node_backend_bridges,node_monitor,node_logbook,node_selfcare,node_teamspeak_service,node_dmr_radios,node_analog_nodes toneIndigo
```

## Components

### Radio Clients

- [Android DMR](https://github.com/imamimam13/ninjaradio/blob/main/app-android/app/src/main/java/com/ninjadmr/app/DmrForegroundService.kt): `app-android/app/src/main/java/com/ninjadmr/app/DmrForegroundService.kt`
- [Lite DMR](https://github.com/imamimam13/ninjaradio/blob/main/app-lite/app/src/main/java/com/ninjadmr/lite/service/DmrService.kt): `app-lite/app/src/main/java/com/ninjadmr/lite/service/DmrService.kt`
- [SvxLink Client](https://github.com/imamimam13/ninjaradio/blob/main/app-svx/app/src/main/java/com/ninjaradio/svx/SvxReflectorClient.kt): `app-svx/app/src/main/java/com/ninjaradio/svx/SvxReflectorClient.kt`
- [Simple Svx Client](https://github.com/imamimam13/ninjaradio/blob/main/app-svx-simple/app/src/main/java/com/ninjaradio/svx/SvxReflectorClient.kt): `app-svx-simple/app/src/main/java/com/ninjaradio/svx/SvxReflectorClient.kt`
- [PWA Shell](https://github.com/imamimam13/ninjaradio/blob/main/app-pwa/app/src/main/java/com/ninjadmr/pwa/MainActivity.kt): `app-pwa/app/src/main/java/com/ninjadmr/pwa/MainActivity.kt`

### Radio Core

- [Core DV Engine](https://github.com/imamimam13/ninjaradio/blob/main/core/core_engine.py): `core/core_engine.py`
- [Direct DMR](https://github.com/imamimam13/ninjaradio/blob/main/core/direct_dmr.py): `core/direct_dmr.py`
- [DMR Master](https://github.com/imamimam13/ninjaradio/blob/main/core/dmr_server.py): `core/dmr_server.py`
- [DMR Codec](https://github.com/imamimam13/ninjaradio/blob/main/core/opendmr/dmr_codec.cpp): `core/opendmr/dmr_codec.cpp`

### Voice Gateways

- [Mumble Bridge](https://github.com/imamimam13/ninjaradio/blob/main/bridge-mumble/bridge_mumble.py): `bridge-mumble/bridge_mumble.py`
- [SvxLink Bridge](https://github.com/imamimam13/ninjaradio/blob/main/bridge-svxlink/bridge_svxlink.py): `bridge-svxlink/bridge_svxlink.py`
- [Zello Bridge](https://github.com/imamimam13/ninjaradio/blob/main/bridge-zello/bridge_zello.py): `bridge-zello/bridge_zello.py`
- [TeamSpeak Bridge](https://github.com/imamimam13/ninjaradio/blob/main/bridge-teamspeak/plugins/NinjaRadioBridge.cs): `bridge-teamspeak/plugins/NinjaRadioBridge.cs`

### Web Platform

- [Web Interface](https://github.com/imamimam13/ninjaradio/tree/main/frontend/src/app): `frontend/src/app`

### Backend Services

- [REST and WebSocket API](https://github.com/imamimam13/ninjaradio/blob/main/backend/app/api/endpoints.py): `backend/app/api/endpoints.py`
- [Backend Runtime](https://github.com/imamimam13/ninjaradio/blob/main/backend/app/main.py): `backend/app/main.py`
- [Callbook Service](https://github.com/imamimam13/ninjaradio/blob/main/backend/app/services/callbook_service.py): `backend/app/services/callbook_service.py`
- [SQLite Data](https://github.com/imamimam13/ninjaradio/blob/main/backend/app/core/database.py): `backend/app/core/database.py`
- [Bridge Management](https://github.com/imamimam13/ninjaradio/blob/main/backend/app/services/bridge_service.py): `backend/app/services/bridge_service.py`
- [Live Monitor](https://github.com/imamimam13/ninjaradio/blob/main/backend/app/services/dv_monitor.py): `backend/app/services/dv_monitor.py`
- [Logbook Service](https://github.com/imamimam13/ninjaradio/blob/main/backend/app/services/logbook_service.py): `backend/app/services/logbook_service.py`
- [Account Services](https://github.com/imamimam13/ninjaradio/blob/main/backend/app/services/selfcare_service.py): `backend/app/services/selfcare_service.py`
- [TeamSpeak Service](https://github.com/imamimam13/ninjaradio/blob/main/backend/app/services/teamspeak_service.py): `backend/app/services/teamspeak_service.py`

### Other components

- **Web Users**
- **DMR Radios**
- **Analog Nodes**
- **Mumble Users**
- **Zello Users**

## Connections

- Web Users → Web Interface: use
- Web Interface → REST and WebSocket API: request API
- REST and WebSocket API → Backend Runtime: serve routes (evidence: `backend/app/main.py`)
- Backend Runtime → SQLite Data: initialize (evidence: `backend/app/main.py`)
- Backend Runtime → Callbook Service: register service (evidence: `backend/app/main.py`)
- Callbook Service → SQLite Data: read and write (evidence: `backend/app/services/callbook_service.py`)
- REST and WebSocket API → Live Monitor: provide telemetry
- REST and WebSocket API → Logbook Service: provide logbook
- REST and WebSocket API → Account Services: provide accounts
- REST and WebSocket API → Bridge Management: manage bridges
- REST and WebSocket API → TeamSpeak Service: manage TeamSpeak
- Backend Runtime → Core DV Engine: send TX events
- Android DMR → DMR Master: connect DMR
- Lite DMR → DMR Master: connect HomeBrew
- DMR Radios → DMR Master: send UDP
- DMR Master → Core DV Engine: serve radio traffic (evidence: `core/core_engine.py`)
- Core DV Engine → Direct DMR: configure engine (evidence: `core/core_engine.py`)
- Core DV Engine → DMR Codec: encode and decode
- Mumble Users → Mumble Bridge: send voice
- Mumble Bridge → Core DV Engine: bridge NPTT audio
- Analog Nodes → SvxLink Bridge: send voice
- SvxLink Bridge → Core DV Engine: bridge NSVX audio
- Zello Users → Zello Bridge: send voice
- Zello Bridge → Core DV Engine: bridge audio
- TeamSpeak Bridge → TeamSpeak Service: integrate service
- SvxLink Client → Analog Nodes: connect reflector
- Simple Svx Client → Analog Nodes: connect reflector
- PWA Shell → Web Interface: open web app
