Marekpalka at 06:08, 5 June 2026

2026-06-05T06:08:50Z

Marekpalka: Created page with "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 p..."

2026-06-05T06:05:10Z

Created page with "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 p..."

New page

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.

← Older revision		Revision as of 08:08, 5 June 2026
Line 5:		Line 5:
	== Requirements ==		== Requirements ==

	• All devices must be on the same local network (or close enough for peer-to-peer Wi-Fi).		* 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'''.		* 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.		* Each device must set a '''Nickname''' so others can identify it.

	== Opening PlayTogether ==		== Opening PlayTogether ==
Line 25:		Line 25:
	While the session is running:		While the session is running:

	• Edits to the source setlist (reorder, add or remove songs, change arrangements) are auto-synced to followers.		* 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.		* 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 the red '''✕''' next to a follower to kick them out — they will not auto-reconnect.
	• Tap '''Stop session''' to end broadcasting for everyone.		* Tap '''Stop session''' to end broadcasting for everyone.

	== Joining a Session (Follower) ==		== Joining a Session (Follower) ==
Line 39:		Line 39:
	While connected:		While connected:

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

	== Reconnection & Heartbeats ==		== Reconnection & Heartbeats ==

	• Both sides exchange pings every 5 seconds.		* 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.		* '''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.		* '''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.		* 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.		* If the leader explicitly kicks you, you are disconnected with a toast and will not auto-reconnect.

	== Nickname ==		== Nickname ==
Line 58:		Line 58:
	Set or change your nickname at the bottom of the PlayTogether panel. Your nickname is shown:		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 other devices when you advertise a session (as the leader name).
	• To the leader in the followers list.		* To the leader in the followers list.

	== Tips ==		== 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.		* 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.		* 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.		* The leader is the source of truth for the setlist — followers cannot edit songs, but they can adjust personal display settings and capo locally.

PlayTogether - Revision history

Marekpalka at 06:08, 5 June 2026