How hamza-houaoui/podium-music-player works
CHORT is an Android retro-styled music player. A listener enters through the device UI, browses local or online music, and starts playback; the playback service manages the queue and audio, with background and remote controls. Separate product branches cover lyrics, radio, podcasts, Quran, books, and device customization. The tree and README identify these capabilities, while sampled source confirms key UI, composition, database, and playback connections; unsampled feature wiring is intentionally left implicit.
Main entry points: AppGraph.kt App composition · PodiumPlaybackEngine.kt Playback engine · SourceRegistry.kt Music sources · MainActivity.kt Android entry
Components 24
App and experience
- Android entry
app/src/main/kotlin/app/podium/MainActivity.kt - Device UI
app/src/main/kotlin/app/podium/PodiumApp.kt - App composition
app/src/main/kotlin/app/podium/AppGraph.kt
Music discovery
- Library browse
feature/library/src/main/kotlin/app/podium/feature/library/LibraryScreens.kt - Local library
feature/library/src/main/kotlin/app/podium/feature/library/LibraryRepository.kt - Online catalogue
feature/online/src/main/kotlin/app/podium/feature/online/OnlineScreens.kt - Online access
feature/online/src/main/kotlin/app/podium/feature/online/OnlineRepository.kt - Music sources
sources/api/src/main/kotlin/app/podium/sources/api/SourceRegistry.kt - YouTube Music
sources/youtubemusic/src/main/kotlin/app/podium/sources/youtubemusic/YouTubeMusicSource.kt
Playback
- Playback controls
player/api/src/main/kotlin/app/podium/player/api/OwnerAwarePlaybackController.kt - Queue manager
player/api/src/main/kotlin/app/podium/player/api/QueueManager.kt - Playback service
player/service/src/main/kotlin/app/podium/player/service/PlaybackService.kt - Playback engine
player/service/src/main/kotlin/app/podium/player/service/PodiumPlaybackEngine.kt - Stream resolution
sources/api/src/main/kotlin/app/podium/sources/api/resolve/StreamResolver.kt
Media experiences
- Synchronized lyrics
core/lyrics/src/main/kotlin/app/podium/core/lyrics/LyricsRepository.kt - Radio browser
app/src/main/kotlin/app/podium/radio/RadioScreens.kt - Podcasts
app/src/main/kotlin/app/podium/podcast/PodcastScreens.kt - Quran reader
app/src/main/kotlin/app/podium/quran/QuranScreens.kt - Books
app/src/main/kotlin/app/podium/books/BookRepository.kt
Persistence and device
- App database
core/database/src/main/kotlin/app/podium/core/database/PodiumDatabase.kt - Device settings
feature/settings/src/main/kotlin/app/podium/feature/settings/SettingsScreens.kt - Offline downloads
app/src/main/kotlin/app/podium/downloads/OfflineDownloadManager.kt - Device appearance
core/designsystem/src/main/kotlin/app/podium/core/designsystem/shell/DeviceAppearance.kt
Other components
- Listener
Connections 25
- Listener → Android entry: opens app
README.md - Android entry → Device UI: shows UI
app/src/main/kotlin/app/podium/MainActivity.kt - Device UI → App composition: uses graph
app/src/main/kotlin/app/podium/MainActivity.kt - Listener → Library browse: browses music
README.md - Library browse → Local library: loads library
feature/library/src/main/kotlin/app/podium/feature/library/LibraryRepository.kt - Listener → Online catalogue: searches catalogue
README.md - Online catalogue → Online access: requests catalogue
feature/online/src/main/kotlin/app/podium/feature/online/OnlineRepository.kt - App composition → Music sources: registers sources
app/src/main/kotlin/app/podium/AppGraph.kt - App composition → Local library: configures library
app/src/main/kotlin/app/podium/AppGraph.kt - Online access → Music sources: uses sources
- Music sources → YouTube Music: registers provider
- Listener → Playback controls: controls playback
README.md - Playback controls → Playback service: controls service
- Playback service → Playback engine: creates engine
player/service/src/main/kotlin/app/podium/player/service/PlaybackService.kt - Playback engine → Queue manager: mutates queue
player/service/src/main/kotlin/app/podium/player/service/PodiumPlaybackEngine.kt - Playback engine → Stream resolution: resolves streams
player/service/src/main/kotlin/app/podium/player/service/PodiumPlaybackEngine.kt - App composition → App database: provides persistence
app/src/main/kotlin/app/podium/AppGraph.kt - Listener → Synchronized lyrics: views lyrics
README.md - Listener → Radio browser: browses radio
README.md - Listener → Podcasts: explores podcasts
README.md - Listener → Quran reader: reads Quran
README.md - Listener → Books: uses books
- Listener → Device settings: customizes device
README.md - Listener → Offline downloads: downloads media
- Device settings → Device appearance: changes appearance