How zeeynrs/senada works
Senada is a Windows/Linux desktop music player. The main workflow is to browse or search YouTube Music, select a track, resolve its audio, and play it through a local mpv engine; users can also import playlists, manage a local library, download tracks, and view synced lyrics. The graph includes the app’s major documented listening, customization, remote-control, and backup capabilities. Some subsystems are represented by their exact tree paths but were not sampled, so their internal connections are omitted.
Main entry points: main.py App startup · player.py Playback controls · library.py Library browsing · resolver.py Audio resolver
Components 32
App and preferences
- App startup
senada/main.py - Settings
senada/config.py - Window session
senada/session.py
Browse and library
- Library browsing
senada/library.py - Catalog facade
senada/catalog.py - YouTube Music
senada/ytmusic.py - Recommendations
senada/discover.py - Spotify import
senada/spotify_import.py - Track matching
senada/matching.py - Local library store
senada/store.py
Playback and lyrics
- Playback controls
senada/player.py - Audio resolver
senada/resolver.py - Stream lookup
senada/streams.py - Audio engine
senada/engine.py - Offline downloads
senada/downloads.py - Synced lyrics
senada/lyrics.py - Local music files
senada/localfiles.py
Personal listening
- Backup and restore
senada/backup.py - Audio effects
senada/effects.py - Crossfade
senada/crossfade.py - Listening stats
senada/stats.py
Companion features
- Phone remote
senada/remote.py - Remote interface
senada/remote_page.py - Discord presence
senada/discord.py - Scrobbling
senada/scrobble.py - Full-screen views
senada/visualizer.py - Mini player
senada/island.py
Other components
- Listener
- YouTube Music service
- Spotify service
- Lyrics services
- mpv player
Connections 43
- Listener → App startup: opens app
README.md - App startup → Settings: loads
senada/main.py - App startup → Catalog facade: creates
senada/main.py - App startup → Playback controls: creates
senada/main.py - App startup → Audio resolver: creates
senada/main.py - App startup → Offline downloads: creates
senada/main.py - App startup → Library browsing: creates
senada/main.py - App startup → Window session: creates
senada/main.py - App startup → Backup and restore: creates
senada/main.py - App startup → Audio effects: creates
senada/main.py - App startup → Discord presence: creates
senada/main.py - App startup → Crossfade: creates
senada/main.py - Library browsing → Catalog facade: requests catalog
senada/library.py - Catalog facade → YouTube Music: queries
senada/catalog.py - YouTube Music → YouTube Music service: requests catalog
senada/ytmusic.py - Library browsing → Recommendations: builds recommendations
senada/library.py - Library browsing → Spotify import: imports playlist
senada/library.py - Library browsing → Track matching: matches tracks
senada/library.py - Library browsing → Local library store: reads and writes
senada/library.py - Playback controls → Audio resolver: resolves track
senada/player.py - Playback controls → Stream lookup: gets stream
senada/player.py - Audio resolver → Track matching: matches track
senada/resolver.py - Audio resolver → YouTube Music: searches track
senada/resolver.py - Audio resolver → Stream lookup: resolves audio
senada/resolver.py - Playback controls → Audio engine: plays audio
senada/player.py - Audio engine → mpv player: controls playback
senada/engine.py - Playback controls → Offline downloads: checks offline file
senada/player.py - Playback controls → Local music files: checks local file
senada/player.py - Playback controls → Local library store: records history
senada/player.py - Playback controls → Synced lyrics: provides track state
senada/main.py - Synced lyrics → Lyrics services: fetches lyrics
senada/lyrics.py - Spotify import → Spotify service: reads public playlists
senada/spotify_import.py - App startup → Local music files: creates
senada/main.py - App startup → Listening stats: connects stats
senada/main.py - Backup and restore → Local library store: backs up library
senada/backup.py - App startup → Phone remote: connects remote
senada/main.py - Phone remote → Remote interface: serves interface
senada/remote.py - Window session → Mini player: manages mini player
senada/session.py - Audio effects → Audio engine: configures audio
- Discord presence → Playback controls: reads playback state
senada/discord.py - Scrobbling → Playback controls: reports listening
- Full-screen views → Playback controls: displays playback
- Crossfade → Audio engine: coordinates engines
senada/crossfade.py