Editing the motion library

Open the website

Double-click Open Motion Library.command in this folder. It starts a server on your Mac and opens the gallery at http://localhost:8864/watch.html. Leave its Terminal window open while editing or exporting. To watch without editing, you can also open watch.html directly.

The four things you can change

• Copy: open Edit content, choose a scene, and replace the existing words. Keep the replacement close to the original length. Existing line positions, sizes, text boxes and timing stay fixed. Long replacements may look compressed; shorten the copy rather than changing the layout.
• Colors: expand Colors. Red accent, red highlight, deep red, white ground, background tone and dark ink apply across the collection. The seven deep-red scenes remain deep-red scenes; the other twenty backgrounds remain white by default. No control changes the lighting geometry, scene composition or animation.
• Fonts: expand Fonts and choose a local file for an existing typeface slot. You can upload a TTF, OTF, WOFF or WOFF2 file. Sizes, weights, line positions and animation remain fixed. Use a compatible font, and check the preview after saving. The italic serif slot is intended for an italic face.
• Images: expand Images and upload a replacement for an existing photo, illustration or software capture. The image fills the same crop and follows the same motion. Crop and position controls are intentionally absent. Prepare an image with its important subject near the center. Original image restores that slot.

Click Save & preview after changes. Scrub the preview or press Replay to inspect it. Saving updates the HTML; it does not rewrite an MP4 yet.

Export changed videos

Click Export updated videos. This saves your settings, renders changed clips frame by frame, then rebuilds all three catalogue versions. Unchanged clips are cached. Keep the local server running until the status says Export complete. You can also double-click Export Videos.command.

The outputs are:

• videos/clips/: 27 individual, silent, three-second MP4s.
• videos/red-27-master.mp4: 81-second catalogue with the existing music and soft transitions.
• videos/red-27-music-only.mp4: the same picture and music, without transition effects.
• videos/red-27-silent.mp4: picture only.
• posters/: the approved-pose PNG for every scene and a contact sheet.

Every exported video is 1920 × 1080 at 60 fps. Scene length, order and animation stay fixed. This delivery preserves Kimi's landscape layouts; it does not stretch them into a vertical canvas.

What stays locked

There are no controls for layout, object position, scale, line spacing, scene order, duration, transitions, easing, motion paths or sound. The build checks scene geometry against the preserved templates and checks the original animation file's hash. A changed template or animation file stops the build. Use the editor rather than editing HTML or JavaScript.

The large traced display numerals and text already baked into software screenshots are artwork, not live font text. Font and copy controls affect live text nodes. Replace an entire software image to change its baked text. Display numeral outlines remain fixed in this edition.

Files and recovery

• settings.json stores only colors, fonts, copy and image choices.
• uploads/ holds your uploaded images. Do not remove an image currently in use.
• reviews/settings-history/ keeps the settings from before each editor save. To undo a save, stop the server, copy the desired history file over settings.json, restart the server and export.
• locked/ preserves the approved templates, original assets and default settings. Do not edit it.
• assets/motion.js is the approved animation source. Do not edit it.
• reviews/export-report.json records output sizes, frame counts, duration and measured loudness.

Your previous workspace project remains untouched. This Desktop folder is a separate working copy.

If opening or exporting fails

This Mac already has the needed runtime. On another Mac, install Python 3 with numpy and Pillow, Node.js 22 or newer, and FFmpeg. The export uses the pinned HyperFrames CLI 0.8.217. It uses the existing local installation when available, otherwise npx fetches that pinned version. No generation API or API key is needed.

The browser editor runs locally; a static web host can show the gallery, but cannot render new videos or write local files. Run the local launcher for editing. Inspect reviews/export-progress.log if an export fails.

Before publishing new copy, replace reference-study names and results with your own approved facts. Watch the final export and listen on your target device. Keep music and sound-source files internal; publish rendered videos rather than standalone library audio.

Publish updates with Wrangler

After exporting, run python3 scripts/build-public.py, then wrangler pages deploy dist --project-name 783104926550381274 --branch main. The public gallery is at https://783104926550381274.pages.dev. Publishing contains videos, posters and the guide. File editing and frame-by-frame rendering remain in the local Desktop copy. Source audio, uploads, settings history and template files are excluded from the public package.