seenbylisted
Install: claude install-skill Sundwell/seenby
# seenby: read a screen recording
You cannot watch video. seenby turns a screen recording into a few contact sheets (one image each, readable in
one look) and `frames.json` with the time and reason of every kept frame. Read those instead.
## Run it
```
python3 <skill-dir>/seenby.py <recording> <out-dir>
```
`<skill-dir>` is the folder this SKILL.md is in; `seenby.py` and `seenby_report.py` sit next to it. Use `python` where `python3` is not found (Windows). Needs Python 3.8 or newer and `ffmpeg` and `ffprobe` on PATH, no Python packages. If it exits 1 because ffmpeg is missing, tell the user to install it (`brew install ffmpeg`, `sudo apt install ffmpeg`, `winget install ffmpeg`) and stop; do not fall back to guessing from the file name.
Always start with no options. The console tells you what happened:
```
demo.mp4: 27.1 s, 814x872, portrait
54 thumbnails, selected 19/24 (threshold 12.0 -> 12.0, max gap 3.0 -> 3.0 s)
frames: 0.0 first, 3.0 timer, 3.5 block, 6.5 timer, ..., 25.5 timer, 26.5 last
quiet stretches at a lower threshold: 12.0-26.5 s at 3.4 (largest change 10.3)
layout: window, tile 516 px, 3x2 per sheet
contact sheets: out/sheet-01.jpg, out/sheet-02.jpg, out/sheet-03.jpg, out/sheet-04.jpg
manifest: out/frames.json. Sheets are for meaning; read digits from the native frame, see "recheck" in the manifest.
```
Exit code 0 means done; 1 means it could not run and stderr has one line saying why (no ffmpeg, no such file,
not a video, an output directo