How mrdsp18/notune works
NØTUNE is an Android music player and social music ecosystem. The main user path starts in the app, reaches the playback service, and uses YouTube Music for streaming; users can also search, download or play local music, and use AI and social features. The graph preserves documented capability branches and major indexed modules. Several subsystems are represented at directory level because their source was not sampled; their internal links are omitted where evidence was unavailable.
Main entry points: FlowEngine.kt Music flow · MainActivity.kt Android app · MusicService.kt Playback service · MusicRecognitionService.kt Song recognition
Components 30
App and playback
- Android app
app/src/main/kotlin/com/music/echo/MainActivity.kt - Playback service
app/src/main/kotlin/com/music/echo/playback/MusicService.kt - Player interface
app/src/main/kotlin/com/music/echo/ui/player/Player.kt
Music sources
- Music database
core/src/main/kotlin/echo/music/iad1tya/db/MusicDatabase.kt - Library data access
core/src/main/kotlin/echo/music/iad1tya/db/DatabaseDao.kt - Media metadata
core/src/main/kotlin/echo/music/iad1tya/models/MediaMetadata.kt - YouTube Music
innertube/src/main/kotlin/com/music/innertube/YouTube.kt - YouTube client
innertube/src/main/kotlin/com/music/innertube/models/YouTubeClient.kt - Offline downloads
app/src/main/kotlin/com/music/echo/playback/ExoDownloadService.kt - Local music
app/src/main/kotlin/com/music/echo/localmedia/LocalSongScanner.kt
AI and discovery
- AI music assistant
app/src/main/kotlin/com/music/echo/notune/ai/AiEngine.kt - Music flow
app/src/main/kotlin/com/music/echo/notune/flow/FlowEngine.kt - Flow candidates
app/src/main/kotlin/com/music/echo/notune/flow/FlowCandidateGenerator.kt - Candidate filtering
app/src/main/kotlin/com/music/echo/notune/flow/FlowCandidateFilter.kt - Candidate scoring
app/src/main/kotlin/com/music/echo/notune/flow/FlowCandidateScorer.kt - Queue optimization
app/src/main/kotlin/com/music/echo/notune/flow/FlowQueueOptimizer.kt - Music context
app/src/main/kotlin/com/music/echo/notune/ai/MusicContextEngine.kt - Taste profiles
app/src/main/kotlin/com/music/echo/notune/personalization/repository/TasteProfileRepository.kt - Song recognition
app/src/main/kotlin/com/music/echo/recognition/MusicRecognitionService.kt - Audio resampling
app/src/main/kotlin/com/music/echo/recognition/AudioResampler.kt - Vibra signatures
app/src/main/kotlin/com/music/echo/recognition/VibraSignature.kt - Recognition launcher
app/src/main/kotlin/com/music/echo/recognition/RecognitionForegroundService.kt
Social listening
- Listen Together
app/src/main/kotlin/com/music/echo/listentogether/ListenTogetherManager.kt - Listening rooms
app/src/main/kotlin/com/music/echo/notune/rooms - Social music
app/src/main/kotlin/com/music/echo/notune/social
Supporting services
- Lyrics services
lyrics/src/main/kotlin/echo/music/iad1tya/api - Secure credentials
app/src/main/kotlin/com/music/echo/notune/privacy/security/SecureStorageManager.kt - Custom themes
app/src/main/kotlin/com/music/echo/notune/theme/NoTuneThemeEngine.kt - NØTUNE backend
notune-backend/server.js
Other components
- Listener
Connections 26
- Listener → Android app: opens
- Android app → Playback service: starts
app/src/main/kotlin/com/music/echo/MainActivity.kt - Android app → Listen Together: joins rooms
app/src/main/kotlin/com/music/echo/MainActivity.kt - Android app → Player interface: presents
app/src/main/kotlin/com/music/echo/MainActivity.kt - Playback service → YouTube Music: requests streams
app/src/main/kotlin/com/music/echo/playback/MusicService.kt - YouTube Music → YouTube client: uses client
- Playback service → Music database: reads and writes
app/src/main/kotlin/com/music/echo/playback/MusicService.kt - Music database → Library data access: exposes queries
core/src/main/kotlin/echo/music/iad1tya/db/MusicDatabase.kt - Listener → AI music assistant: asks for music
- Listener → Music flow: starts discovery
- Music flow → Flow candidates: generates candidates
app/src/main/kotlin/com/music/echo/notune/flow/FlowEngine.kt - Music flow → Candidate filtering: filters candidates
app/src/main/kotlin/com/music/echo/notune/flow/FlowEngine.kt - Music flow → Candidate scoring: scores candidates
app/src/main/kotlin/com/music/echo/notune/flow/FlowEngine.kt - Music flow → Queue optimization: optimizes queue
app/src/main/kotlin/com/music/echo/notune/flow/FlowEngine.kt - Music context → Taste profiles: reads taste
app/src/main/kotlin/com/music/echo/notune/ai/MusicContextEngine.kt - Recognition launcher → Song recognition: starts recognition
app/src/main/kotlin/com/music/echo/recognition/RecognitionForegroundService.kt - Song recognition → Audio resampling: resamples audio
app/src/main/kotlin/com/music/echo/recognition/MusicRecognitionService.kt - Song recognition → Vibra signatures: generates signatures
app/src/main/kotlin/com/music/echo/recognition/MusicRecognitionService.kt - Listener → Offline downloads: downloads music
- Listener → Local music: plays local music
- Listener → Lyrics services: uses lyrics
- Listener → Listening rooms: joins rooms
- Listener → Social music: uses social features
- Listener → Custom themes: customizes appearance
- Listener → Secure credentials: stores credentials
- AI music assistant → NØTUNE backend: uses service