# chip-thumbnailer 0.2.0 — feature tour

**Target duration:** 1:15–1:30
**Recorded:** 2026-05-05
**Final output:** `~/project/recordings/chip-thumbnailer-0.2.0-tour.webm`
**Local review:** `/home/adom/project/.smoke/chip-thumbs/` (wiki upload deferred until auth migration completes)
**Wiki target:** `apps/chip-thumbnailer` (deferred)
**Hero frame:** `00:25` of scene 3 (chip-thumbnailer once output mid-render)

## Dependencies

- `chip-thumbnailer 0.2.0` — built at `/home/adom/project/chip-thumbnailer/target/release/chip-thumbnailer`
- `step2glb 0.6.2` — installed at `/usr/local/bin/step2glb`
- `service-step2glb 0.4.2` — reachable at the shared service URL
- `adom-tts` — for TTS via `say` subcommand (Andrew Multilingual Neural)
- `adom-cli hydrogen` — for recording + captions
- `video-post` — for manifest + storyboard review

## Recording config

- **Surface:** Hydrogen recording (workspace iframe via MediaRecorder)
- **Voice:** `en-US-AndrewMultilingualNeural`
- **Rate:** default
- **Workspace split:** 0.30 (VS Code / chat left, gallery webview right)
- **Captions:** on, via `adom-cli hydrogen caption show`

## Scenes

| # | id | Caption (on-screen) | Narration (phonetics applied per tts-pronunciation) | Target | Driver actions |
|---|---|---|---|---|---|
| 1 | intro | `chip-thumbnailer 0.2.0` | `Chip thumbnailer renders symbol, footprint, and three D thumbnails for every chip in your chip fetcher library.` | 8s | terminal: `chip-thumbnailer --version` then `chip-thumbnailer --help \| head -20` |
| 2 | before | `library/VL53L8CX/ — sources only` | `Here's a chip in the library. We've got the key cad symbol, the key cad footprint, and the step file. No thumbnails yet.` | 8s | terminal: `ls library/VL53L8CX/` showing only `.kicad_sym`, `.kicad_mod`, `.step`, `info.json` |
| 3 | render | `chip-thumbnailer once VL53L8CX` | `Run once. Kai cad C L I exports the symbol S V G, ported regex applies the Adom dark theme. Same for the footprint on the F P view grid. Step to G L B to P N G via O C C T offscreen — small, medium, and large.` | 18s | terminal: `chip-thumbnailer once VL53L8CX`; the OK lines stream in for sym, fp, 3d-sm, 3d, 3d-lg, manifest |
| 4 | output | `Six new files + manifest` | `Six new files landed next to the source. Symbol S V G, footprint S V G, three sizes of three D P N G — and a thumbs dot J S O N manifest.` | 8s | terminal: `ls -la library/VL53L8CX/` highlighting the new files |
| 5 | gallery | `Three chips · sm md lg per chip` | `All three example chips rendered. The vee ell five three L eight C X — a tof sensor. The D M G two three oh five — a P channel mosfet. And the A D S one three one M oh four — a twenty four bit A D C.` | 15s | activate gallery webview tab showing review.html; small auto-scroll |
| 6 | manifest | `<MPN>-thumbs.json — self-describing` | `Each chip gets a thumbs dot J S O N manifest. Canonical Adom palette, every file with dimensions and byte count, and a full fidelity block per kind pointing at the Adom app to launch — adom step for three D, sym view for symbols, F P view for footprints. Plus A I hints for downstream apps.` | 18s | gallery webview: click a `<details>` to expand the manifest, scroll the JSON briefly |
| 7 | handoff | `Click through → adom-step view` | `When the user wants more than the thumbnail, hand off to the full fidelity tool. adom step view opens the source step with measure, components browser, pin detection.` | 12s | terminal: `adom-step view library/VL53L8CX/VL53L8CX.step` — the adom-step Hydrogen tab opens with the chip loaded |

Total: ~87 s. Add ~3 s pad per scene for cuts → ~1:25 final after concat.

## Captions table

| Scene | Caption text shown via `adom-cli hydrogen caption show` |
|---|---|
| 1 | `chip-thumbnailer 0.2.0` |
| 2 | `library/VL53L8CX/ — sources only` |
| 3 | `chip-thumbnailer once VL53L8CX` |
| 4 | `Six new files + manifest` |
| 5 | `Three chips · sm md lg per chip` |
| 6 | `<MPN>-thumbs.json — self-describing` |
| 7 | `Click through → adom-step view` |

## Reproduction

```bash
cd /home/adom/project/chip-thumbnailer
node demo/gen_tts.py    # render each scene's narration via `adom-tts say`
python3 demo/record.py  # drive the per-scene Hydrogen recording loop
python3 demo/mux.py     # mux TTS + raw clips into <id>-narrated.webm + manifest add
video-post storyboard /tmp/chip-thumbnailer-manifest.json --tab-name "video-post: chip-thumbnailer review"
# review each clip with the user
ffmpeg -f concat -safe 0 -i /tmp/chip-thumbnailer-clips.txt -c copy \
  ~/project/recordings/chip-thumbnailer-0.2.0-tour.webm
ffmpeg -ss 00:00:25 -i ~/project/recordings/chip-thumbnailer-0.2.0-tour.webm \
  -frames:v 1 ~/project/.smoke/chip-thumbs/__hero.png
# Wiki upload deferred until auth migration completes:
# adom-wiki asset upload apps/chip-thumbnailer --asset-type video --file <final>.webm ...
```

## Pronunciation overrides used (cross-check tts-pronunciation/pronunciations.json)

| Term | Narration spelling |
|---|---|
| `chip-thumbnailer` | `chip thumbnailer` |
| `chip-fetcher` | `chip fetcher` |
| `KiCad` | `key cad` |
| `OCCT` | `O C C T` |
| `SVG` | `S V G` |
| `PNG` | `P N G` |
| `GLB` | `G L B` |
| `JSON` | `J S O N` |
| `ADC` | `A D C` |
| `MOSFET` | `mosfet` |
| `ToF` | `tof` |
| `VL53L8CX` | `vee ell five three L eight C X` |
| `DMG2305UX-7` | `D M G two three oh five` |
| `ADS131M04IPBSR` | `A D S one three one M oh four` |
| `FpView` | `F P view` |
| `SymView` | `sym view` |
| `adom-step` | `adom step` |
| `0.2.0` | `point two point oh` (or `zero point two point zero` if Andrew gets mid-sentence "point" wrong) |

## Workspace setup

- Hydrogen workspace with two-pane split, ratio 0.30
- **Left pane** (30%): VS Code terminal pinned to `/home/adom/project/chip-thumbnailer/`
- **Right pane** (70%): Hydrogen webview tab pointed at `https://gallery-igqvywx7jb2z.adom.cloud/review.html`
- Pre-warm the gallery once before recording so the SVGs are loaded
- Pre-clear `~/project/recordings/` so we don't conflate with old takes

## Known issues / risks

- Wiki publish step deferred — Drew/Colby auth migration in progress. Demo lands locally; upload command is in the reproduction block ready to run when auth restores.
- Scene 3 is ~18 s wall-clock but `chip-thumbnailer once` for VL53L8CX takes ~10 s (3D rendering across three sizes is the long pole). If the natural flow is shorter, hold the last frame with `tpad` per the skill's mux pattern.
- Scene 7's `adom-step view` will pop a Hydrogen webview tab — that's expected; we let it land for a moment then stop the recording.