---
name: resonance-reveal
description: Author an editable sound comparison film with a silent object, synchronized effects, and a musical replay.
version: 1.0.3
---

# Resonance Reveal

A parameterized HTML/SVG, GSAP and HyperFrames film generator. It provides bell and drum geometry and original procedural audio. New object types need additional authoring; arbitrary footage is not supported.

Provide a JSON brief with label, object, absence, diagnosis, invitation, effectsRequest, musicRequest, conclusion, signature, locale, instrument (bell or drum), pitch (80–1600 Hz), and four palette colors (background, ink, accent, editor). Text fields must contain 1–76 characters. Use truthful sample copy; the editor demonstrates an authored workflow, not a connected service.

## Execute

Node 22+, Python 3 and FFmpeg are required. Run `npm ci`, then `node build.mjs /path/brief.json /path/project`, and `python3 score.py /path/project`. Run `npx hyperframes lint /path/project`, `npx hyperframes check /path/project`, and `npx hyperframes render /path/project --fps 30 --quality high --workers 1 --output /path/project/film.mp4`.

## Direct the comparison

Define one obvious sound-producing action. A single absolute-time shot function is revisited without restaging. The initial eight seconds have no scheduled audible content. The first editor sound starts at 8.7 seconds; object impacts start at 13 seconds; music begins at 22 seconds. For retiming, edit the schedule in build.mjs, the absolute-time mapping in motion.js and event placement in score.py together, then regenerate. timeline.json records the generated schedule; changing that JSON alone does not retime the film. The final output is 1920×1080, 32 seconds, with three audio stems mixed by HyperFrames.

Use player controls with a clear sound-on invitation; silent autoplay cannot communicate this comparison. Check the encoded opening interval, first contact synchronization, identical replay frames, backwards seeking, first frame, fonts and full decoding. Measure real playback frame counters and retain results. A file with an audio stream does not prove good listening quality. Human listening and final acceptance are separate checks.

## Rights

The oscillator sounds and musical phrase are original and dedicated under CC0. No audio service or paid generation is called. Review third-party terms in THIRD-PARTY.md and retain dependency notices with generated projects. No example media is included.