Files
hyperframes/packages/studio
Vance Ingalls efe643c37e feat(studio,core,player): stream VST-processed audio in the studio player
Wires the browser half of the pipeline. The sidecar returns processed PCM over
one WebSocket, which a ring buffer feeds to an AudioWorklet so a track plays
its wet signal in preview.

The whole app shares exactly one sidecar connection, mounted once in
NLEProvider and handed to consumers through context. The wire protocol cannot
safely tell two independent connections apart, so a second connection is a
correctness problem, not just overhead.

Because the worklet now owns a VST track's audio, the element itself must stay
muted. Every place that writes .muted or .volume across media elements — the
runtime control bridge, the player's parent-media adoption, the timeline scrub
helper — skips elements marked data-vst-chain. Without that, an unrelated
volume or mute change silently swaps the processed stream back for the
untreated one.

STUDIO_VST_ENABLED gates the surface off by default from its first commit, so
no partially-wired FX UI is reachable while the stack lands.

The VstHostApi contract lives in propertyPanelVstShared (a plain module) rather
than in the panel component, so these hooks no longer import their own
interface back out of the UI layer.
2026-07-31 02:24:18 -07:00
..
2026-07-30 10:38:10 -07:00
…

@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 18/19, Zustand (state management)
  • CodeMirror 6 (editor)
  • Tailwind CSS (styling)
  • Vite (bundler)
  • Phosphor Icons

Documentation

Full documentation: hyperframes.heygen.com/packages/studio