How soundcheck/soundcheck_desktop works
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: StreamController.java Service stream control · NetworkChannel.java Network channel · MasterController.java Service coordinator · PacketCreator.java Packet creation
Components 31
Player experience
- Player UI
MusicPlayer/src/main/java/soundcheck/musicPlayer/view/PlayerGUI.java - View controller
MusicPlayer/src/main/java/soundcheck/musicPlayer/ViewController.java - Service callback
MusicPlayer/src/main/java/soundcheck/musicPlayer/ServiceCallback.java - Song management
MusicPlayer/src/main/java/soundcheck/musicPlayer/songManagement/SongListManager.java - Player stream control
MusicPlayer/src/main/java/soundcheck/musicPlayer/streaming/StreamController.java - Player stream receiver
MusicPlayer/src/main/java/soundcheck/musicPlayer/streaming/StreamReceiver.java - Playlist files
MusicPlayer/src/main/java/soundcheck/musicPlayer/songManagement/PlayListFileTransaction.java
Service and state
- Service coordinator
Service/src/main/java/soundcheck/service/MasterController.java - Peer and zone state
Service/src/main/java/soundcheck/service/data/PeerCollection.java - Configuration
Service/src/main/java/soundcheck/service/data/ConfigurationManager.java - Service song library
Service/src/main/java/soundcheck/service/data/SongListManager.java - Player connection
Service/src/main/java/soundcheck/service/interprocess/MusicPlayerConnection.java
Peer networking
- Message handling
Service/src/main/java/soundcheck/service/network/MessageHandler.java - Network channel
Service/src/main/java/soundcheck/service/network/NetworkChannel.java - Peer discovery
Service/src/main/java/soundcheck/service/network/PeerManager.java - External channel
Service/src/main/java/soundcheck/service/network/ExternalChannel.java
Audio streaming
- Service stream control
Service/src/main/java/soundcheck/service/streaming/StreamController.java - Stream publisher
Service/src/main/java/soundcheck/service/streaming/StreamPublisher.java - Stream state
Service/src/main/java/soundcheck/service/streaming/Stream.java
Shared protocol
- Packet creation
GlobalLibraries/src/main/java/soundcheck/shared/PacketCreator.java - Packet format
GlobalLibraries/src/main/java/soundcheck/shared/DataPacket.java - Protocol constants
GlobalLibraries/src/main/java/soundcheck/shared/Const.java - Song model
GlobalLibraries/src/main/java/soundcheck/shared/Song.java - Peer model
GlobalLibraries/src/main/java/soundcheck/shared/Peer.java - Stream metadata
GlobalLibraries/src/main/java/soundcheck/shared/StreamInfo.java - Zone model
GlobalLibraries/src/main/java/soundcheck/shared/Zone.java - Zone mapping
GlobalLibraries/src/main/java/soundcheck/shared/ZonePair.java - Zone playlist state
GlobalLibraries/src/main/java/soundcheck/shared/ZoneProperties.java
Other components
- Desktop user
- Mobile remote
- Wi-Fi receiver
Connections 12
- Desktop user → Player UI: controls playback
- Service coordinator → View controller: starts view
Service/src/main/java/soundcheck/service/MasterController.java - Network channel → Message handling: dispatches messages
Service/src/main/java/soundcheck/service/network/NetworkChannel.java - Service coordinator → Network channel: sends peer updates
Service/src/main/java/soundcheck/service/MasterController.java - Service stream control → Player connection: forwards stream commands
Service/src/main/java/soundcheck/service/streaming/StreamController.java - Service stream control → Stream state: processes commands
Service/src/main/java/soundcheck/service/streaming/StreamController.java - Service stream control → Stream publisher: creates publisher
Service/src/main/java/soundcheck/service/streaming/StreamController.java - Service stream control → Network channel: sends stream packets
Service/src/main/java/soundcheck/service/streaming/StreamController.java - Network channel → Packet creation: creates discovery packet
Service/src/main/java/soundcheck/service/network/NetworkChannel.java - Packet creation → Packet format: builds packets
GlobalLibraries/src/main/java/soundcheck/shared/PacketCreator.java - Mobile remote → Network channel: remote control
- Wi-Fi receiver → Service stream control: receives network audio