How nikhilcherry/kinetix works
Kinetix turns a reel author’s beat-synchronized HTML scenes and soundtrack into a checked, rendered video. The documented path runs from scene and audio authoring through the seek-time runtime, HyperFrames bridge and render, with captions, effects and poster generation as supporting branches. Several CLI orchestration details and the poster implementation were not sampled, so those relationships rely on README documentation rather than inspected source.
Main entry points: index.html Reel scenes · hits.py Beat-grid mixer · kinetix.js Timeline runtime · hf-bridge.js HyperFrames bridge
Components 20
Reel Authoring
- Starter page
template/index.html - Reel scenes
template/index.html
Soundtrack and Voice
- MusicGen beds
music/hypebeat.py - Synth soundtrack
template/music.py - Beat-grid mixer
music/hits.py - Audio bed
- Mixed soundtrack
- Sarvam TTS
- Voice clips
Scene and Render
- Timeline runtime
runtime/kinetix.js - HyperFrames bridge
bridge/hf-bridge.js - HyperFrames check/render
- Rendered MP4
Captions and Effects
- Word-timed captions
captions/captions.py - Caption data
- Remotion effects
fx/src/Root.tsx - Overlay compositing
tools/overlay.sh - Poster frame
tools/poster.sh
AI Authoring
- Claude skill
skill/kinetix/SKILL.md
Other components
- Reel author
Connections 20
- Reel author → Starter page: creates with
README.md - Reel author → Reel scenes: writes scenes
README.md - Reel author → Claude skill: can invoke
README.md - Claude skill → Reel scenes: plans and writes
README.md - MusicGen beds → Audio bed: generates
README.md - Synth soundtrack → Beat-grid mixer: uses
template/music.py - Audio bed → Beat-grid mixer: loads
README.md - Beat-grid mixer → Mixed soundtrack: writes
README.md - Sarvam TTS → Voice clips: generates
- Voice clips → Word-timed captions: provides clips
captions/captions.py - Word-timed captions → Caption data: writes timings
captions/captions.py - Caption data → Timeline runtime: renders pages
runtime/kinetix.js - Reel scenes → Timeline runtime: defines scenes
README.md - Timeline runtime → HyperFrames bridge: registers timeline
runtime/kinetix.js - HyperFrames bridge → HyperFrames check/render: enables check/render
README.md - HyperFrames check/render → Rendered MP4: renders
README.md - Remotion effects → Overlay compositing: renders effects for
README.md - Overlay compositing → Rendered MP4: composites onto
README.md - HyperFrames check/render → Poster frame: feeds frame selection
README.md - Mixed soundtrack → HyperFrames check/render: provides soundtrack
README.md