PlayTogether

PlayTogether synchronizes a setlist across multiple JustChords devices in real time. One device acts as the Leader and broadcasts the chosen setlist plus playback commands (song changes, section selection, scrolling, etc.) to one or more Followers on the same local network. It works between iPhone, iPad and Mac Catalyst over Wi-Fi or peer-to-peer.

Requirements

All devices must be on the same local network (or close enough for peer-to-peer Wi-Fi).
JustChords needs Local Network permission. If denied, enable it in Settings → Privacy & Security → Local Network → JustChords.
Each device must set a Nickname so others can identify it.

Opening PlayTogether

Tap the PlayTogether button (antenna icon) in the Library — typically found under Tools or, when a session is active, in the PlayTogether section at the top of the Library.

If no nickname is set yet, JustChords prompts for one before opening the panel.

Starting a Session (Leader)

Open PlayTogether. Tap New Session under Create Session. Pick the setlist you want to broadcast (use the search bar to filter). JustChords starts advertising the session on the local network using the setlist title and your nickname. Followers will appear under Followers (n) as they connect.

While the session is running:

Edits to the source setlist (reorder, add or remove songs, change arrangements) are auto-synced to followers.
Every navigation action (open song, change section, etc.) is broadcast to followers.
Tap the red ✕ next to a follower to kick them out — they will not auto-reconnect.
Tap Stop session to end broadcasting for everyone.

Joining a Session (Follower)

Open PlayTogether. Discovered sessions appear under Available Sessions, each showing the setlist title and the leader's nickname. Tap a session to join. If nothing appears, tap Scan Again. Once connected, the setlist appears in your Library under the PlayTogether section.

While connected:

Your view follows the leader automatically — opening songs, switching sections, etc.
You can set your own capo per song; the follower-side capo persists across setlist updates from the leader.
A status dot shows:
- Green — Leader online
- Orange — Leader away or Reconnecting…
Tap Disconnect to leave the session.

Reconnection & Heartbeats

Both sides exchange pings every 5 seconds.
Follower: if no message arrives from the leader for ~12 seconds, the leader is marked away and JustChords starts scanning for the same leader to reconnect automatically.
Leader: if a follower goes silent for ~60 seconds it is dropped.
When the app returns from background, the leader rebuilds its Bonjour advertisement and followers send a ping to verify the connection.
If the leader explicitly kicks you, you are disconnected with a toast and will not auto-reconnect.

Nickname

Set or change your nickname at the bottom of the PlayTogether panel. Your nickname is shown:

To other devices when you advertise a session (as the leader name).
To the leader in the followers list.

Tips

Keep both devices on the same Wi-Fi network for the most reliable discovery; peer-to-peer also works when Wi-Fi is unavailable but range is limited.
If devices can't see each other, verify Local Network permission and that both devices have a non-empty nickname.
The leader is the source of truth for the setlist — followers cannot edit songs, but they can adjust personal display settings and capo locally.