hyperframes

Create rendered MP4 and WebM videos from HTML compositions using GSAP timelines and FFmpeg.

Updated Jun 7, 2026
One-click install
npx skills add https://github.com/Chensihakniroth/ANAKOT-AGENT --skill hyperframes-chensihakniroth
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: hyperframes
Source: https://github.com/Chensihakniroth/ANAKOT-AGENT/tree/main/optional-skills/creative/hyperframes
Command: npx skills add https://github.com/Chensihakniroth/ANAKOT-AGENT --skill hyperframes-chensihakniroth

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires hyperframes, puppeteer, and includes scripts (resource) and references (resource) components.

What problem does it solve? Producing motion-graphics videos, captioned narration clips, and website promos normally requires manual video editing; this Skill turns HTML, CSS, and GSAP animations into deterministic frame-by-frame rendered video files. ## Core Features & Use Cases - HTML-to-Video Rendering: Author compositions as HTML files with data-* timing attributes and GSAP timelines, then render to MP4/WebM via the HyperFrames CLI and FFmpeg. - Captions, TTS, and Audio-Reactive Visuals: Generate local TTS narration with Kokoro voices, transcribe word-level captions with Whisper, and drive visuals from pre-extracted audio bands. - Website-to-Video Pipeline: Capture a URL's screenshots, assets, and design tokens, then follow a 7-step workflow (DESIGN.md, SCRIPT.md, storyboard, composition, render) to produce a promo video. - Use Case: A user provides a product landing page URL and asks for a 30-second vertical promo with narration and captions; the Skill captures the site, writes the script, builds the composition, and renders final.mp4. ## Quick Start Ask the agent to create a rendered video from an HTML composition or a website URL, for example: turn this landing page into a 30-second captioned promo video with TTS narration.

Frequently Asked Questions about hyperframes

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I render an HTML animation to an MP4 video?▼

Author an HTML composition with data-start and data-duration attributes plus a paused GSAP timeline registered on window.__timelines, then run npx hyperframes render --output final.mp4. The engine captures the page frame-by-frame and encodes with FFmpeg.

How do I add captions and TTS narration to a video?▼

Generate narration with npx hyperframes tts using a Kokoro voice, then run npx hyperframes transcribe on the WAV file to get word-level timings. Bind caption groups to the GSAP timeline with a hard visibility kill at each group's end time.

When should I use HyperFrames instead of Manim for video generation?▼

Use HyperFrames for motion graphics, talking-head videos with captions, product tours, social overlays, and anything driven by real video or audio media. Use Manim for mathematical and geometric explainer animations such as equations and 3B1B-style content.

Why does hyperframes render fail with HeadlessExperimental.beginFrame not found?▼

Chromium 147 and later removed the beginFrame CDP command used by the capture path. Upgrade to hyperframes 0.4.2 or later for auto-detection and screenshot fallback, install chrome-headless-shell, or set PRODUCER_FORCE_SCREENSHOT=true.

What are the system requirements for running HyperFrames?▼

HyperFrames requires Node.js 22 or later, FFmpeg on PATH, at least 4 GB of free RAM, and about 2 GB of scratch disk space. The chrome-headless-shell browser is recommended over system Chrome for the fast rendering path.

Why does my GSAP animation break the HyperFrames render?▼

Common causes are repeat: -1 infinite tweens, Math.random() or Date.now() non-determinism, and building timelines inside async code or setTimeout. Timelines must be constructed synchronously, start paused, and use finite computed repeat counts.