← ClaudeAtlas

seenbylisted

Read a screen recording (video file) the user shares or points at: bug report, demo, test run, client video, screencast, .mp4/.mov/.webm/.mkv. Runs seenby.py to turn it into contact sheets and frames.json, then reads them. Use whenever a task involves understanding what happens in a screen recording.
Sundwell/seenby · ★ 0 · Data & Documents · score 70
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