# larevuegeek/rustmusic-desktop architecture

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

- Interactive diagram: https://gitdiagram.com/larevuegeek/rustmusic-desktop
- Repository: https://github.com/larevuegeek/rustmusic-desktop

## Overview

RustMusic is a cross-platform desktop music player. The principal workflow is browsing or searching an indexed library, choosing a track, and playing it through the configured audio output; playback can use exclusive bit-perfect output or native DSD over DoP. Separate branches cover library and tag management, playlists, podcasts and radio, and network playback or serving. The graph combines documented capabilities with source-index references; unsampled subsystem links are omitted rather than inferred.

Main entry points: [`src/lib/components/library`](https://github.com/larevuegeek/rustmusic-desktop/tree/main/src/lib/components/library) (Library views), [`src-tauri/src/core/audio_player/audio_player.rs`](https://github.com/larevuegeek/rustmusic-desktop/blob/main/src-tauri/src/core/audio_player/audio_player.rs) (Audio engine), [`src/lib/services/player/player.service.ts`](https://github.com/larevuegeek/rustmusic-desktop/blob/main/src/lib/services/player/player.service.ts) (Player service), [`src-tauri/src/commands/library`](https://github.com/larevuegeek/rustmusic-desktop/tree/main/src-tauri/src/commands/library) (Library commands)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_frontend["Desktop interface"]
  node_ui["Svelte interface<br/>[+layout.svelte]"]
  node_player_ui["Player controls<br/>[Player.svelte]"]
  node_library_ui["Library views"]
  node_playback_ui["Player service<br/>[player.service.ts]"]
end

subgraph group_library["Library and curation"]
  node_library_commands["Library commands"]
  node_library_scan["Library indexing<br/>[library_service.rs]"]
  node_library_store[("Library repositories")]
  node_tag_tools["Tag editing"]
  node_playlist["Smart playlists<br/>[engine.rs]"]
end

subgraph group_playback["Playback engine"]
  node_playback_commands["Playback commands<br/>[playback.rs]"]
  node_audio_engine["Audio engine<br/>[audio_player.rs]"]
  node_dop_output["Native DSD output<br/>[dop_engine.rs]"]
  node_shared_output["Shared audio output<br/>[shared_engine.rs]"]
  node_pipeline_info["Pipeline status<br/>[pipeline_info.rs]"]
end

subgraph group_online["Online and network"]
  node_podcasts["Podcast features<br/>[podcast_service.rs]"]
  node_radio["Radio features"]
  node_network_player["Network playback<br/>[session.rs]"]
  node_amp_remote["Amplifier remote<br/>[session.rs]"]
  node_dlna["DLNA server<br/>[server.rs]"]
end

subgraph group_platform["Persistence and platform"]
  node_sqlite[("SQLite database<br/>[sqlite.rs]")]
  node_settings[("Settings storage")]
  node_media_controls["OS media controls<br/>[media_controls.rs]"]
end

node_listener(("Listener"))

node_listener -->|"uses"| node_ui
node_ui -->|"browses"| node_library_ui
node_library_ui -.->|"requests library"| node_library_commands
node_library_commands -.->|"indexes files"| node_library_scan
node_library_scan -->|"stores tracks"| node_library_store
node_library_commands -.->|"queries library"| node_library_store
node_library_ui -->|"edits tags"| node_tag_tools
node_library_ui -->|"builds playlists"| node_playlist
node_listener -->|"selects music"| node_player_ui
node_player_ui -.->|"controls playback"| node_playback_ui
node_playback_ui -.->|"invokes commands"| node_playback_commands
node_playback_commands -->|"starts playback"| node_audio_engine
node_audio_engine -->|"uses DoP"| node_dop_output
node_audio_engine -->|"uses shared output"| node_shared_output
node_audio_engine -.->|"emits pipeline"| node_pipeline_info
node_listener -->|"listens to podcasts"| node_podcasts
node_listener -->|"listens to radio"| node_radio
node_listener -->|"plays to devices"| node_network_player
node_listener -.->|"controls amplifier"| node_amp_remote
node_listener -->|"serves library"| node_dlna
node_library_store -.->|"persists data"| node_sqlite
node_playback_ui -->|"integrates controls"| node_media_controls
node_playback_commands -->|"reads settings"| node_settings

click node_ui "https://github.com/larevuegeek/rustmusic-desktop/blob/main/src/routes/%2Blayout.svelte"
click node_player_ui "https://github.com/larevuegeek/rustmusic-desktop/blob/main/src/lib/components/player/Player.svelte"
click node_library_ui "https://github.com/larevuegeek/rustmusic-desktop/tree/main/src/lib/components/library"
click node_playback_ui "https://github.com/larevuegeek/rustmusic-desktop/blob/main/src/lib/services/player/player.service.ts"
click node_library_commands "https://github.com/larevuegeek/rustmusic-desktop/tree/main/src-tauri/src/commands/library"
click node_library_scan "https://github.com/larevuegeek/rustmusic-desktop/blob/main/src-tauri/src/service/library/library_service.rs"
click node_library_store "https://github.com/larevuegeek/rustmusic-desktop/blob/main/src-tauri/src/repository/library/library_track_repository.rs"
click node_tag_tools "https://github.com/larevuegeek/rustmusic-desktop/tree/main/src-tauri/src/commands/tags"
click node_playback_commands "https://github.com/larevuegeek/rustmusic-desktop/blob/main/src-tauri/src/commands/playback/playback.rs"
click node_audio_engine "https://github.com/larevuegeek/rustmusic-desktop/blob/main/src-tauri/src/core/audio_player/audio_player.rs"
click node_dop_output "https://github.com/larevuegeek/rustmusic-desktop/blob/main/src-tauri/src/core/audio_player/output/dop_engine.rs"
click node_shared_output "https://github.com/larevuegeek/rustmusic-desktop/blob/main/src-tauri/src/core/audio_player/output/shared_engine.rs"
click node_pipeline_info "https://github.com/larevuegeek/rustmusic-desktop/blob/main/src-tauri/src/core/audio_player/pipeline_info.rs"
click node_playlist "https://github.com/larevuegeek/rustmusic-desktop/blob/main/src-tauri/src/core/smart_playlist/engine.rs"
click node_podcasts "https://github.com/larevuegeek/rustmusic-desktop/blob/main/src-tauri/src/service/podcast/podcast_service.rs"
click node_radio "https://github.com/larevuegeek/rustmusic-desktop/tree/main/src-tauri/src/core/radio"
click node_network_player "https://github.com/larevuegeek/rustmusic-desktop/blob/main/src-tauri/src/core/network_player/session.rs"
click node_amp_remote "https://github.com/larevuegeek/rustmusic-desktop/blob/main/src-tauri/src/core/amp_remote/session.rs"
click node_dlna "https://github.com/larevuegeek/rustmusic-desktop/blob/main/src-tauri/src/core/dlna_server/server.rs"
click node_sqlite "https://github.com/larevuegeek/rustmusic-desktop/blob/main/src-tauri/src/helper/database/sqlite.rs"
click node_settings "https://github.com/larevuegeek/rustmusic-desktop/blob/main/src-tauri/src/repository/settings/settings_repository.rs"
click node_media_controls "https://github.com/larevuegeek/rustmusic-desktop/blob/main/src-tauri/src/core/media_controls.rs"

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_ui,node_player_ui,node_library_ui,node_playback_ui toneBlue
class node_library_commands,node_library_scan,node_library_store,node_tag_tools,node_playlist toneAmber
class node_playback_commands,node_audio_engine,node_dop_output,node_shared_output,node_pipeline_info toneMint
class node_podcasts,node_radio,node_network_player,node_amp_remote,node_dlna toneRose
class node_sqlite,node_settings,node_media_controls,node_listener toneIndigo
```

## Components

### Desktop interface

- [Svelte interface](https://github.com/larevuegeek/rustmusic-desktop/blob/main/src/routes/%2Blayout.svelte): `src/routes/+layout.svelte`
- [Player controls](https://github.com/larevuegeek/rustmusic-desktop/blob/main/src/lib/components/player/Player.svelte): `src/lib/components/player/Player.svelte`
- [Library views](https://github.com/larevuegeek/rustmusic-desktop/tree/main/src/lib/components/library): `src/lib/components/library`
- [Player service](https://github.com/larevuegeek/rustmusic-desktop/blob/main/src/lib/services/player/player.service.ts): `src/lib/services/player/player.service.ts`

### Library and curation

- [Library commands](https://github.com/larevuegeek/rustmusic-desktop/tree/main/src-tauri/src/commands/library): `src-tauri/src/commands/library`
- [Library indexing](https://github.com/larevuegeek/rustmusic-desktop/blob/main/src-tauri/src/service/library/library_service.rs): `src-tauri/src/service/library/library_service.rs`
- [Library repositories](https://github.com/larevuegeek/rustmusic-desktop/blob/main/src-tauri/src/repository/library/library_track_repository.rs): `src-tauri/src/repository/library/library_track_repository.rs`
- [Tag editing](https://github.com/larevuegeek/rustmusic-desktop/tree/main/src-tauri/src/commands/tags): `src-tauri/src/commands/tags`
- [Smart playlists](https://github.com/larevuegeek/rustmusic-desktop/blob/main/src-tauri/src/core/smart_playlist/engine.rs): `src-tauri/src/core/smart_playlist/engine.rs`

### Playback engine

- [Playback commands](https://github.com/larevuegeek/rustmusic-desktop/blob/main/src-tauri/src/commands/playback/playback.rs): `src-tauri/src/commands/playback/playback.rs`
- [Audio engine](https://github.com/larevuegeek/rustmusic-desktop/blob/main/src-tauri/src/core/audio_player/audio_player.rs): `src-tauri/src/core/audio_player/audio_player.rs`
- [Native DSD output](https://github.com/larevuegeek/rustmusic-desktop/blob/main/src-tauri/src/core/audio_player/output/dop_engine.rs): `src-tauri/src/core/audio_player/output/dop_engine.rs`
- [Shared audio output](https://github.com/larevuegeek/rustmusic-desktop/blob/main/src-tauri/src/core/audio_player/output/shared_engine.rs): `src-tauri/src/core/audio_player/output/shared_engine.rs`
- [Pipeline status](https://github.com/larevuegeek/rustmusic-desktop/blob/main/src-tauri/src/core/audio_player/pipeline_info.rs): `src-tauri/src/core/audio_player/pipeline_info.rs`

### Online and network

- [Podcast features](https://github.com/larevuegeek/rustmusic-desktop/blob/main/src-tauri/src/service/podcast/podcast_service.rs): `src-tauri/src/service/podcast/podcast_service.rs`
- [Radio features](https://github.com/larevuegeek/rustmusic-desktop/tree/main/src-tauri/src/core/radio): `src-tauri/src/core/radio`
- [Network playback](https://github.com/larevuegeek/rustmusic-desktop/blob/main/src-tauri/src/core/network_player/session.rs): `src-tauri/src/core/network_player/session.rs`
- [Amplifier remote](https://github.com/larevuegeek/rustmusic-desktop/blob/main/src-tauri/src/core/amp_remote/session.rs): `src-tauri/src/core/amp_remote/session.rs`
- [DLNA server](https://github.com/larevuegeek/rustmusic-desktop/blob/main/src-tauri/src/core/dlna_server/server.rs): `src-tauri/src/core/dlna_server/server.rs`

### Persistence and platform

- [SQLite database](https://github.com/larevuegeek/rustmusic-desktop/blob/main/src-tauri/src/helper/database/sqlite.rs): `src-tauri/src/helper/database/sqlite.rs`
- [Settings storage](https://github.com/larevuegeek/rustmusic-desktop/blob/main/src-tauri/src/repository/settings/settings_repository.rs): `src-tauri/src/repository/settings/settings_repository.rs`
- [OS media controls](https://github.com/larevuegeek/rustmusic-desktop/blob/main/src-tauri/src/core/media_controls.rs): `src-tauri/src/core/media_controls.rs`

### Other components

- **Listener**

## Connections

- Listener → Svelte interface: uses (evidence: `README.md`)
- Svelte interface → Library views: browses (evidence: `README.md`)
- Library views → Library commands: requests library
- Library commands → Library indexing: indexes files
- Library indexing → Library repositories: stores tracks (evidence: `src-tauri/src/service/library/library_service.rs`)
- Library commands → Library repositories: queries library
- Library views → Tag editing: edits tags (evidence: `README.md`)
- Library views → Smart playlists: builds playlists (evidence: `README.md`)
- Listener → Player controls: selects music (evidence: `README.md`)
- Player controls → Player service: controls playback
- Player service → Playback commands: invokes commands
- Playback commands → Audio engine: starts playback
- Audio engine → Native DSD output: uses DoP (evidence: `src-tauri/src/core/audio_player/output/dop_engine.rs`)
- Audio engine → Shared audio output: uses shared output (evidence: `src-tauri/src/core/audio_player/output/shared_engine.rs`)
- Audio engine → Pipeline status: emits pipeline
- Listener → Podcast features: listens to podcasts (evidence: `README.md`)
- Listener → Radio features: listens to radio (evidence: `README.md`)
- Listener → Network playback: plays to devices (evidence: `README.md`)
- Listener → Amplifier remote: controls amplifier
- Listener → DLNA server: serves library (evidence: `README.md`)
- Library repositories → SQLite database: persists data
- Player service → OS media controls: integrates controls (evidence: `README.md`)
- Playback commands → Settings storage: reads settings (evidence: `src-tauri/src/commands/audio/audio_command.rs`)
