# soundcheck/soundcheck_desktop architecture

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

- Interactive diagram: https://gitdiagram.com/soundcheck/soundcheck_desktop
- Repository: https://github.com/soundcheck/soundcheck_desktop

## Overview

SoundCheck is a desktop networked music player: users manage a shared song library and playback zones, then play synchronized audio across peers or separate zones. The main runtime spans the player UI, a coordinating service, peer networking, and stream publishing/receiving; shared packet and domain models carry state between them. The README also describes mobile remote control and Wi-Fi hardware receivers. Some subsystem links and implementations are unsampled, so those relationships are omitted rather than inferred from module names.

Main entry points: [`Service/src/main/java/soundcheck/service/streaming/StreamController.java`](https://github.com/soundcheck/soundcheck_desktop/blob/master/Service/src/main/java/soundcheck/service/streaming/StreamController.java) (Service stream control), [`Service/src/main/java/soundcheck/service/network/NetworkChannel.java`](https://github.com/soundcheck/soundcheck_desktop/blob/master/Service/src/main/java/soundcheck/service/network/NetworkChannel.java) (Network channel), [`Service/src/main/java/soundcheck/service/MasterController.java`](https://github.com/soundcheck/soundcheck_desktop/blob/master/Service/src/main/java/soundcheck/service/MasterController.java) (Service coordinator), [`GlobalLibraries/src/main/java/soundcheck/shared/PacketCreator.java`](https://github.com/soundcheck/soundcheck_desktop/blob/master/GlobalLibraries/src/main/java/soundcheck/shared/PacketCreator.java) (Packet creation)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_player["Player experience"]
  node_view["Player UI<br/>[PlayerGUI.java]"]
  node_viewcontroller["View controller"]
  node_callback["Service callback"]
  node_songui["Song management"]
  node_playerstream["Player stream control"]
  node_receiverstream["Player stream receiver"]
  node_playlists["Playlist files"]
end

subgraph group_service["Service and state"]
  node_master["Service coordinator"]
  node_peers["Peer and zone state"]
  node_config["Configuration"]
  node_songcatalog["Service song library"]
  node_ipc["Player connection"]
end

subgraph group_network["Peer networking"]
  node_message["Message handling"]
  node_channel["Network channel"]
  node_peermanager["Peer discovery<br/>[PeerManager.java]"]
  node_externalchannel["External channel"]
end

subgraph group_stream["Audio streaming"]
  node_servicecontroller["Service stream control"]
  node_publisher["Stream publisher"]
  node_servicestream["Stream state<br/>[Stream.java]"]
end

subgraph group_shared["Shared protocol"]
  node_packetcreator["Packet creation<br/>[PacketCreator.java]"]
  node_datapacket["Packet format<br/>[DataPacket.java]"]
  node_constants["Protocol constants<br/>[Const.java]"]
  node_song["Song model<br/>[Song.java]"]
  node_peer["Peer model<br/>[Peer.java]"]
  node_streaminfo["Stream metadata<br/>[StreamInfo.java]"]
  node_zone["Zone model<br/>[Zone.java]"]
  node_zonepair["Zone mapping<br/>[ZonePair.java]"]
  node_zoneprops["Zone playlist state"]
end

node_user(("Desktop user"))
node_mobile(("Mobile remote"))
node_receiver["Wi-Fi receiver"]

node_user -->|"controls playback"| node_view
node_master -->|"starts view"| node_viewcontroller
node_channel -->|"dispatches messages"| node_message
node_master -->|"sends peer updates"| node_channel
node_servicecontroller -->|"forwards stream commands"| node_ipc
node_servicecontroller -->|"processes commands"| node_servicestream
node_servicecontroller -->|"creates publisher"| node_publisher
node_servicecontroller -->|"sends stream packets"| node_channel
node_channel -->|"creates discovery packet"| node_packetcreator
node_packetcreator -->|"builds packets"| node_datapacket
node_mobile -.->|"remote control"| node_channel
node_receiver -.->|"receives network audio"| node_servicecontroller

click node_view "https://github.com/soundcheck/soundcheck_desktop/blob/master/MusicPlayer/src/main/java/soundcheck/musicPlayer/view/PlayerGUI.java"
click node_viewcontroller "https://github.com/soundcheck/soundcheck_desktop/blob/master/MusicPlayer/src/main/java/soundcheck/musicPlayer/ViewController.java"
click node_callback "https://github.com/soundcheck/soundcheck_desktop/blob/master/MusicPlayer/src/main/java/soundcheck/musicPlayer/ServiceCallback.java"
click node_songui "https://github.com/soundcheck/soundcheck_desktop/blob/master/MusicPlayer/src/main/java/soundcheck/musicPlayer/songManagement/SongListManager.java"
click node_playerstream "https://github.com/soundcheck/soundcheck_desktop/blob/master/MusicPlayer/src/main/java/soundcheck/musicPlayer/streaming/StreamController.java"
click node_receiverstream "https://github.com/soundcheck/soundcheck_desktop/blob/master/MusicPlayer/src/main/java/soundcheck/musicPlayer/streaming/StreamReceiver.java"
click node_playlists "https://github.com/soundcheck/soundcheck_desktop/blob/master/MusicPlayer/src/main/java/soundcheck/musicPlayer/songManagement/PlayListFileTransaction.java"
click node_master "https://github.com/soundcheck/soundcheck_desktop/blob/master/Service/src/main/java/soundcheck/service/MasterController.java"
click node_peers "https://github.com/soundcheck/soundcheck_desktop/blob/master/Service/src/main/java/soundcheck/service/data/PeerCollection.java"
click node_config "https://github.com/soundcheck/soundcheck_desktop/blob/master/Service/src/main/java/soundcheck/service/data/ConfigurationManager.java"
click node_songcatalog "https://github.com/soundcheck/soundcheck_desktop/blob/master/Service/src/main/java/soundcheck/service/data/SongListManager.java"
click node_ipc "https://github.com/soundcheck/soundcheck_desktop/blob/master/Service/src/main/java/soundcheck/service/interprocess/MusicPlayerConnection.java"
click node_message "https://github.com/soundcheck/soundcheck_desktop/blob/master/Service/src/main/java/soundcheck/service/network/MessageHandler.java"
click node_channel "https://github.com/soundcheck/soundcheck_desktop/blob/master/Service/src/main/java/soundcheck/service/network/NetworkChannel.java"
click node_peermanager "https://github.com/soundcheck/soundcheck_desktop/blob/master/Service/src/main/java/soundcheck/service/network/PeerManager.java"
click node_externalchannel "https://github.com/soundcheck/soundcheck_desktop/blob/master/Service/src/main/java/soundcheck/service/network/ExternalChannel.java"
click node_servicecontroller "https://github.com/soundcheck/soundcheck_desktop/blob/master/Service/src/main/java/soundcheck/service/streaming/StreamController.java"
click node_publisher "https://github.com/soundcheck/soundcheck_desktop/blob/master/Service/src/main/java/soundcheck/service/streaming/StreamPublisher.java"
click node_servicestream "https://github.com/soundcheck/soundcheck_desktop/blob/master/Service/src/main/java/soundcheck/service/streaming/Stream.java"
click node_packetcreator "https://github.com/soundcheck/soundcheck_desktop/blob/master/GlobalLibraries/src/main/java/soundcheck/shared/PacketCreator.java"
click node_datapacket "https://github.com/soundcheck/soundcheck_desktop/blob/master/GlobalLibraries/src/main/java/soundcheck/shared/DataPacket.java"
click node_constants "https://github.com/soundcheck/soundcheck_desktop/blob/master/GlobalLibraries/src/main/java/soundcheck/shared/Const.java"
click node_song "https://github.com/soundcheck/soundcheck_desktop/blob/master/GlobalLibraries/src/main/java/soundcheck/shared/Song.java"
click node_peer "https://github.com/soundcheck/soundcheck_desktop/blob/master/GlobalLibraries/src/main/java/soundcheck/shared/Peer.java"
click node_streaminfo "https://github.com/soundcheck/soundcheck_desktop/blob/master/GlobalLibraries/src/main/java/soundcheck/shared/StreamInfo.java"
click node_zone "https://github.com/soundcheck/soundcheck_desktop/blob/master/GlobalLibraries/src/main/java/soundcheck/shared/Zone.java"
click node_zonepair "https://github.com/soundcheck/soundcheck_desktop/blob/master/GlobalLibraries/src/main/java/soundcheck/shared/ZonePair.java"
click node_zoneprops "https://github.com/soundcheck/soundcheck_desktop/blob/master/GlobalLibraries/src/main/java/soundcheck/shared/ZoneProperties.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_view,node_viewcontroller,node_callback,node_songui,node_playerstream,node_receiverstream,node_playlists,node_user toneBlue
class node_master,node_peers,node_config,node_songcatalog,node_ipc toneAmber
class node_message,node_channel,node_peermanager,node_externalchannel toneMint
class node_servicecontroller,node_publisher,node_servicestream toneRose
class node_packetcreator,node_datapacket,node_constants,node_song,node_peer,node_streaminfo,node_zone,node_zonepair,node_zoneprops,node_mobile,node_receiver toneIndigo
```

## Components

### Player experience

- [Player UI](https://github.com/soundcheck/soundcheck_desktop/blob/master/MusicPlayer/src/main/java/soundcheck/musicPlayer/view/PlayerGUI.java): `MusicPlayer/src/main/java/soundcheck/musicPlayer/view/PlayerGUI.java`
- [View controller](https://github.com/soundcheck/soundcheck_desktop/blob/master/MusicPlayer/src/main/java/soundcheck/musicPlayer/ViewController.java): `MusicPlayer/src/main/java/soundcheck/musicPlayer/ViewController.java`
- [Service callback](https://github.com/soundcheck/soundcheck_desktop/blob/master/MusicPlayer/src/main/java/soundcheck/musicPlayer/ServiceCallback.java): `MusicPlayer/src/main/java/soundcheck/musicPlayer/ServiceCallback.java`
- [Song management](https://github.com/soundcheck/soundcheck_desktop/blob/master/MusicPlayer/src/main/java/soundcheck/musicPlayer/songManagement/SongListManager.java): `MusicPlayer/src/main/java/soundcheck/musicPlayer/songManagement/SongListManager.java`
- [Player stream control](https://github.com/soundcheck/soundcheck_desktop/blob/master/MusicPlayer/src/main/java/soundcheck/musicPlayer/streaming/StreamController.java): `MusicPlayer/src/main/java/soundcheck/musicPlayer/streaming/StreamController.java`
- [Player stream receiver](https://github.com/soundcheck/soundcheck_desktop/blob/master/MusicPlayer/src/main/java/soundcheck/musicPlayer/streaming/StreamReceiver.java): `MusicPlayer/src/main/java/soundcheck/musicPlayer/streaming/StreamReceiver.java`
- [Playlist files](https://github.com/soundcheck/soundcheck_desktop/blob/master/MusicPlayer/src/main/java/soundcheck/musicPlayer/songManagement/PlayListFileTransaction.java): `MusicPlayer/src/main/java/soundcheck/musicPlayer/songManagement/PlayListFileTransaction.java`

### Service and state

- [Service coordinator](https://github.com/soundcheck/soundcheck_desktop/blob/master/Service/src/main/java/soundcheck/service/MasterController.java): `Service/src/main/java/soundcheck/service/MasterController.java`
- [Peer and zone state](https://github.com/soundcheck/soundcheck_desktop/blob/master/Service/src/main/java/soundcheck/service/data/PeerCollection.java): `Service/src/main/java/soundcheck/service/data/PeerCollection.java`
- [Configuration](https://github.com/soundcheck/soundcheck_desktop/blob/master/Service/src/main/java/soundcheck/service/data/ConfigurationManager.java): `Service/src/main/java/soundcheck/service/data/ConfigurationManager.java`
- [Service song library](https://github.com/soundcheck/soundcheck_desktop/blob/master/Service/src/main/java/soundcheck/service/data/SongListManager.java): `Service/src/main/java/soundcheck/service/data/SongListManager.java`
- [Player connection](https://github.com/soundcheck/soundcheck_desktop/blob/master/Service/src/main/java/soundcheck/service/interprocess/MusicPlayerConnection.java): `Service/src/main/java/soundcheck/service/interprocess/MusicPlayerConnection.java`

### Peer networking

- [Message handling](https://github.com/soundcheck/soundcheck_desktop/blob/master/Service/src/main/java/soundcheck/service/network/MessageHandler.java): `Service/src/main/java/soundcheck/service/network/MessageHandler.java`
- [Network channel](https://github.com/soundcheck/soundcheck_desktop/blob/master/Service/src/main/java/soundcheck/service/network/NetworkChannel.java): `Service/src/main/java/soundcheck/service/network/NetworkChannel.java`
- [Peer discovery](https://github.com/soundcheck/soundcheck_desktop/blob/master/Service/src/main/java/soundcheck/service/network/PeerManager.java): `Service/src/main/java/soundcheck/service/network/PeerManager.java`
- [External channel](https://github.com/soundcheck/soundcheck_desktop/blob/master/Service/src/main/java/soundcheck/service/network/ExternalChannel.java): `Service/src/main/java/soundcheck/service/network/ExternalChannel.java`

### Audio streaming

- [Service stream control](https://github.com/soundcheck/soundcheck_desktop/blob/master/Service/src/main/java/soundcheck/service/streaming/StreamController.java): `Service/src/main/java/soundcheck/service/streaming/StreamController.java`
- [Stream publisher](https://github.com/soundcheck/soundcheck_desktop/blob/master/Service/src/main/java/soundcheck/service/streaming/StreamPublisher.java): `Service/src/main/java/soundcheck/service/streaming/StreamPublisher.java`
- [Stream state](https://github.com/soundcheck/soundcheck_desktop/blob/master/Service/src/main/java/soundcheck/service/streaming/Stream.java): `Service/src/main/java/soundcheck/service/streaming/Stream.java`

### Shared protocol

- [Packet creation](https://github.com/soundcheck/soundcheck_desktop/blob/master/GlobalLibraries/src/main/java/soundcheck/shared/PacketCreator.java): `GlobalLibraries/src/main/java/soundcheck/shared/PacketCreator.java`
- [Packet format](https://github.com/soundcheck/soundcheck_desktop/blob/master/GlobalLibraries/src/main/java/soundcheck/shared/DataPacket.java): `GlobalLibraries/src/main/java/soundcheck/shared/DataPacket.java`
- [Protocol constants](https://github.com/soundcheck/soundcheck_desktop/blob/master/GlobalLibraries/src/main/java/soundcheck/shared/Const.java): `GlobalLibraries/src/main/java/soundcheck/shared/Const.java`
- [Song model](https://github.com/soundcheck/soundcheck_desktop/blob/master/GlobalLibraries/src/main/java/soundcheck/shared/Song.java): `GlobalLibraries/src/main/java/soundcheck/shared/Song.java`
- [Peer model](https://github.com/soundcheck/soundcheck_desktop/blob/master/GlobalLibraries/src/main/java/soundcheck/shared/Peer.java): `GlobalLibraries/src/main/java/soundcheck/shared/Peer.java`
- [Stream metadata](https://github.com/soundcheck/soundcheck_desktop/blob/master/GlobalLibraries/src/main/java/soundcheck/shared/StreamInfo.java): `GlobalLibraries/src/main/java/soundcheck/shared/StreamInfo.java`
- [Zone model](https://github.com/soundcheck/soundcheck_desktop/blob/master/GlobalLibraries/src/main/java/soundcheck/shared/Zone.java): `GlobalLibraries/src/main/java/soundcheck/shared/Zone.java`
- [Zone mapping](https://github.com/soundcheck/soundcheck_desktop/blob/master/GlobalLibraries/src/main/java/soundcheck/shared/ZonePair.java): `GlobalLibraries/src/main/java/soundcheck/shared/ZonePair.java`
- [Zone playlist state](https://github.com/soundcheck/soundcheck_desktop/blob/master/GlobalLibraries/src/main/java/soundcheck/shared/ZoneProperties.java): `GlobalLibraries/src/main/java/soundcheck/shared/ZoneProperties.java`

### Other components

- **Desktop user**
- **Mobile remote**
- **Wi-Fi receiver**

## Connections

- Desktop user → Player UI: controls playback
- Service coordinator → View controller: starts view (evidence: `Service/src/main/java/soundcheck/service/MasterController.java`)
- Network channel → Message handling: dispatches messages (evidence: `Service/src/main/java/soundcheck/service/network/NetworkChannel.java`)
- Service coordinator → Network channel: sends peer updates (evidence: `Service/src/main/java/soundcheck/service/MasterController.java`)
- Service stream control → Player connection: forwards stream commands (evidence: `Service/src/main/java/soundcheck/service/streaming/StreamController.java`)
- Service stream control → Stream state: processes commands (evidence: `Service/src/main/java/soundcheck/service/streaming/StreamController.java`)
- Service stream control → Stream publisher: creates publisher (evidence: `Service/src/main/java/soundcheck/service/streaming/StreamController.java`)
- Service stream control → Network channel: sends stream packets (evidence: `Service/src/main/java/soundcheck/service/streaming/StreamController.java`)
- Network channel → Packet creation: creates discovery packet (evidence: `Service/src/main/java/soundcheck/service/network/NetworkChannel.java`)
- Packet creation → Packet format: builds packets (evidence: `GlobalLibraries/src/main/java/soundcheck/shared/PacketCreator.java`)
- Mobile remote → Network channel: remote control
- Wi-Fi receiver → Service stream control: receives network audio
