How ashmitvoid/ryotunes works
Ryotunes is a Ryoku-native desktop music player: the Svelte interface issues requests to a Tauri/Rust host, which manages catalog data and playback independently of the UI. The host resolves YouTube streams through Innertube and native playback, while also supporting local music, radio, lyrics, persistent library state, and desktop/social integrations. The README documents the main boundary and lifecycle; sampled excerpts and the source index support several internal links. Some feature-to-command wiring is unsampled, so those links are omitted.
Main entry points: state.rs App state · commands.rs Tauri commands · endpoints.rs Innertube API · orchestrator.rs Stream resolver
Components 26
Desktop interface
- Svelte UI
ui/src/routes/+page.svelte - Search pages
ui/src/routes/search/+page.svelte - UI API
ui/src/lib/api.ts
Native host
- Tauri commands
src-tauri/src/commands.rs - App state
src-tauri/src/state.rs - Host lifecycle
src-tauri/src/lib.rs - SQLite state
src-tauri/src/db.rs
Music services
- Innertube API
crates/innertube/src/endpoints.rs - Browse models
crates/innertube/src/models/browse.rs - Search metadata
crates/innertube/src/models/metadata.rs - Local music
src-tauri/src/local.rs - Radio
src-tauri/src/radio.rs - Lyrics
src-tauri/src/lyrics.rs
Playback core
- Stream resolver
src-tauri/src/orchestrator.rs - Stream decipher
src-tauri/src/cipher/mod.rs - PoToken minting
src-tauri/src/potoken/mod.rs - Native player
crates/player/src/lib.rs
Desktop integrations
- Listen Together
src-tauri/src/listentogether/mod.rs - Room relay
crates/sync-server/src/main.rs - Last.fm
src-tauri/src/lastfm.rs - Discord presence
src-tauri/src/discord.rs - WebView lifecycle
src-tauri/src/webview.rs
Other components
- Listener
- Ryoku / Hyprland
- YouTube Music
- libmpv
Connections 27
- Listener → Svelte UI: uses
README.md - Svelte UI → UI API: requests
README.md - UI API → Tauri commands: invokes
- Tauri commands → App state: dispatches
src-tauri/src/commands.rs - App state → SQLite state: reads/writes
src-tauri/src/state.rs - Host lifecycle → SQLite state: initializes
src-tauri/src/lib.rs - Host lifecycle → App state: creates
src-tauri/src/lib.rs - App state → Stream resolver: resolves via
src-tauri/src/state.rs - Stream resolver → Innertube API: requests streams
src-tauri/src/orchestrator.rs - Stream resolver → Stream decipher: deciphers
src-tauri/src/orchestrator.rs - Stream resolver → PoToken minting: mints tokens
src-tauri/src/orchestrator.rs - Innertube API → YouTube Music: calls API
- Innertube API → Search metadata: parses responses
crates/innertube/src/endpoints.rs - Innertube API → Browse models: parses browse
crates/innertube/src/endpoints.rs - App state → Native player: controls playback
- Native player → libmpv: plays audio
README.md - Tauri commands → Local music: handles local music
src-tauri/src/commands.rs - Local music → SQLite state: stores tracks
src-tauri/src/local.rs - Tauri commands → Radio: routes radio
src-tauri/src/commands.rs - Tauri commands → Lyrics: routes lyrics
src-tauri/src/commands.rs - App state → Listen Together: syncs playback
src-tauri/src/state.rs - Listen Together → Room relay: connects to
- App state → Last.fm: updates scrobbles
src-tauri/src/state.rs - App state → Discord presence: updates presence
src-tauri/src/state.rs - Ryoku / Hyprland → Host lifecycle: integrates with
README.md - Host lifecycle → WebView lifecycle: manages surfaces
src-tauri/src/lib.rs - Svelte UI → Search pages: opens search