How nofayz/zuno works
Zuno is a Tauri desktop client for YouTube Music. The main workflow is browsing or searching music, selecting a track, and playing it through the app’s player, with account-backed library features and offline downloads alongside it. The React UI and player controllers coordinate with a YouTube Music data source; Rust handles native audio and desktop services. The README also documents lyrics, recommendations, local files, multiple tabs, and integrations. Some subsystem links below reflect README capabilities or indexed imports; unsampled implementation details are not asserted.
Main entry points: PlayerController.ts Playback controller · YouTubeMusicDataSource.ts YouTube Music · playerStore.ts Player store · LibraryController.ts Library controller
Components 27
Desktop interface
- Application UI
src/ui/App.tsx - Music views
src/ui/pages - Player controls
src/ui/components/player - Settings view
src/ui/pages/SettingsPage.tsx
Playback and library
- Player store
src/player/playerStore.ts - Playback controller
src/player/PlayerController.ts - Library controller
src/player/LibraryController.ts - Audio engine
src/player/AudioEngine.ts - Playback queue
src/player/Queue.ts - Local playlists
src/player/localPlaylists.ts - Offline downloads
src/player/offlineStore.ts
Music data
- Music data API
src/datasource/DataSource.ts - YouTube Music
src/datasource/youtube/YouTubeMusicDataSource.ts - Lyrics sources
src/datasource/youtube/lyricsSources.ts
Native services
- Tauri backend
src-tauri/src/lib.rs - Discord presence
src/player/DiscordRPC.ts - Last.fm scrobbling
src/player/LastFm.ts
Settings and state
- App settings
src/internal/appSettings.ts - Audio quality
src/internal/audioQuality.ts - Engine preference
src/ui/settings/audioEngine.ts - Connectivity
src/internal/connectivity.ts - Application logging
src/internal/logging.ts
Other components
- Listener
- Desktop platform
- YouTube Music service
- Discord
- Last.fm
Connections 29
- Listener → Application UI: uses
README.md - Application UI → Music views: routes to
src/ui/App.tsx - Application UI → Settings view: routes to
src/ui/App.tsx - Player controls → Player store: controls
- Player store → Playback controller: coordinates
src/player/playerStore.ts - Player store → Library controller: coordinates
src/player/playerStore.ts - Player store → YouTube Music: creates
src/player/playerStore.ts - Playback controller → Music data API: requests tracks
src/player/PlayerController.ts - Playback controller → Audio engine: controls playback
src/player/PlayerController.ts - Playback controller → Playback queue: uses queue
src/player/PlayerController.ts - Library controller → Music data API: loads library
src/player/LibraryController.ts - Library controller → Local playlists: loads local tracks
src/player/LibraryController.ts - YouTube Music → Music data API: implements
src/datasource/youtube/YouTubeMusicDataSource.ts - YouTube Music → YouTube Music service: fetches music
- YouTube Music → Lyrics sources: uses sources
src/datasource/youtube/YouTubeMusicDataSource.ts - Offline downloads → Tauri backend: saves downloads
src/player/offlineStore.ts - Offline downloads → App settings: persists state
src/player/offlineStore.ts - Offline downloads → Audio quality: reads quality
src/player/offlineStore.ts - Audio engine → Engine preference: reads mode
src/player/AudioEngine.ts - Audio engine → Tauri backend: uses Rust audio
src/player/AudioEngine.ts - Engine preference → App settings: persists preference
src/ui/settings/audioEngine.ts - App settings → Tauri backend: reads and writes
src/internal/appSettings.ts - Discord presence → Discord: reports presence
- Last.fm scrobbling → Last.fm: scrobbles tracks
README.md - Tauri backend → Desktop platform: integrates
README.md - Playback controller → Connectivity: checks status
src/player/PlayerController.ts - Library controller → Connectivity: checks status
src/player/LibraryController.ts - YouTube Music → Application logging: logs activity
src/datasource/youtube/YouTubeMusicDataSource.ts - Audio engine → Application logging: logs activity
src/player/AudioEngine.ts