# Listen together (/docs/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.

## Party mode

Turn on **party mode** (before starting, or any time as the host) and only the host's device plays: one speaker for
the room. Listeners see the same song and progress but play nothing; their player bar is a remote. Picking a song adds
it to the host's queue, and with *anyone can skip* on, their play/pause and next buttons control the host.
