Skip to content

De-Stu the docs: generic paths + sixty-second quickstart#31

Merged
StuMason merged 4 commits into
mainfrom
polish/stranger-quickstart
Jul 7, 2026
Merged

De-Stu the docs: generic paths + sixty-second quickstart#31
StuMason merged 4 commits into
mainfrom
polish/stranger-quickstart

Conversation

@StuMason

@StuMason StuMason commented Jul 7, 2026

Copy link
Copy Markdown
Owner

Prep for putting the engine in front of strangers:

  • obs-setup.md: the recording path was hardcoded to ~/Code/tools/edator/recordings in three places. Now generic.
  • README: new Sixty-second quickstart — one existing mp4, no plugin, no OBS: transcribe → minimal hand-written pack → validate → render. The example pack passes validate.js (semantic).
  • README Requirements: documents the optional Python/OpenCV dep for face-tracked features (was only discoverable via the private studio's doctor script).

Deliberately untouched: roll-prep.mjs studio-shaped defaults (--out workspace/recordings) — they're overridable by flag and the private studio's vendored copy relies on them.

🤖 Generated with Claude Code

StuMason and others added 2 commits July 7, 2026 12:09
obs-setup.md pointed three times at ~/Code/tools/edator/recordings, which
only exists on one machine in the world. Any folder works; say so.

README gains a quickstart for the person who already has an mp4 and no
OBS/roll setup: transcribe, hand-write the smallest valid pack, validate,
render. The example pack is semantically validated against validate.js.
Also documents the optional Python/OpenCV requirement for face-tracked
features, which previously only lived in the studio's doctor script.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Two unrelated breakages that have kept main red since #28:

1. loadPack re-opened /dev/stdin by path, which now fails with ENXIO
   when the pipe's write end has already closed (spawnSync with input:
   on current runners). Read fd 0 directly for '-' or '/dev/stdin'.

2. The engine syncs (#28-#30) improved the motionBlur/push graph -
   real fps oversampling before zoompan instead of zoompan frame
   duplication (tmix over duplicated frames produced no blur), and
   dropped a redundant double fps=30 - but the golden snapshots were
   never regenerated. Regenerated with GOLDEN=1; only look-blur and
   moves drift, exactly matching the shipped engine behaviour.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
StuMason and others added 2 commits July 7, 2026 16:34
test-matrix.mjs (added in the #29/#30 engine syncs) renders real synthetic
footage; the dry-run-only suite stays dependency-free.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@StuMason
StuMason merged commit c96b6f4 into main Jul 7, 2026
1 check passed
@StuMason
StuMason deleted the polish/stranger-quickstart branch July 7, 2026 16:37
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant