Skip to content

Add video format guidance to README - #4

Merged
bseverns merged 1 commit into
mainfrom
codex/update-readme-with-video-guidelines
Dec 25, 2025
Merged

bseverns merged 1 commit into
mainfrom
codex/update-readme-with-video-guidelines

Conversation

@bseverns

Copy link
Copy Markdown
Owner

Motivation

  • Provide clear, practical guidance for the video file used by the sketches because Processing’s Movie can choke on some codecs and cause confusing behavior.
  • Reduce runtime stutter and dropped frames by recommending sensible defaults for codec, resolution, and file size.
  • Make it easier for users to get the example sketches running smoothly without deep troubleshooting.

Description

  • Updated README.md in the "Put a video in the data folder" section to add a short, punky quick-spec list.
  • Added recommendations for preferred codec (H.264), default resolution (720p with 1080p as optional if your machine is beefy), and to keep file sizes reasonable.
  • Called out that Processing’s Movie can choke on some codecs and that dropping resolution is the easiest win when the effect-heavy draw() loop starts to sweat.

Testing

  • No automated tests were run because this is a documentation-only change.

Codex Task

@bseverns
bseverns merged commit 370cfee into main Dec 25, 2025
2 checks passed
@bseverns
bseverns deleted the codex/update-readme-with-video-guidelines branch December 25, 2025 20:25
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant