How harbertraj/beatraxus works
Beatraxus is an Android music player whose central workflow is discovering local or remote music, selecting a track, and playing it through a custom audio engine with configurable DSP and output. Its documented capabilities also include cloud/NAS and Telegram sources, casting, Auto-EQ and AI analysis, lyrics, video playback and subtitles, and streaming add-ons. The map follows indexed references and explicit README claims; several feature branches are represented at their subsystem paths because their implementation was not sampled.
Main entry points: AudioEngine.kt Audio engine · MainScreen.kt Main screen · CloudCacheManager.kt Cloud streaming · NowPlayingScreen.kt Player screens
Components 22
App experience
- Main screen
app/src/main/java/com/beatraxus/app/ui/screens/MainScreen.kt - Player screens
app/src/main/java/com/beatraxus/app/ui/screens/NowPlayingScreen.kt - Video player
app/src/main/java/com/beatraxus/app/ui/screens/VideoPlayerScreen.kt
Media sources
- Library scanning
app/src/main/java/com/beatraxus/app/repository/LibraryScanner.kt - Cloud streaming
app/src/main/java/com/beatraxus/app/drive/CloudCacheManager.kt - Telegram access
app/src/main/java/com/beatraxus/app/telegram/TdLibManager.kt - NAS connections
app/src/main/java/com/beatraxus/app/repository/SmbConnectionRepository.kt - Streaming add-ons
app/src/main/java/com/beatraxus/app/addons/AddonManager.kt
Playback and audio
- Playback service
app/src/main/java/com/beatraxus/app/service/AudioPlaybackService.kt - Audio engine
app/src/main/java/com/beatraxus/app/engine/AudioEngine.kt - Audio decoding
app/src/main/java/com/beatraxus/app/engine/DecoderFactory.kt - DSP pipeline
app/src/main/java/com/beatraxus/app/engine/DspPipeline.kt - Native DSP
app/src/main/java/com/beatraxus/app/engine/NativeDsp.kt - Audio output
app/src/main/java/com/beatraxus/app/engine/AudioOutput.kt - Casting
app/src/main/java/com/beatraxus/app/cast/CastManager.kt
Enrichment and data
- App database
app/src/main/java/com/beatraxus/app/model/AppDatabase.kt - AI analysis
app/src/main/java/com/beatraxus/app/engine/AiAnalysisEngine.kt - Auto-EQ
app/src/main/java/com/beatraxus/app/repository/AutoEqRepository.kt - Lyrics
app/src/main/java/com/beatraxus/app/repository/LyricsRepository.kt
Connected features
- Subtitle support
app/src/main/java/com/beatraxus/app/subtitles/viewmodel/SubtitleViewModel.kt - Video audio bridge
app/src/main/java/com/beatraxus/app/service/VideoAudioBridge.kt
Other components
- Listener
Connections 22
- Listener → Main screen: browses
- Main screen → Library scanning: browses library
- Library scanning → Cloud streaming: streams and caches
- Cloud streaming → Audio engine: provides media
app/src/main/java/com/beatraxus/app/engine/AudioEngine.kt - Cloud streaming → Telegram access: requests content
app/src/main/java/com/beatraxus/app/drive/CloudCacheManager.kt - Main screen → Streaming add-ons: browses add-ons
- NAS connections → Cloud streaming: provides remote files
app/src/main/java/com/beatraxus/app/drive/CloudCacheManager.kt - Main screen → Player screens: opens playback
- Player screens → Playback service: controls playback
- Playback service → Audio engine: controls
app/src/main/java/com/beatraxus/app/service/AudioPlaybackService.kt - Audio engine → Audio decoding: selects decoder
app/src/main/java/com/beatraxus/app/engine/AudioEngine.kt - Audio engine → Audio output: renders audio
app/src/main/java/com/beatraxus/app/engine/AudioEngine.kt - Audio engine → DSP pipeline: processes audio
- DSP pipeline → Native DSP: invokes DSP
app/src/main/java/com/beatraxus/app/engine/DspPipeline.kt - Playback service → Casting: routes playback
app/src/main/java/com/beatraxus/app/service/AudioPlaybackService.kt - Audio engine → App database: uses stored state
app/src/main/java/com/beatraxus/app/engine/AudioEngine.kt - AI analysis → App database: stores analysis
- AI analysis → Auto-EQ: calculates EQ
app/src/main/java/com/beatraxus/app/engine/AiAnalysisEngine.kt - Player screens → Lyrics: shows lyrics
- Main screen → Video player: opens video
- Video player → Subtitle support: manages subtitles
- Video player → Video audio bridge: bridges audio