How wagefolabessy/bitperfectplayer works
BitPerfectPlayer is an offline Android music player. Users browse a local MediaStore/SAF library, select tracks or playlists, and control playback through the app; the playback coordinator manages queue state and delegates audio rendering to the output engine. Separate branches provide lyrics, diagnostics, safety controls, and local data management. The graph follows documented capabilities and indexed references; several UI and domain implementations were not excerpted, so some plausible connections are omitted or marked unverified.
Main entry points: PlaybackController.kt Playback coordinator · LocalPersistenceRepository.kt Local persistence · MainViewModel.kt App view model · LocalLibraryRepository.kt Local library
Components 20
App and UI
- Main activity
app/src/main/java/com/cangkir/bitperfectplayer/MainActivity.kt - App view model
app/src/main/java/com/cangkir/bitperfectplayer/ui/MainViewModel.kt - Player screens
app/src/main/java/com/cangkir/bitperfectplayer/ui
Library and discovery
- Local library
app/src/main/java/com/cangkir/bitperfectplayer/library/LocalLibraryRepository.kt - Audio metadata
app/src/main/java/com/cangkir/bitperfectplayer/audio/AudioMetadataReader.kt - Artwork loader
app/src/main/java/com/cangkir/bitperfectplayer/library/AlbumArtworkLoader.kt - Playlist repository
app/src/main/java/com/cangkir/bitperfectplayer/library/PlaylistRepository.kt
Playback and audio
- Playback coordinator
app/src/main/java/com/cangkir/bitperfectplayer/audio/PlaybackController.kt - Playback queue
app/src/main/java/com/cangkir/bitperfectplayer/audio/PlaybackQueueManager.kt - Foreground service
app/src/main/java/com/cangkir/bitperfectplayer/audio/PlaybackForegroundService.kt - Audio output
app/src/main/java/com/cangkir/bitperfectplayer/audio/AudioOutputEngine.kt - Hearing safety
app/src/main/java/com/cangkir/bitperfectplayer/audio/AudioSafetyController.kt - Audio diagnostics
app/src/main/java/com/cangkir/bitperfectplayer/audio/AudioDiagnosticMapper.kt
Local data features
- Offline lyrics
app/src/main/java/com/cangkir/bitperfectplayer/lyrics/LyricsRepository.kt - Local persistence
app/src/main/java/com/cangkir/bitperfectplayer/data/LocalPersistenceRepository.kt - Room database
app/src/main/java/com/cangkir/bitperfectplayer/data/BitPerfectDatabase.kt - User preferences
app/src/main/java/com/cangkir/bitperfectplayer/data/UserPreferencesRepository.kt - Backup repository
app/src/main/java/com/cangkir/bitperfectplayer/data/LocalBackupRepository.kt - Backup codec
app/src/main/java/com/cangkir/bitperfectplayer/data/LocalBackupCodec.kt
Other components
- Listener
Connections 23
- Listener → Main activity: opens app
README.md - Main activity → App view model: creates
app/src/main/java/com/cangkir/bitperfectplayer/MainActivity.kt - Listener → Player screens: uses
README.md - Player screens → App view model: uses
- App view model → Local library: requests library
- Local library → Audio metadata: reads metadata
app/src/main/java/com/cangkir/bitperfectplayer/library/LocalLibraryRepository.kt - App view model → Playlist repository: manages playlists
- Player screens → Artwork loader: loads artwork
app/src/main/java/com/cangkir/bitperfectplayer/ui/LibraryScreen.kt - App view model → Playback coordinator: controls playback
- Playback coordinator → Playback queue: manages queue
app/src/main/java/com/cangkir/bitperfectplayer/audio/PlaybackController.kt - Playback coordinator → Audio output: controls audio
app/src/main/java/com/cangkir/bitperfectplayer/audio/PlaybackController.kt - Foreground service → Playback coordinator: dispatches controls
app/src/main/java/com/cangkir/bitperfectplayer/audio/PlaybackForegroundService.kt - Playback coordinator → Hearing safety: coordinates safety
app/src/main/java/com/cangkir/bitperfectplayer/audio/PlaybackController.kt - Audio output → Audio diagnostics: maps audio state
app/src/main/java/com/cangkir/bitperfectplayer/audio/AudioOutputEngine.kt - Playback coordinator → Local persistence: saves playback
app/src/main/java/com/cangkir/bitperfectplayer/audio/PlaybackController.kt - Playback coordinator → User preferences: reads settings
app/src/main/java/com/cangkir/bitperfectplayer/audio/PlaybackController.kt - Local library → Local persistence: caches tracks
app/src/main/java/com/cangkir/bitperfectplayer/library/LocalLibraryRepository.kt - Local library → User preferences: stores SAF access
app/src/main/java/com/cangkir/bitperfectplayer/library/LocalLibraryRepository.kt - Offline lyrics → Local persistence: stores lyrics
app/src/main/java/com/cangkir/bitperfectplayer/lyrics/LyricsRepository.kt - Playlist repository → Local persistence: uses local records
app/src/main/java/com/cangkir/bitperfectplayer/library/PlaylistRepository.kt - Local persistence → Room database: uses DAOs
app/src/main/java/com/cangkir/bitperfectplayer/data/LocalPersistenceRepository.kt - Backup repository → Local persistence: exports records
app/src/main/java/com/cangkir/bitperfectplayer/data/LocalBackupRepository.kt - Backup repository → Backup codec: encodes backup
app/src/main/java/com/cangkir/bitperfectplayer/data/LocalBackupRepository.kt