remotion-to-hyperframes
Bring existing video code or footage into HyperFrames and verify it frame by frame against the original - Remotion first, also Motion Canvas, Lottie, Three.js, p5.js, canvas or plain HTML/CSS animation, or renders from Manim, After Effects or Blender. Use to port, convert, migrate or reuse work made with another tool.
- License 许可
- Apache-2.0
- 最近更新
- 2026-11-14
- Stars
- ★ 0
- Forks
- 1
01 前言 Front Matter
- name
- remotion-to-hyperframes
- description
- Bring existing video code or footage into HyperFrames and verify it frame by frame against the original - Remotion first, also Motion Canvas, Lottie, Three.js, p5.js, canvas or plain HTML/CSS animation, or renders from Manim, After Effects or Blender. Use to port, convert, migrate or reuse work made with another tool.
02 资源文件 77
- 资产文件assets/.gitkeep—
- 资产文件assets/test-corpus/.gitignore16 B
- 脚本assets/test-corpus/run.sh8.4 KB
- 资产文件assets/test-corpus/tier-1-title-card/.gitignore128 B
- 资产文件assets/test-corpus/tier-1-title-card/expected.json1.7 KB
- 资产文件assets/test-corpus/tier-1-title-card/hf-src/compositions/title.html1.1 KB
- 资产文件assets/test-corpus/tier-1-title-card/hf-src/index.html1.1 KB
- 资产文件assets/test-corpus/tier-1-title-card/README.md2.1 KB
- 资产文件assets/test-corpus/tier-1-title-card/remotion-src/package.json296 B
- 脚本assets/test-corpus/tier-1-title-card/remotion-src/remotion.config.ts497 B
- 脚本assets/test-corpus/tier-1-title-card/remotion-src/src/index.ts109 B
- 资产文件assets/test-corpus/tier-1-title-card/remotion-src/src/Root.tsx259 B
- 资产文件assets/test-corpus/tier-1-title-card/remotion-src/src/TitleCard.tsx773 B
- 资产文件assets/test-corpus/tier-1-title-card/remotion-src/tsconfig.json337 B
- 资产文件assets/test-corpus/tier-2-multi-scene/.gitignore215 B
- 资产文件assets/test-corpus/tier-2-multi-scene/expected.json2.1 KB
- 资产文件assets/test-corpus/tier-2-multi-scene/hf-src/compositions/scene-1.html1.1 KB
- 资产文件assets/test-corpus/tier-2-multi-scene/hf-src/compositions/scene-2.html1.1 KB
- 资产文件assets/test-corpus/tier-2-multi-scene/hf-src/compositions/scene-3.html1004 B
- 资产文件assets/test-corpus/tier-2-multi-scene/hf-src/index.html1.8 KB
- 资产文件assets/test-corpus/tier-2-multi-scene/README.md3.2 KB
- 资产文件assets/test-corpus/tier-2-multi-scene/remotion-src/package.json298 B
- 脚本assets/test-corpus/tier-2-multi-scene/remotion-src/remotion.config.ts497 B
- 脚本assets/test-corpus/tier-2-multi-scene/remotion-src/src/index.ts109 B
- 资产文件assets/test-corpus/tier-2-multi-scene/remotion-src/src/MultiScene.tsx2.3 KB
- 资产文件assets/test-corpus/tier-2-multi-scene/remotion-src/src/Root.tsx264 B
- 资产文件assets/test-corpus/tier-2-multi-scene/remotion-src/tsconfig.json337 B
- 脚本assets/test-corpus/tier-2-multi-scene/setup.sh1.2 KB
- 资产文件assets/test-corpus/tier-3-data-driven/.gitignore128 B
- 资产文件assets/test-corpus/tier-3-data-driven/expected.json3.3 KB
- 资产文件assets/test-corpus/tier-3-data-driven/hf-src/compositions/scene-1.html1.6 KB
- 资产文件assets/test-corpus/tier-3-data-driven/hf-src/compositions/scene-2.html3.0 KB
- 资产文件assets/test-corpus/tier-3-data-driven/hf-src/compositions/scene-3.html1.6 KB
- 资产文件assets/test-corpus/tier-3-data-driven/hf-src/index.html1.7 KB
- 资产文件assets/test-corpus/tier-3-data-driven/README.md5.0 KB
- 资产文件assets/test-corpus/tier-3-data-driven/remotion-src/package.json319 B
- 脚本assets/test-corpus/tier-3-data-driven/remotion-src/remotion.config.ts497 B
- 资产文件assets/test-corpus/tier-3-data-driven/remotion-src/src/components/AnimatedNumber.tsx740 B
- 资产文件assets/test-corpus/tier-3-data-driven/remotion-src/src/components/StatCard.tsx1.4 KB
- 资产文件assets/test-corpus/tier-3-data-driven/remotion-src/src/components/UnderlinedText.tsx1.1 KB
- 脚本assets/test-corpus/tier-3-data-driven/remotion-src/src/index.ts109 B
- 资产文件assets/test-corpus/tier-3-data-driven/remotion-src/src/Root.tsx681 B
- 资产文件assets/test-corpus/tier-3-data-driven/remotion-src/src/scenes/OutroScene.tsx423 B
- 资产文件assets/test-corpus/tier-3-data-driven/remotion-src/src/scenes/StatsScene.tsx676 B
- 资产文件assets/test-corpus/tier-3-data-driven/remotion-src/src/scenes/TitleScene.tsx1.2 KB
- 资产文件assets/test-corpus/tier-3-data-driven/remotion-src/src/Stargazed.tsx970 B
- 资产文件assets/test-corpus/tier-3-data-driven/remotion-src/tsconfig.json337 B
- 资产文件assets/test-corpus/tier-4-escape-hatch/cases/01-use-state.tsx1000 B
- 资产文件assets/test-corpus/tier-4-escape-hatch/cases/02-use-effect-deps.tsx954 B
- 资产文件assets/test-corpus/tier-4-escape-hatch/cases/03-async-metadata.tsx1.1 KB
- 资产文件assets/test-corpus/tier-4-escape-hatch/cases/04-third-party-react.tsx1.2 KB
- 资产文件assets/test-corpus/tier-4-escape-hatch/cases/05-lambda-config.tsx1.4 KB
- 资产文件assets/test-corpus/tier-4-escape-hatch/cases/06-warnings-only.tsx1.4 KB
- 资产文件assets/test-corpus/tier-4-escape-hatch/cases/07-custom-hook.tsx1.1 KB
- 资产文件assets/test-corpus/tier-4-escape-hatch/cases/08-mixed.tsx1.1 KB
- 资产文件assets/test-corpus/tier-4-escape-hatch/expected.json2.7 KB
- 资产文件assets/test-corpus/tier-4-escape-hatch/README.md2.8 KB
- 脚本assets/test-corpus/tier-4-escape-hatch/validate.sh3.5 KB
- 许可证LICENSE10.5 KB
- 参考文档MIRROR.md870 B
- 参考文档references/api-map.md16.1 KB
- 参考文档references/escape-hatch.md5.3 KB
- 参考文档references/eval.md4.3 KB
- 参考文档references/fonts.md3.2 KB
- 参考文档references/limitations.md4.9 KB
- 参考文档references/lottie.md4.9 KB
- 参考文档references/media.md4.4 KB
- 参考文档references/parameters.md4.8 KB
- 参考文档references/sequencing.md6.8 KB
- 参考文档references/timing.md6.9 KB
- 参考文档references/transitions.md4.4 KB
- 脚本scripts/.gitkeep—
- 脚本scripts/lint_source.py12.7 KB
- 脚本scripts/tests/boxSizing.test.mjs939 B
- 脚本scripts/tests/fixtures/blocker.tsx1.8 KB
- 脚本scripts/tests/fixtures/clean.tsx1.3 KB
- 脚本scripts/tests/smoke.sh1.5 KB
03 SKILL.md 正文
Plugin installs: Inside a HyperFrames plugin, follow plugin execution 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.
| Level | For | How | Editable in Studio afterwards |
|---|---|---|---|
| Native | code that can become HTML + GSAP: most Remotion, HTML/CSS/GSAP animation, simple Motion Canvas | translate it, then verify frame by frame | every element; variables, catalog, presets apply |
| Hosted | code that can draw any requested frame in a browser: canvas, p5.js, Three.js, Lottie, WebGL, other JS animation | keep the code and drive it from HyperFrames time | timing, position, exposed parameters |
| Media | anything that outputs video or frames: Manim, After Effects, Blender, PIL, moviepy | render to a file and use it as a clip | cut, 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
- For Remotion, run
python3 <SKILL_DIR>/scripts/lint_source.py <source dir>first. Blockers (useState,useReducer,useEffectwith dependencies, asynccalculateMetadata, 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/lambdaconfig,delayRender,useMemo, custom hooks) are dropped and noted. - Translate to the
/hyperframescontract: one sub-composition per scene, times in seconds (frame / fps), asset paths root-relative. Each Remotion API's equivalent is inreferences/api-map.md. Put Remotion's render-page rule* { box-sizing: border-box; }once in the rootindex.html<style>: without it every bordered or padded element grows by its border and padding. - Keep it editable: the source's props become
data-composition-variablesbound withdata-var-text,data-var-srcorvar(--id); eachSequencebecomes a timed clip or a sub-composition; a reused component becomes one sub-composition mounted several times withdata-variable-values. - 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 andnpx 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 inreferences/eval.md). Render the Remotion side withConfig.setVideoImageFormat("png")andConfig.setColorSpace("bt709"), or the diff measures the encoders (about 0.05 SSIM). - Write what didn't translate cleanly (dropped volume ramps, approximated presentations, substituted fonts) to
TRANSLATION_NOTES.md.
| Remotion | Read |
|---|---|
Composition, defaultProps, schema, calculateMetadata |
references/parameters.md |
Sequence, Series, Loop, AbsoluteFill, Freeze |
references/sequencing.md |
useCurrentFrame, interpolate, spring, Easing, interpolateColors |
references/timing.md |
Audio, Video, Img, IFrame, staticFile, delayRender |
references/media.md |
TransitionSeries, @remotion/transitions |
references/transitions.md |
@remotion/lottie |
references/lottie.md |
@remotion/google-fonts, Font.loadFont, @font-face |
references/fonts.md |
| What can't be ported | references/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.
04 同仓库更多 Skills
X MCP guide
ALWAYS read this before using any X tool (the X plugin, any X MCP, or Grok Bot's built-in public X reads) and again on any X error. X tools are included in Grok Bot at no cost: never estimate costs, check credits, or tell the user to buy credits. tools=0 / user-X-* not found is a setup failure, not a paywall. Covers Spaces, communities, and Lists (reads and list writes), X Chat (XChat, inbox, DMs, unread, message requests, Chat PIN, juicebox, xchat_lite: clone xchat-grokbot-helper yourself and decrypt locally), scheduled X calls (schedule_call, list_scheduled_calls and the other call tools), and livestreams (stream sources, broadcasts, scheduled broadcasts, broadcast chat, moderators, mutes). Chat, call, livestream, Spaces, or Lists tools missing while other X tools work: reconnect the X plugin.
X Money guide
Read this before the first X Money action in a session and again on any X Money error, refusal, or missing capability. Covers the approval rule for every action that moves money (always ask, every time, no exceptions), how the connection works (connection code plus passkey in the X app), how to guide the user through connect, reconnect, and revoke at x.com/i/money/settings/connections, and what each failure message means.
google-slides
Build and edit Google Slides through the google-slides MCP tools - slides, grids of cards and columns, text boxes, shapes, images, tables, styling, layout inspection, and per-slide PNG rendering. Use when creating a deck, laying out slide elements, matching a template, or verifying how a slide looks.
google-sheets
Build and edit Google Sheets with the google-sheets tools - values, formatting, charts, conditional formatting, structure, validation, named and protected ranges. Use when creating a spreadsheet or dashboard, formatting cells, adding or fixing charts, or reorganizing tabs and rows.
google-drive
Work with Google Drive through its MCP tools - search, read, create, organize, share, comment, and export files. Use when creating files in specific folders, moving or renaming, converting Markdown/CSV into Docs/Sheets, managing comments, or exporting a rendered PDF.
google-docs
Author and edit Google Docs with the google-docs tools - structured writing, character and paragraph styling, lists, tables, images, headers/footers. Use when creating a formatted document, editing document content, or applying styles.