Stereo

Stream music from your Navidrome or Subsonic-compatible server inside Obsidian. Stereo is a full music player in the sidebar: browse your library, queue albums, run stations, read synced lyrics, and keep the music going while you work in your notes.

Features

Player

• Now Playing view with selectable art treatments: album art, spinning record, or audio-reactive visualizers.
• Full transport (seek, previous/next, volume) with a compact mini player that takes over when you navigate elsewhere.
• Lyrics with follow-along highlighting for synced lyrics — click a line to seek. Plain lyrics scroll normally.
• Scrobbles plays back to your server so play counts stay accurate.

Library

• Browse albums, artists, playlists, and internet radio, with drill-in navigation (artist → album → track) and an A–Z scrubber for long lists.
• Right-click context menus everywhere: play, play next, add to queue, go to artist/album, favorite, start station.
• Favorites synced with your server — heart tracks, albums, and artists from the player, menus, or detail pages, and browse them all on a Favorites page.
• Manage internet radio stations from the player: add, edit, and remove (requires an admin account on the server).

Queue & stations

• Full-page queue with playback modes, save-as-playlist, and persistence across Obsidian restarts.
• Stations: seed from any song, album, or artist to build a batch of similar tracks, then extend it or save it as a playlist.

Search

• As-you-type fuzzy search across artists, albums, and tracks.

Setup

1. Install and enable the plugin.
2. Open Settings → Stereo and enter your server URL, username, and password.
3. Use Test connection to confirm the server is reachable, then open the player from the ribbon icon or the Open player command.

Settings also cover track click behavior, Now Playing view, lyrics font, and search tuning.

Requirements

• Obsidian desktop (this plugin is desktop-only).
• A server that speaks the Subsonic API — Navidrome, Airsonic-Advanced, Gonic, and others.

Data and network transparency

• Music playback, browsing, favorites, scrobbling, and station building talk only to the server URL you configure. Nothing is sent anywhere until you configure a server.
• Lyrics are fetched from your server first; if your server has none for the current track, Stereo queries LRCLIB (a free, public lyrics database) with the track's title, artist, album, and duration. No account data is sent.
• Your server URL, username, and password are stored in plain text in .obsidian/plugins/stereo/data.json inside your vault. If you sync or share your vault, that file goes with it. Consider a dedicated, limited account on your music server.
• No telemetry, no analytics.

Development

npm install
npm run dev    # watch build
npm run build  # type-check + production build

Support

If you enjoy Stereo, you can buy me a coffee.

License

GPL-3.0