# dsheirer/sdrtrunk architecture

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

- Interactive diagram: https://gitdiagram.com/dsheirer/sdrtrunk
- Repository: https://github.com/dsheirer/sdrtrunk

## Overview

sdrtrunk is a cross-platform SDR application for decoding, monitoring, recording, and streaming trunked-radio traffic. Users configure channels and tuners in playlists; channel processing obtains a source and runs a processing chain, with protocol-specific traffic-channel handling and optional audio, recording, and streaming outputs. The README establishes the product capabilities, while sampled source and the index provide only partial wiring evidence; dashed links mark product-level relationships not verified in those excerpts.

Main entry points: [`src/main/java/io/github/dsheirer/controller/channel/ChannelProcessingManager.java`](https://github.com/dsheirer/sdrtrunk/blob/master/src/main/java/io/github/dsheirer/controller/channel/ChannelProcessingManager.java) (Channel Processing), [`src/main/java/io/github/dsheirer/playlist/PlaylistManager.java`](https://github.com/dsheirer/sdrtrunk/blob/master/src/main/java/io/github/dsheirer/playlist/PlaylistManager.java) (Playlist Manager), [`src/main/java/io/github/dsheirer/controller/channel/Channel.java`](https://github.com/dsheirer/sdrtrunk/blob/master/src/main/java/io/github/dsheirer/controller/channel/Channel.java) (Channel Configuration), [`src/main/java/io/github/dsheirer/alias/AliasModel.java`](https://github.com/dsheirer/sdrtrunk/blob/master/src/main/java/io/github/dsheirer/alias/AliasModel.java) (Alias Model)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_configuration["Configuration &amp; Sources"]
  node_playlist["Playlist Manager"]
  node_channel["Channel Configuration<br/>[Channel.java]"]
  node_tuner_manager["Tuner Discovery<br/>[TunerManager.java]"]
  node_tuner["Tuner Control"]
  node_alias["Alias Model<br/>[AliasModel.java]"]
  node_radio_services["Radio Reference"]
end

subgraph group_decode["Signal &amp; Decode"]
  node_identifiers["Decoded Identifiers"]
  node_dmr_sms["DMR Short Messages"]
  node_nxdn_service["NXDN Services<br/>[Service.java]"]
  node_p25_service["P25 Services<br/>[Service.java]"]
end

subgraph group_processing["Channel Processing"]
  node_channel_processing["Channel Processing"]
  node_traffic["P25 Traffic Channels"]
  node_channel_state["Decoder State<br/>[StateMachine.java]"]
  node_metadata["Channel Metadata"]
  node_map["Decode Event Map<br/>[MapService.java]"]
end

subgraph group_outputs["Audio &amp; Outputs"]
  node_audio["Audio Processing<br/>[AudioSegment.java]"]
  node_recording["Audio Recording"]
  node_broadcast["Audio Streaming"]
  node_broadcast_services["Streaming Services"]
end

node_user(("Operator"))

node_user -.->|"configures"| node_playlist
node_playlist -->|"loads models"| node_channel
node_playlist -->|"loads aliases"| node_alias
node_user -.->|"selects tuner"| node_tuner_manager
node_tuner_manager -.->|"creates controllers"| node_tuner
node_channel -.->|"requests processing"| node_channel_processing
node_channel_processing -->|"uses aliases"| node_alias
node_channel_processing -->|"updates metadata"| node_metadata
node_channel_processing -->|"processes audio"| node_audio
node_channel_processing -->|"adds recorders"| node_recording
node_channel_processing -.->|"builds chain"| node_channel_state
node_traffic -->|"requests channels"| node_channel
node_traffic -->|"uses identifiers"| node_identifiers
node_dmr_sms -->|"produces identifiers"| node_identifiers
node_map -->|"reads aliases"| node_alias
node_map -.->|"plots decode events"| node_channel_state
node_audio -.->|"streams audio"| node_broadcast
node_broadcast -.->|"dispatches streams"| node_broadcast_services
node_user -.->|"looks up data"| node_radio_services

click node_playlist "https://github.com/dsheirer/sdrtrunk/blob/master/src/main/java/io/github/dsheirer/playlist/PlaylistManager.java"
click node_channel "https://github.com/dsheirer/sdrtrunk/blob/master/src/main/java/io/github/dsheirer/controller/channel/Channel.java"
click node_tuner_manager "https://github.com/dsheirer/sdrtrunk/blob/master/src/main/java/io/github/dsheirer/source/tuner/manager/TunerManager.java"
click node_tuner "https://github.com/dsheirer/sdrtrunk/blob/master/src/main/java/io/github/dsheirer/source/tuner/TunerController.java"
click node_alias "https://github.com/dsheirer/sdrtrunk/blob/master/src/main/java/io/github/dsheirer/alias/AliasModel.java"
click node_channel_processing "https://github.com/dsheirer/sdrtrunk/blob/master/src/main/java/io/github/dsheirer/controller/channel/ChannelProcessingManager.java"
click node_traffic "https://github.com/dsheirer/sdrtrunk/blob/master/src/main/java/io/github/dsheirer/module/decode/p25/P25TrafficChannelManager.java"
click node_channel_state "https://github.com/dsheirer/sdrtrunk/blob/master/src/main/java/io/github/dsheirer/channel/state/StateMachine.java"
click node_metadata "https://github.com/dsheirer/sdrtrunk/blob/master/src/main/java/io/github/dsheirer/channel/metadata/ChannelMetadataModel.java"
click node_identifiers "https://github.com/dsheirer/sdrtrunk/blob/master/src/main/java/io/github/dsheirer/identifier/IdentifierCollection.java"
click node_dmr_sms "https://github.com/dsheirer/sdrtrunk/blob/master/src/main/java/io/github/dsheirer/module/decode/dmr/message/data/packet/UDTShortMessageService.java"
click node_nxdn_service "https://github.com/dsheirer/sdrtrunk/blob/master/src/main/java/io/github/dsheirer/module/decode/nxdn/layer3/type/Service.java"
click node_p25_service "https://github.com/dsheirer/sdrtrunk/blob/master/src/main/java/io/github/dsheirer/module/decode/p25/reference/Service.java"
click node_map "https://github.com/dsheirer/sdrtrunk/blob/master/src/main/java/io/github/dsheirer/map/MapService.java"
click node_audio "https://github.com/dsheirer/sdrtrunk/blob/master/src/main/java/io/github/dsheirer/audio/AudioSegment.java"
click node_recording "https://github.com/dsheirer/sdrtrunk/blob/master/src/main/java/io/github/dsheirer/record/AudioRecordingManager.java"
click node_broadcast "https://github.com/dsheirer/sdrtrunk/blob/master/src/main/java/io/github/dsheirer/audio/broadcast/AudioStreamingManager.java"
click node_broadcast_services "https://github.com/dsheirer/sdrtrunk/tree/master/src/main/java/io/github/dsheirer/audio/broadcast"
click node_radio_services "https://github.com/dsheirer/sdrtrunk/blob/master/src/main/java/io/github/dsheirer/service/radioreference/CachingRadioReferenceService.java"

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_playlist,node_channel,node_tuner_manager,node_tuner,node_alias,node_radio_services toneBlue
class node_identifiers,node_dmr_sms,node_nxdn_service,node_p25_service toneAmber
class node_channel_processing,node_traffic,node_channel_state,node_metadata,node_map toneMint
class node_audio,node_recording,node_broadcast,node_broadcast_services toneRose
class node_user toneIndigo
```

## Components

### Configuration & Sources

- [Playlist Manager](https://github.com/dsheirer/sdrtrunk/blob/master/src/main/java/io/github/dsheirer/playlist/PlaylistManager.java): `src/main/java/io/github/dsheirer/playlist/PlaylistManager.java`
- [Channel Configuration](https://github.com/dsheirer/sdrtrunk/blob/master/src/main/java/io/github/dsheirer/controller/channel/Channel.java): `src/main/java/io/github/dsheirer/controller/channel/Channel.java`
- [Tuner Discovery](https://github.com/dsheirer/sdrtrunk/blob/master/src/main/java/io/github/dsheirer/source/tuner/manager/TunerManager.java): `src/main/java/io/github/dsheirer/source/tuner/manager/TunerManager.java`
- [Tuner Control](https://github.com/dsheirer/sdrtrunk/blob/master/src/main/java/io/github/dsheirer/source/tuner/TunerController.java): `src/main/java/io/github/dsheirer/source/tuner/TunerController.java`
- [Alias Model](https://github.com/dsheirer/sdrtrunk/blob/master/src/main/java/io/github/dsheirer/alias/AliasModel.java): `src/main/java/io/github/dsheirer/alias/AliasModel.java`
- [Radio Reference](https://github.com/dsheirer/sdrtrunk/blob/master/src/main/java/io/github/dsheirer/service/radioreference/CachingRadioReferenceService.java): `src/main/java/io/github/dsheirer/service/radioreference/CachingRadioReferenceService.java`

### Signal & Decode

- [Decoded Identifiers](https://github.com/dsheirer/sdrtrunk/blob/master/src/main/java/io/github/dsheirer/identifier/IdentifierCollection.java): `src/main/java/io/github/dsheirer/identifier/IdentifierCollection.java`
- [DMR Short Messages](https://github.com/dsheirer/sdrtrunk/blob/master/src/main/java/io/github/dsheirer/module/decode/dmr/message/data/packet/UDTShortMessageService.java): `src/main/java/io/github/dsheirer/module/decode/dmr/message/data/packet/UDTShortMessageService.java`
- [NXDN Services](https://github.com/dsheirer/sdrtrunk/blob/master/src/main/java/io/github/dsheirer/module/decode/nxdn/layer3/type/Service.java): `src/main/java/io/github/dsheirer/module/decode/nxdn/layer3/type/Service.java`
- [P25 Services](https://github.com/dsheirer/sdrtrunk/blob/master/src/main/java/io/github/dsheirer/module/decode/p25/reference/Service.java): `src/main/java/io/github/dsheirer/module/decode/p25/reference/Service.java`

### Channel Processing

- [Channel Processing](https://github.com/dsheirer/sdrtrunk/blob/master/src/main/java/io/github/dsheirer/controller/channel/ChannelProcessingManager.java): `src/main/java/io/github/dsheirer/controller/channel/ChannelProcessingManager.java`
- [P25 Traffic Channels](https://github.com/dsheirer/sdrtrunk/blob/master/src/main/java/io/github/dsheirer/module/decode/p25/P25TrafficChannelManager.java): `src/main/java/io/github/dsheirer/module/decode/p25/P25TrafficChannelManager.java`
- [Decoder State](https://github.com/dsheirer/sdrtrunk/blob/master/src/main/java/io/github/dsheirer/channel/state/StateMachine.java): `src/main/java/io/github/dsheirer/channel/state/StateMachine.java`
- [Channel Metadata](https://github.com/dsheirer/sdrtrunk/blob/master/src/main/java/io/github/dsheirer/channel/metadata/ChannelMetadataModel.java): `src/main/java/io/github/dsheirer/channel/metadata/ChannelMetadataModel.java`
- [Decode Event Map](https://github.com/dsheirer/sdrtrunk/blob/master/src/main/java/io/github/dsheirer/map/MapService.java): `src/main/java/io/github/dsheirer/map/MapService.java`

### Audio & Outputs

- [Audio Processing](https://github.com/dsheirer/sdrtrunk/blob/master/src/main/java/io/github/dsheirer/audio/AudioSegment.java): `src/main/java/io/github/dsheirer/audio/AudioSegment.java`
- [Audio Recording](https://github.com/dsheirer/sdrtrunk/blob/master/src/main/java/io/github/dsheirer/record/AudioRecordingManager.java): `src/main/java/io/github/dsheirer/record/AudioRecordingManager.java`
- [Audio Streaming](https://github.com/dsheirer/sdrtrunk/blob/master/src/main/java/io/github/dsheirer/audio/broadcast/AudioStreamingManager.java): `src/main/java/io/github/dsheirer/audio/broadcast/AudioStreamingManager.java`
- [Streaming Services](https://github.com/dsheirer/sdrtrunk/tree/master/src/main/java/io/github/dsheirer/audio/broadcast): `src/main/java/io/github/dsheirer/audio/broadcast`

### Other components

- **Operator**

## Connections

- Operator → Playlist Manager: configures (evidence: `README.md`)
- Playlist Manager → Channel Configuration: loads models (evidence: `src/main/java/io/github/dsheirer/playlist/PlaylistManager.java`)
- Playlist Manager → Alias Model: loads aliases (evidence: `src/main/java/io/github/dsheirer/playlist/PlaylistManager.java`)
- Operator → Tuner Discovery: selects tuner (evidence: `README.md`)
- Tuner Discovery → Tuner Control: creates controllers
- Channel Configuration → Channel Processing: requests processing (evidence: `README.md`)
- Channel Processing → Alias Model: uses aliases (evidence: `src/main/java/io/github/dsheirer/controller/channel/ChannelProcessingManager.java`)
- Channel Processing → Channel Metadata: updates metadata (evidence: `src/main/java/io/github/dsheirer/controller/channel/ChannelProcessingManager.java`)
- Channel Processing → Audio Processing: processes audio (evidence: `src/main/java/io/github/dsheirer/controller/channel/ChannelProcessingManager.java`)
- Channel Processing → Audio Recording: adds recorders (evidence: `src/main/java/io/github/dsheirer/controller/channel/ChannelProcessingManager.java`)
- Channel Processing → Decoder State: builds chain
- P25 Traffic Channels → Channel Configuration: requests channels (evidence: `src/main/java/io/github/dsheirer/module/decode/p25/P25TrafficChannelManager.java`)
- P25 Traffic Channels → Decoded Identifiers: uses identifiers (evidence: `src/main/java/io/github/dsheirer/module/decode/p25/P25TrafficChannelManager.java`)
- DMR Short Messages → Decoded Identifiers: produces identifiers (evidence: `src/main/java/io/github/dsheirer/module/decode/dmr/message/data/packet/UDTShortMessageService.java`)
- Decode Event Map → Alias Model: reads aliases (evidence: `src/main/java/io/github/dsheirer/map/MapService.java`)
- Decode Event Map → Decoder State: plots decode events
- Audio Processing → Audio Streaming: streams audio (evidence: `README.md`)
- Audio Streaming → Streaming Services: dispatches streams
- Operator → Radio Reference: looks up data
