# What to test on the gaming PC

Ordered by risk: the top block is code that has never run on real hardware,
the bottom is confirmation that nothing else broke. Everything below is
checkable in one session.

**Both builds are already made.** On this machine:

- `~/product/dist/clipshelf-0.1.0.zip` — install this one on the gaming PC
  (unzip, `run.bat`).
- `~/product/dist/releases/` — a 0.1.1 release for the update test, with its
  `latest.json`. Copy the folder across too, or serve it:
  `python3 -m http.server 8099 --directory ~/product/dist/releases` and point
  the app at `http://<this-machine-ip>:8099/latest.json`.

0.1.1 is the same code with the version bumped — it exists to exercise the
updater, not to change anything.

---

## 1. Fixed blind — never run in the app window

These were fixed against the browser, which behaves differently from the
WebView the app window uses. Highest chance of being wrong.

- [ ] **Download a clip from the app window.** clips page → click a clip →
      **download**. A native save dialog should open and the file should
      land where you pick it. (In a browser it should still just download.)
- [ ] **Download an editor render.** Export something → **download mp4**.
      Same dialog. This is the one you reported broken.
- [ ] **Download a gif.** Export → make gif → download.
- [ ] **Restart-and-apply an update.** Settings → Updates → paste the
      manifest path (or `http://<this-machine>:8099/latest.json` if serving
      over HTTP) → check now → download → **restart now**. The app should
      come back reporting 0.1.1, with your recordings, clips, settings and
      plugins intact, and a `data/updates/rollback-0.1.0/` folder present.
- [ ] While a render is running, the restart button should **refuse**
      rather than kill it.

## 2. Never confirmed on hardware

- [ ] **Close the window mid-session.** It should hide to the tray and keep
      ingesting — chapters and marks must still land. Quit is only from the
      tray menu.
- [ ] **Replay-buffer clipping under a live OBS.** Start the replay buffer,
      press the clip hotkey mid-game. The capture in the tray should say
      **"replay buffer"**, not "from the recording". (Both work; only one
      proves the OBS path, and I could not tell from your report which one
      you exercised.)
- [ ] **Editor export path end to end** — export, then save to My Edits, and
      confirm the file is where the editor says it is.

## 3. New since your last session

- [ ] **Ingest tray at volume.** Press the clip hotkey ~10 times in a
      session. Then: `j`/`k` to move, `enter` to open, `i`/`o` to set in and
      out, `enter` to keep, `d` to discard. It should walk to the next
      capture on its own.
- [ ] **Tray size limit.** Settings → Hotkeys shows what the tray is
      holding. Worth confirming the number looks right against the folder.
- [ ] **Bulk actions** — "keep all untrimmed" and "discard all".
- [ ] **Chapter art.** Timeline chapters should show game icons. First sight
      of a new game has no icon for ~2s, then it appears. Turn it off in
      Settings → Appearance and confirm markers stay text-only.
- [ ] **Context scrubber.** Click at the left edge of the 120s bar — the
      playhead must land where you clicked and **not** jump to the middle.
      This is the bug you reported.
- [ ] **Main timeline.** Chapter names, event pins and match spans on their
      own rows; clicking a chapter name seeks.
- [ ] **Settings sidebar.** Sections group under capture / sharing / extend
      / app. `/settings.html#hotkeys` should open Hotkeys directly.
- [ ] **Storage panel** (Settings → Storage). Numbers should look plausible
      against the folder sizes. "Free up space" should remove proxies and
      leave every clip alone.
- [ ] **Library snapshot** (Settings → Updates → back up now).
- [ ] **Editor exit** — the `← library` link, with unsaved changes pending.
- [ ] **TRMNL screen**, if you have it set up: it should now show the
      library, last night, newest clips and a transcript line, with the push
      time in the title bar.
- [ ] **First-run card** on the dashboard: record → chapter → clip → share.
      Steps should already be ticked from your real data, and "hide this"
      should make it stay hidden.
- [ ] **Editor empty states**: open the editor with an empty timeline — it
      should say what to drag and where from, not show a blank strip.
- [ ] **Library snapshot before an update.** After the update test above,
      `data/backups/` should contain a `library-…-preupdate.db`.
- [ ] **Storage sweep**: free up "playback proxies", then reopen a
      recording — scrubbing should rebuild them without complaint.

## 4. Worth a look if you have time

- [ ] **Build scrub assets while the background worker is already doing it**
      (open a fresh recording and press the button immediately). It used to
      encode the same file twice at once; now the second call waits.
- [ ] **Bulk keep** on a tray with ~10 captures — watch the disk figure in
      Settings → Hotkeys before and after.

## 5. Known-unknowns worth a glance

- [ ] Does the game detector pick up games it did not before? The database
      was rebuilt and now carries Steam ids for ~9,000 titles.
- [ ] Chapter names typed with spaces ("Just Chatting") should display with
      the space, not run together.

---

## If something is broken

`--console` on run.bat gives you a window; `app.log` next to run.bat has the
same output. Settings → Problems collects background failures, and
Settings → Problems → "copy diagnostics" produces a paste-able blob with no
paths or tokens in it.
