docs/listen-together.md
Listen together
One person hosts, others on the same Navidrome server follow. Open the menu under your name → listen together.
- Start a session and share the link (
/listen/<code>). Anyone who signs in to this server with their own account can open it and hears what you play, in sync: same song, same play state, and the playhead is corrected when it drifts more than 0.25 s. - Everyone can add songs: a listener searches the library and adds a song; it lands on the host's queue and shows in the activity list with their name.
- The host controls playback. Turn on anyone can skip to let listeners skip too.
- Each listener plays through their own account, so their plays are scrobbled and their stars stay theirs.
- A reload rejoins the session. If the host stays away for a minute, the session ends.
How it works
The host's browser sends its state (song, position, playing) over a WebSocket (/api/listen/<code>) when the song or play state changes and every 5 s. The server stamps each state with its own clock; a listener places the playhead from that stamp and its measured clock offset, so two machines' clocks never have to agree. Sessions live in the server's memory: a restart ends them.
Not built yet
"Listening on this device only" (a party mode where one machine plays and the others are remotes) is not in this version.