Session logs

When a session misbehaves (a song that doesn’t arrive, edits that don’t reach someone, play heard late), a session log says what each device saw and decided. It’s off unless you turn it on, it stays on your device, and it goes to nobody unless you send the file yourself.

Session logs

Available on Mac and Windows. Not on Web.

This isn’t on Web.

The web app keeps no files, so it keeps no session logs. If a session goes wrong, a log from the host’s device or another guest’s still helps: turn it on there.

Turning it on

Open Settings, choose Play Together, and turn on Keep a session log.Choose Together › Keep a Session Log.

From then on, every session you host or join on this device writes a log of its own, until you turn it off. While one is being kept, Session Options… in the session chip’s menu says Keeping a session log on this device.While one is being kept, the Together menu says Keeping a session log on this device.

What a log holds

A log is a text file, one line for each thing the session compared or decided: who joined, the song sent and received, each edit applied or refused and why, the regular checks that everyone has the same song, play started and when each device heard it, recordings offered and received, connections opened and lost. A first line says which app and system wrote it, the device’s model and the first few characters of the session’s room.

It holds no names, no session code and no song: it’s written to be sent.

Finding and sending logs

In Settings › Play Together, Show Logs in Finder opens the folder, with the newest log selected. The logs are in your Library’s Application Support › Stab › Session Logs, named by date, role (host or guest) and room.Choose Show Session Logs (not on Mac)Show Session LogsShow Session Logs (not on Web) in the Together menu: the folder opens in File Explorer. The logs are in %LOCALAPPDATA%\Stab\Session Logs, one file per session.

When you report a problem with a session, send the log from the session in question, and if you can, the logs from the other devices that were in it: together they show where things parted. Write to [email protected].

Deleting logs

Delete Session Logs…, beside the button above, deletes every log on this device, once you confirm; the log of a session going on now is kept. Turning the switch off stops new ones but keeps those already written.

Deleting logs

Logs stay until you delete them: choose Delete Session Logs…Delete Session Logs… (not on Web) in the Together menu and confirm. The log of a session going on now is kept. Turning Keep a Session Log off stops new ones but keeps those already written.

See also Can’t join or host a session.

Command	Keys	Where
Keep a Session Log		Settings
Delete Session Logs…		Settings

Not on Mac: Show Session Logs.

Command	Keys	Where
Keep a Session Log		the Together menu
Show Session Logs		the Together menu
Delete Session Logs…		the Together menu

Not on Web: Keep a Session Log, Show Session Logs, Delete Session Logs….