How angorroc/bitchord-x works
BitChord-X is a cross-platform music player for Android and desktop, with TV and Wear OS companions and a backend supporting presence and shared listening. The main listener workflow is discovering music, resolving it from a selectable source, playing it through a configurable audio pipeline, and optionally saving it offline. Other major capabilities include lyrics and animated artwork, Spotify sync, device handoff, and Listen Together. The tree and excerpts support the main playback, download, and backend structure; several feature links are documented in the README rather than shown in sampled call sites.
Main entry points: PlaybackService.kt Android playback · StreamResolver.kt Stream resolution · main.go Party and presence backend · MainActivity.kt App shell
Components 23
App experience
- App shell
app/src/main/java/com/music/bitchord/MainActivity.kt - Main view model
app/src/main/java/com/music/bitchord/ui/MainViewModel.kt - Playback settings
app/src/main/java/com/music/bitchord/data/settings/AppSettings.kt
Discovery and sources
- Music discovery
shared/src/jvmSharedMain/kotlin/com/music/bitchord/data/YtMusicRepository.kt - Source registry
app/src/main/java/com/music/bitchord/data/sources/SourceRegistry.kt - Stream resolution
shared/src/jvmSharedMain/kotlin/com/music/bitchord/data/innertube/StreamResolver.kt - Lyrics providers
shared/src/jvmSharedMain/kotlin/com/music/bitchord/data/lyrics/LyricsQuery.kt - Animated artwork
app/src/main/java/com/music/bitchord/data/canvas/CanvasRepository.kt
Playback and audio
- Android playback
app/src/main/java/com/music/bitchord/playback/PlaybackService.kt - Automix and crossfade
app/src/main/java/com/music/bitchord/playback/CrossfadeController.kt - Bit-perfect output
app/src/main/java/com/music/bitchord/playback/audio/bitperfect/BitPerfectOutput.kt - Desktop audio engine
desktopApp/src/main/kotlin/com/music/bitchord/desktop/DesktopAudioEngine.kt
Library and downloads
- Audio cache
app/src/main/java/com/music/bitchord/playback/AudioCache.kt - Offline downloads
app/src/main/java/com/music/bitchord/download/Downloads.kt - Local and network media
app/src/main/java/com/music/bitchord/data/LocalMediaRepository.kt
Accounts and connection
- Spotify sync
app/src/main/java/com/music/bitchord/data/spotify/SpotifySync.kt - Account sign-in
app/src/main/java/com/music/bitchord/auth/AccountSessions.kt - Listen Together
app/src/main/java/com/music/bitchord/data/listentogether/ListenTogether.kt - Party and presence backend
backend/main.go - Presence service
backend/presence/presence.go
Other components
- Listener
- YouTube Music
- Audio device
Connections 22
- Listener → App shell: uses
- App shell → Main view model: hosts
- Main view model → Music discovery: browses
- Music discovery → YouTube Music: queries
shared/src/jvmSharedMain/kotlin/com/music/bitchord/data/YtMusicRepository.kt - Source registry → Stream resolution: resolves streams
- Android playback → Stream resolution: plays resolved streams
- Android playback → Automix and crossfade: coordinates transitions
- Automix and crossfade → Playback settings: reads settings
app/src/main/java/com/music/bitchord/playback/CrossfadeController.kt - Android playback → Bit-perfect output: outputs audio
- Bit-perfect output → Audio device: routes audio
- Desktop audio engine → Stream resolution: resolves streams
desktopApp/src/main/kotlin/com/music/bitchord/desktop/DesktopAudioEngine.kt - Offline downloads → Stream resolution: downloads streams
- Android playback → Audio cache: uses cache
- Listener → Offline downloads: saves tracks
- Listener → Local and network media: plays local media
- Android playback → Lyrics providers: shows synced lyrics
- Android playback → Animated artwork: shows artwork
- Listener → Spotify sync: imports playlists
- Listener → Account sign-in: signs in
- Listen Together → Party and presence backend: synchronizes sessions
- Party and presence backend → Listen Together: serves party requests
backend/main.go - Party and presence backend → Presence service: records presence