How imamimam13/ninjaradio works
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: endpoints.py REST and WebSocket API · core_engine.py Core DV Engine · main.py Backend Runtime · dmr_server.py DMR Master
Components 28
Radio Clients
- Android DMR
app-android/app/src/main/java/com/ninjadmr/app/DmrForegroundService.kt - Lite DMR
app-lite/app/src/main/java/com/ninjadmr/lite/service/DmrService.kt - SvxLink Client
app-svx/app/src/main/java/com/ninjaradio/svx/SvxReflectorClient.kt - Simple Svx Client
app-svx-simple/app/src/main/java/com/ninjaradio/svx/SvxReflectorClient.kt - PWA Shell
app-pwa/app/src/main/java/com/ninjadmr/pwa/MainActivity.kt
Radio Core
- Core DV Engine
core/core_engine.py - Direct DMR
core/direct_dmr.py - DMR Master
core/dmr_server.py - DMR Codec
core/opendmr/dmr_codec.cpp
Voice Gateways
- Mumble Bridge
bridge-mumble/bridge_mumble.py - SvxLink Bridge
bridge-svxlink/bridge_svxlink.py - Zello Bridge
bridge-zello/bridge_zello.py - TeamSpeak Bridge
bridge-teamspeak/plugins/NinjaRadioBridge.cs
Web Platform
- Web Interface
frontend/src/app
Backend Services
- REST and WebSocket API
backend/app/api/endpoints.py - Backend Runtime
backend/app/main.py - Callbook Service
backend/app/services/callbook_service.py - SQLite Data
backend/app/core/database.py - Bridge Management
backend/app/services/bridge_service.py - Live Monitor
backend/app/services/dv_monitor.py - Logbook Service
backend/app/services/logbook_service.py - Account Services
backend/app/services/selfcare_service.py - TeamSpeak Service
backend/app/services/teamspeak_service.py
Other components
- Web Users
- DMR Radios
- Analog Nodes
- Mumble Users
- Zello Users
Connections 28
- Web Users → Web Interface: use
- Web Interface → REST and WebSocket API: request API
- REST and WebSocket API → Backend Runtime: serve routes
backend/app/main.py - Backend Runtime → SQLite Data: initialize
backend/app/main.py - Backend Runtime → Callbook Service: register service
backend/app/main.py - Callbook Service → SQLite Data: read and write
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
core/core_engine.py - Core DV Engine → Direct DMR: configure engine
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