// readme

If you’re too lazy to read all this,
just skip straight to Setup or

Highlights

  • Rich Discovery & Search: Search tracks via Spotify metadata (clean titles, HQ covers, albums) or directly query YouTube.
  • Native YouTube Audio Engine: Fast, deciphered stream resolving powered natively by innertube-rs.
  • Spotify Direct Playback (Opt-In): Direct 320kbps Vorbis audio streaming for Spotify Premium users via native spotstream daemon & RFC 8628 device pairing.
  • Instant Audio Pre-buffering: 0ms gapless transition between queued songs via background pre-buffering pool.
  • Smart Recommendations & Autoqueue: Continuous dynamic queueing powered by YouTube watch-next graphs, Spotify track radio, Last.fm similarity, or local Markov chain transitions.
  • Synced Lyrics & Romaji: Real-time synchronized lyrics via LRCLIB with Japanese Romaji conversion.
  • Adaptive Circular Visualizer: 6 audio reactive visualizer presets rendering directly around the album disk.
  • Local Playlists & Library: Full playlist management, liked songs, cover upload/crop, drag-and-drop reordering, and audio tag…