# nofayz/zuno architecture

> Architecture diagram of the GitHub repository nofayz/zuno, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-03). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/nofayz/zuno
- Repository: https://github.com/nofayz/zuno

## Overview

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: [`src/player/PlayerController.ts`](https://github.com/nofayz/zuno/blob/main/src/player/PlayerController.ts) (Playback controller), [`src/datasource/youtube/YouTubeMusicDataSource.ts`](https://github.com/nofayz/zuno/blob/main/src/datasource/youtube/YouTubeMusicDataSource.ts) (YouTube Music), [`src/player/playerStore.ts`](https://github.com/nofayz/zuno/blob/main/src/player/playerStore.ts) (Player store), [`src/player/LibraryController.ts`](https://github.com/nofayz/zuno/blob/main/src/player/LibraryController.ts) (Library controller)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_ui["Desktop interface"]
  node_app["Application UI<br/>[App.tsx]"]
  node_views["Music views"]
  node_playerui["Player controls"]
  node_settingsui["Settings view<br/>[SettingsPage.tsx]"]
end

subgraph group_playback["Playback and library"]
  node_store["Player store<br/>[playerStore.ts]"]
  node_playctrl["Playback controller"]
  node_library["Library controller"]
  node_audio["Audio engine<br/>[AudioEngine.ts]"]
  node_queue["Playback queue<br/>[Queue.ts]"]
  node_localplaylist["Local playlists<br/>[localPlaylists.ts]"]
  node_offline["Offline downloads<br/>[offlineStore.ts]"]
end

subgraph group_musicdata["Music data"]
  node_datasource["Music data API<br/>[DataSource.ts]"]
  node_youtube["YouTube Music"]
  node_lyrics["Lyrics sources<br/>[lyricsSources.ts]"]
end

subgraph group_native["Native services"]
  node_rust["Tauri backend<br/>[lib.rs]"]
  node_rpc["Discord presence<br/>[DiscordRPC.ts]"]
  node_lastfm["Last.fm scrobbling<br/>[LastFm.ts]"]
end

subgraph group_settings["Settings and state"]
  node_settings[("App settings<br/>[appSettings.ts]")]
  node_quality["Audio quality<br/>[audioQuality.ts]"]
  node_engineconfig["Engine preference<br/>[audioEngine.ts]"]
  node_connectivity["Connectivity<br/>[connectivity.ts]"]
  node_logging["Application logging<br/>[logging.ts]"]
end

node_user(("Listener"))
node_os{{"Desktop platform"}}
node_youtube_service{{"YouTube Music service"}}
node_discord_service{{"Discord"}}
node_lastfm_service{{"Last.fm"}}

node_user -->|"uses"| node_app
node_app -->|"routes to"| node_views
node_app -->|"routes to"| node_settingsui
node_playerui -.->|"controls"| node_store
node_store -->|"coordinates"| node_playctrl
node_store -->|"coordinates"| node_library
node_store -->|"creates"| node_youtube
node_playctrl -->|"requests tracks"| node_datasource
node_playctrl -->|"controls playback"| node_audio
node_playctrl -->|"uses queue"| node_queue
node_library -->|"loads library"| node_datasource
node_library -->|"loads local tracks"| node_localplaylist
node_youtube -->|"implements"| node_datasource
node_youtube -.->|"fetches music"| node_youtube_service
node_youtube -->|"uses sources"| node_lyrics
node_offline -->|"saves downloads"| node_rust
node_offline -->|"persists state"| node_settings
node_offline -->|"reads quality"| node_quality
node_audio -->|"reads mode"| node_engineconfig
node_audio -->|"uses Rust audio"| node_rust
node_engineconfig -->|"persists preference"| node_settings
node_settings -->|"reads and writes"| node_rust
node_rpc -.->|"reports presence"| node_discord_service
node_lastfm -.->|"scrobbles tracks"| node_lastfm_service
node_rust -->|"integrates"| node_os
node_playctrl -->|"checks status"| node_connectivity
node_library -->|"checks status"| node_connectivity
node_youtube -->|"logs activity"| node_logging
node_audio -->|"logs activity"| node_logging

click node_app "https://github.com/nofayz/zuno/blob/main/src/ui/App.tsx"
click node_views "https://github.com/nofayz/zuno/tree/main/src/ui/pages"
click node_playerui "https://github.com/nofayz/zuno/tree/main/src/ui/components/player"
click node_settingsui "https://github.com/nofayz/zuno/blob/main/src/ui/pages/SettingsPage.tsx"
click node_store "https://github.com/nofayz/zuno/blob/main/src/player/playerStore.ts"
click node_playctrl "https://github.com/nofayz/zuno/blob/main/src/player/PlayerController.ts"
click node_library "https://github.com/nofayz/zuno/blob/main/src/player/LibraryController.ts"
click node_audio "https://github.com/nofayz/zuno/blob/main/src/player/AudioEngine.ts"
click node_queue "https://github.com/nofayz/zuno/blob/main/src/player/Queue.ts"
click node_localplaylist "https://github.com/nofayz/zuno/blob/main/src/player/localPlaylists.ts"
click node_offline "https://github.com/nofayz/zuno/blob/main/src/player/offlineStore.ts"
click node_datasource "https://github.com/nofayz/zuno/blob/main/src/datasource/DataSource.ts"
click node_youtube "https://github.com/nofayz/zuno/blob/main/src/datasource/youtube/YouTubeMusicDataSource.ts"
click node_lyrics "https://github.com/nofayz/zuno/blob/main/src/datasource/youtube/lyricsSources.ts"
click node_rust "https://github.com/nofayz/zuno/blob/main/src-tauri/src/lib.rs"
click node_rpc "https://github.com/nofayz/zuno/blob/main/src/player/DiscordRPC.ts"
click node_lastfm "https://github.com/nofayz/zuno/blob/main/src/player/LastFm.ts"
click node_settings "https://github.com/nofayz/zuno/blob/main/src/internal/appSettings.ts"
click node_quality "https://github.com/nofayz/zuno/blob/main/src/internal/audioQuality.ts"
click node_engineconfig "https://github.com/nofayz/zuno/blob/main/src/ui/settings/audioEngine.ts"
click node_connectivity "https://github.com/nofayz/zuno/blob/main/src/internal/connectivity.ts"
click node_logging "https://github.com/nofayz/zuno/blob/main/src/internal/logging.ts"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_app,node_views,node_playerui,node_settingsui toneBlue
class node_store,node_playctrl,node_library,node_audio,node_queue,node_localplaylist,node_offline toneAmber
class node_datasource,node_youtube,node_lyrics toneMint
class node_rust,node_rpc,node_lastfm toneRose
class node_settings,node_quality,node_engineconfig,node_connectivity,node_logging,node_user,node_os,node_youtube_service,node_discord_service,node_lastfm_service toneIndigo
```

## Components

### Desktop interface

- [Application UI](https://github.com/nofayz/zuno/blob/main/src/ui/App.tsx): `src/ui/App.tsx`
- [Music views](https://github.com/nofayz/zuno/tree/main/src/ui/pages): `src/ui/pages`
- [Player controls](https://github.com/nofayz/zuno/tree/main/src/ui/components/player): `src/ui/components/player`
- [Settings view](https://github.com/nofayz/zuno/blob/main/src/ui/pages/SettingsPage.tsx): `src/ui/pages/SettingsPage.tsx`

### Playback and library

- [Player store](https://github.com/nofayz/zuno/blob/main/src/player/playerStore.ts): `src/player/playerStore.ts`
- [Playback controller](https://github.com/nofayz/zuno/blob/main/src/player/PlayerController.ts): `src/player/PlayerController.ts`
- [Library controller](https://github.com/nofayz/zuno/blob/main/src/player/LibraryController.ts): `src/player/LibraryController.ts`
- [Audio engine](https://github.com/nofayz/zuno/blob/main/src/player/AudioEngine.ts): `src/player/AudioEngine.ts`
- [Playback queue](https://github.com/nofayz/zuno/blob/main/src/player/Queue.ts): `src/player/Queue.ts`
- [Local playlists](https://github.com/nofayz/zuno/blob/main/src/player/localPlaylists.ts): `src/player/localPlaylists.ts`
- [Offline downloads](https://github.com/nofayz/zuno/blob/main/src/player/offlineStore.ts): `src/player/offlineStore.ts`

### Music data

- [Music data API](https://github.com/nofayz/zuno/blob/main/src/datasource/DataSource.ts): `src/datasource/DataSource.ts`
- [YouTube Music](https://github.com/nofayz/zuno/blob/main/src/datasource/youtube/YouTubeMusicDataSource.ts): `src/datasource/youtube/YouTubeMusicDataSource.ts`
- [Lyrics sources](https://github.com/nofayz/zuno/blob/main/src/datasource/youtube/lyricsSources.ts): `src/datasource/youtube/lyricsSources.ts`

### Native services

- [Tauri backend](https://github.com/nofayz/zuno/blob/main/src-tauri/src/lib.rs): `src-tauri/src/lib.rs`
- [Discord presence](https://github.com/nofayz/zuno/blob/main/src/player/DiscordRPC.ts): `src/player/DiscordRPC.ts`
- [Last.fm scrobbling](https://github.com/nofayz/zuno/blob/main/src/player/LastFm.ts): `src/player/LastFm.ts`

### Settings and state

- [App settings](https://github.com/nofayz/zuno/blob/main/src/internal/appSettings.ts): `src/internal/appSettings.ts`
- [Audio quality](https://github.com/nofayz/zuno/blob/main/src/internal/audioQuality.ts): `src/internal/audioQuality.ts`
- [Engine preference](https://github.com/nofayz/zuno/blob/main/src/ui/settings/audioEngine.ts): `src/ui/settings/audioEngine.ts`
- [Connectivity](https://github.com/nofayz/zuno/blob/main/src/internal/connectivity.ts): `src/internal/connectivity.ts`
- [Application logging](https://github.com/nofayz/zuno/blob/main/src/internal/logging.ts): `src/internal/logging.ts`

### Other components

- **Listener**
- **Desktop platform**
- **YouTube Music service**
- **Discord**
- **Last.fm**

## Connections

- Listener → Application UI: uses (evidence: `README.md`)
- Application UI → Music views: routes to (evidence: `src/ui/App.tsx`)
- Application UI → Settings view: routes to (evidence: `src/ui/App.tsx`)
- Player controls → Player store: controls
- Player store → Playback controller: coordinates (evidence: `src/player/playerStore.ts`)
- Player store → Library controller: coordinates (evidence: `src/player/playerStore.ts`)
- Player store → YouTube Music: creates (evidence: `src/player/playerStore.ts`)
- Playback controller → Music data API: requests tracks (evidence: `src/player/PlayerController.ts`)
- Playback controller → Audio engine: controls playback (evidence: `src/player/PlayerController.ts`)
- Playback controller → Playback queue: uses queue (evidence: `src/player/PlayerController.ts`)
- Library controller → Music data API: loads library (evidence: `src/player/LibraryController.ts`)
- Library controller → Local playlists: loads local tracks (evidence: `src/player/LibraryController.ts`)
- YouTube Music → Music data API: implements (evidence: `src/datasource/youtube/YouTubeMusicDataSource.ts`)
- YouTube Music → YouTube Music service: fetches music
- YouTube Music → Lyrics sources: uses sources (evidence: `src/datasource/youtube/YouTubeMusicDataSource.ts`)
- Offline downloads → Tauri backend: saves downloads (evidence: `src/player/offlineStore.ts`)
- Offline downloads → App settings: persists state (evidence: `src/player/offlineStore.ts`)
- Offline downloads → Audio quality: reads quality (evidence: `src/player/offlineStore.ts`)
- Audio engine → Engine preference: reads mode (evidence: `src/player/AudioEngine.ts`)
- Audio engine → Tauri backend: uses Rust audio (evidence: `src/player/AudioEngine.ts`)
- Engine preference → App settings: persists preference (evidence: `src/ui/settings/audioEngine.ts`)
- App settings → Tauri backend: reads and writes (evidence: `src/internal/appSettings.ts`)
- Discord presence → Discord: reports presence
- Last.fm scrobbling → Last.fm: scrobbles tracks (evidence: `README.md`)
- Tauri backend → Desktop platform: integrates (evidence: `README.md`)
- Playback controller → Connectivity: checks status (evidence: `src/player/PlayerController.ts`)
- Library controller → Connectivity: checks status (evidence: `src/player/LibraryController.ts`)
- YouTube Music → Application logging: logs activity (evidence: `src/datasource/youtube/YouTubeMusicDataSource.ts`)
- Audio engine → Application logging: logs activity (evidence: `src/player/AudioEngine.ts`)
