mirror of
https://github.com/heygen-com/hyperframes.git
synced 2026-10-30 09:16:55 +00:00
Miguel Ángel
84b6319346
* perf(studio): music beat analysis no longer freezes the page or runs during playback * fix(core): media-treatment --analyze finishes on long HDR clips Grade analysis decoded the clip from the start and kept every frame until the fps filter had emitted five samples. Past 50 s the filter rate floors at 0.1 fps, so it always decoded the first 40 s at full rate and resolution: a 3-minute 4K60 10-bit HLG clip timed out at 15 s, and every long clip was graded from its first 40 s only. Each sample now seeks to the middle of one fifth of the clip and decodes one frame. The timeout applies per sample and its error names the sample time and HYPERFRAMES_ANALYZE_TIMEOUT_MS. * refactor(core): name the keyframe seek instead of commenting it * fix(core): count one frame per grade sample on ffmpeg 8
@hyperframes/studio
Browser-based composition editor UI for Hyperframes. Provides a visual timeline, code editor, and live preview for building video compositions.
Install
npm install @hyperframes/studio
What it does
The studio is a React application with:
- Visual timeline — drag, resize, and arrange elements on tracks
- Code editor — edit HTML and GSAP scripts with CodeMirror (syntax highlighting, autocomplete)
- Live preview — see changes in real time as you edit
- Composition inspector — view and modify element properties
Development
The studio is embedded in the hyperframes preview command. To develop the studio UI itself:
cd packages/studio
bun run dev # Start Vite dev server
bun run build # Build for production
bun run typecheck # Type-check
Tech stack
- React 19, Zustand 4/5 (state management; development uses Zustand 5)
- CodeMirror 6 (editor)
- Tailwind CSS (styling)
- Vite (bundler)
- Phosphor Icons
Documentation
Full documentation: hyperframes.heygen.com/packages/studio
Related packages
@hyperframes/core— types and parsers used by the editorhyperframes— CLI that serves the studio viahyperframes preview