Troubleshooting

Work from the host outward. Do not wipe data or change the show project until simpler checks identify the failing layer.

Integration does not load

1. Confirm the installed package matches the operating system and architecture in its release manifest.
2. Confirm the DAW version is listed as supported.
3. REAPER: inspect plugin loading and console output.
4. Ableton: confirm Prest appears and is selected as a Control Surface.

Because no public compatibility manifest exists yet, unresolved installation failures are a release blocker rather than a user-configurable fix.

Cannot connect

1. Confirm the host integration reports that the runtime is ready.
2. Confirm both devices use the same band-owned network.
3. Enter the exact reported address.
4. If prest.local fails, try the reported IP address.
5. Check router client isolation and the host firewall.
6. Avoid public, venue, and guest Wi-Fi.

Wrong or missing songs

1. Open Setup → Data.
2. Confirm the project source status is ready.
3. Confirm the chosen mode matches the project organization.
4. REAPER: distinguish a folder of projects from one marker-based project.
5. Ableton: confirm locators exist in the one active Live Set.

Lyrics or chords are absent

1. Confirm the selected song is the prepared host section.
2. Confirm timed entries exist in the source project.
3. Ableton: verify exact track names Lyrics and Chordtrack, and verify text is in clip names.
4. Confirm transport position is inside the prepared entry range.

Transport does not match

1. Stop playback safely in the DAW.
2. Reload the browser and confirm the runtime reconnects.
3. Reproduce play, pause, and stop with a rehearsal project.
4. Record the host state, browser state, selected song, and action that diverged.

Backup import fails

1. Confirm the file has the .rpbak extension and came from Prest.
2. Keep the original file unchanged.
3. Retry in the same product version that created it when possible.
4. Do not wipe current data while import is unresolved.

Browser state looks stale

Reload first. Clearing browser site data removes local preferences, selection, onboarding, and project configuration; export catalog data and note the current setup before clearing anything.

Gather useful diagnostics

Record the Prest release, operating system, DAW and version, browser and version, integration, project mode, exact local address form, visible connection status, reproduction steps, and relevant host logs. A verified support destination is still awaiting owner publication.