Remotion To Hyperframes: Install, Source and Security

Remotion To Hyperframes

Published by heygen-com in hyperframes

Review recommended659k installsFront-end Development

What this skill does

Ports an existing Remotion composition into HyperFrames HTML and GSAP after checking which patterns can be translated. It renders and compares the result, then records any gaps or unsupported patterns. Best for Developers migrating deterministic Remotion video compositions to HyperFrames.

Add Remotion To Hyperframes to your agent

Review the source and files first. When you are ready, copy the prompt instruction or use the CLI command supported by your environment.

Install with a prompt

Paste this into a compatible coding agent:

add this skill "remotion-to-hyperframes" from https://github.com/heygen-com/hyperframes

Install with the CLI

Run this command in a controlled environment after reviewing the repository:

npx skills add https://github.com/heygen-com/hyperframes --skill remotion-to-hyperframes

Skill instructions

Running the CLI: every npx hyperframes <command> here, the beacon included, means node <SKILLS>/hyperframes/scripts/plugin-cli.mjs <command> run in the project, where <SKILLS> holds this skill's folder (rules).

Usage beacon: run npx hyperframes events --skill=remotion-to-hyperframes once as this skill starts. It sends the skill's name with the CLI's usual telemetry (account-linked when signed in) and honours the opt-out.

Import into HyperFrames

HyperFrames is the container: its tracks, sub-compositions and variables are editable in Studio whatever runs inside a clip. Bring each part in at the highest level it supports and record which level you used.

LevelForHowEditable in Studio afterwards
Nativecode that can become HTML + GSAP: most Remotion, HTML/CSS/GSAP animation, simple Motion Canvastranslate it, then verify frame by frameevery element; variables, catalog, presets apply
Hostedcode that can draw any requested frame in a browser: canvas, p5.js, Three.js, Lottie, WebGL, other JS animationkeep the code and drive it from HyperFrames timetiming, position, exposed parameters
Mediaanything that outputs video or frames: Manim, After Effects, Blender, PIL, moviepyrender to a file and use it as a clipcut, place, layer; not the pixels inside

Code that depends on wall-clock time, live physics or the network can only come in as media.

Native: translate, then verify

  1. For Remotion, run python3 <SKILL_DIR>/scripts/lint_source.py <source dir> first. Blockers (useState, useReducer, useEffect with dependencies, async calculateMetadata, React UI kits such as MUI, Chakra, Mantine, antd, shadcn, Radix, NextUI) don't translate: host them or refactor them out, never approximate (references/escape-hatch.md). Warnings (@remotion/lambda config, delayRender, useMemo, custom hooks) are dropped and noted.
  2. Translate to the /hyperframes contract: one sub-composition per scene, times in seconds (frame / fps), asset paths root-relative. Each Remotion API's equivalent is in references/api-map.md. Put Remotion's render-page rule * { box-sizing: border-box; } once in the root index.html <style>: without it every bordered or padded element grows by its border and padding.
  3. Keep it editable: the source's props become data-composition-variables bound with data-var-text, data-var-src or var(--id); each Sequence becomes a timed clip or a sub-composition; a reused component becomes one sub-composition mounted several times with data-variable-values.
  4. Compare frame by frame: npx hyperframes diff <original.mp4> . --at <t,…> scores your project against the original at those times without rendering; sample every scene and both sides of every cut. Then render and npx hyperframes diff <original.mp4> <hf.mp4> scores every frame: SSIM, the worst cell of each frame (one late or recoloured element), cuts, and a sheet of the worst moments (thresholds per complexity tier in references/eval.md). Render the Remotion side with Config.setVideoImageFormat("png") and Config.setColorSpace("bt709"), or the diff measures the encoders (about 0.05 SSIM).
  5. Write what didn't translate cleanly (dropped volume ramps, approximated presentations, substituted fonts) to TRANSLATION_NOTES.md.
RemotionRead
Composition, defaultProps, schema, calculateMetadatareferences/parameters.md
Sequence, Series, Loop, AbsoluteFill, Freezereferences/sequencing.md
useCurrentFrame, interpolate, spring, Easing, interpolateColorsreferences/timing.md
Audio, Video, Img, IFrame, staticFile, delayRenderreferences/media.md
TransitionSeries, @remotion/transitionsreferences/transitions.md
@remotion/lottiereferences/lottie.md
@remotion/google-fonts, Font.loadFont, @font-facereferences/fonts.md
What can't be portedreferences/limitations.md

Before hand-building a named visual the source used, search npx hyperframes catalog --query "<the visual, in English>" --json: it ranks the whole registry with nothing installed.

Hosted

Keep the code and let HyperFrames own the clock: it draws the frame for the time it is given. The seek protocol and the built-in adapters for Lottie, Three.js, anime.js, WAAPI and CSS animations are in ../hyperframes/references/runtimes.md. No requestAnimationFrame loop or timer as the time source, seeded randomness only, and data-duration on the root when nothing else defines the length.

Media

<video class="clip" data-has-audio="true" src="assets/x.mp4" ...>, or muted when it is silent. Nothing else is needed.

In the final message, list each imported part with its level, what a person can change in Studio, and how the frame-by-frame comparison came out.

Files included

  • assets/.gitkeep
  • assets/test-corpus/.gitignore
  • assets/test-corpus/run.sh
  • assets/test-corpus/tier-1-title-card/.gitignore
  • assets/test-corpus/tier-1-title-card/expected.json
  • assets/test-corpus/tier-1-title-card/hf-src/compositions/title.html
  • assets/test-corpus/tier-1-title-card/hf-src/index.html
  • assets/test-corpus/tier-1-title-card/README.md
  • assets/test-corpus/tier-1-title-card/remotion-src/package.json
  • assets/test-corpus/tier-1-title-card/remotion-src/remotion.config.ts
  • assets/test-corpus/tier-1-title-card/remotion-src/src/index.ts
  • assets/test-corpus/tier-1-title-card/remotion-src/src/Root.tsx
  • assets/test-corpus/tier-1-title-card/remotion-src/src/TitleCard.tsx
  • assets/test-corpus/tier-1-title-card/remotion-src/tsconfig.json
  • assets/test-corpus/tier-2-multi-scene/.gitignore
  • assets/test-corpus/tier-2-multi-scene/expected.json
  • assets/test-corpus/tier-2-multi-scene/hf-src/compositions/scene-1.html
  • assets/test-corpus/tier-2-multi-scene/hf-src/compositions/scene-2.html
  • assets/test-corpus/tier-2-multi-scene/hf-src/compositions/scene-3.html
  • assets/test-corpus/tier-2-multi-scene/hf-src/index.html
  • assets/test-corpus/tier-2-multi-scene/README.md
  • assets/test-corpus/tier-2-multi-scene/remotion-src/package.json
  • assets/test-corpus/tier-2-multi-scene/remotion-src/remotion.config.ts
  • assets/test-corpus/tier-2-multi-scene/remotion-src/src/index.ts
  • assets/test-corpus/tier-2-multi-scene/remotion-src/src/MultiScene.tsx
  • assets/test-corpus/tier-2-multi-scene/remotion-src/src/Root.tsx
  • assets/test-corpus/tier-2-multi-scene/remotion-src/tsconfig.json
  • assets/test-corpus/tier-2-multi-scene/setup.sh
  • assets/test-corpus/tier-3-data-driven/.gitignore
  • assets/test-corpus/tier-3-data-driven/expected.json
  • assets/test-corpus/tier-3-data-driven/hf-src/compositions/scene-1.html
  • assets/test-corpus/tier-3-data-driven/hf-src/compositions/scene-2.html
  • assets/test-corpus/tier-3-data-driven/hf-src/compositions/scene-3.html
  • assets/test-corpus/tier-3-data-driven/hf-src/index.html
  • assets/test-corpus/tier-3-data-driven/README.md
  • assets/test-corpus/tier-3-data-driven/remotion-src/package.json
  • assets/test-corpus/tier-3-data-driven/remotion-src/remotion.config.ts
  • assets/test-corpus/tier-3-data-driven/remotion-src/src/components/AnimatedNumber.tsx
  • assets/test-corpus/tier-3-data-driven/remotion-src/src/components/StatCard.tsx
  • assets/test-corpus/tier-3-data-driven/remotion-src/src/components/UnderlinedText.tsx
  • assets/test-corpus/tier-3-data-driven/remotion-src/src/index.ts
  • assets/test-corpus/tier-3-data-driven/remotion-src/src/Root.tsx
  • assets/test-corpus/tier-3-data-driven/remotion-src/src/scenes/OutroScene.tsx
  • assets/test-corpus/tier-3-data-driven/remotion-src/src/scenes/StatsScene.tsx
  • assets/test-corpus/tier-3-data-driven/remotion-src/src/scenes/TitleScene.tsx
  • assets/test-corpus/tier-3-data-driven/remotion-src/src/Stargazed.tsx
  • assets/test-corpus/tier-3-data-driven/remotion-src/tsconfig.json
  • assets/test-corpus/tier-4-escape-hatch/cases/01-use-state.tsx
  • assets/test-corpus/tier-4-escape-hatch/cases/02-use-effect-deps.tsx
  • assets/test-corpus/tier-4-escape-hatch/cases/03-async-metadata.tsx
  • assets/test-corpus/tier-4-escape-hatch/cases/04-third-party-react.tsx
  • assets/test-corpus/tier-4-escape-hatch/cases/05-lambda-config.tsx
  • assets/test-corpus/tier-4-escape-hatch/cases/06-warnings-only.tsx
  • assets/test-corpus/tier-4-escape-hatch/cases/07-custom-hook.tsx
  • assets/test-corpus/tier-4-escape-hatch/cases/08-mixed.tsx
  • assets/test-corpus/tier-4-escape-hatch/expected.json
  • assets/test-corpus/tier-4-escape-hatch/README.md
  • assets/test-corpus/tier-4-escape-hatch/validate.sh
  • references/api-map.md
  • references/escape-hatch.md
  • references/eval.md
  • references/fonts.md
  • references/limitations.md
  • references/lottie.md
  • references/media.md
  • references/parameters.md
  • references/sequencing.md
  • references/timing.md
  • references/transitions.md
  • scripts/.gitkeep
  • scripts/lint_source.py
  • scripts/tests/boxSizing.test.mjs
  • scripts/tests/fixtures/blocker.tsx
  • scripts/tests/fixtures/clean.tsx
  • scripts/tests/smoke.sh
  • SKILL.md

More skills for Front-end Development