hyperframes

Render MP4 and WebM videos from HTML compositions with GSAP animations and FFmpeg encoding.

Updated Aug 22, 2026
One-click install
npx skills add https://github.com/vivekgoquest/hermes-agent-stable --skill hyperframes-vivekgoquest
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: hyperframes
Source: https://github.com/vivekgoquest/hermes-agent-stable/tree/main/optional-skills/creative/hyperframes
Command: npx skills add https://github.com/vivekgoquest/hermes-agent-stable --skill hyperframes-vivekgoquest

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve? Creating rendered videos from text, scripts, or websites normally requires video editing software and manual timeline work. This Skill turns HTML/CSS/JS compositions into deterministic MP4/WebM videos by capturing pages frame-by-frame and encoding them with FFmpeg. ## Core Features & Use Cases - HTML-to-Video Rendering: Author compositions as HTML files with data-* timing attributes and GSAP timelines, then render to MP4 or WebM at 24/30/60fps in draft, standard, or high quality. - Captions, TTS, and Audio-Reactive Visuals: Generate local Kokoro TTS narration in 8 languages, transcribe with Whisper for word-level captions, and drive visuals from pre-extracted audio frequency bands. - Website-to-Video Pipeline: Capture a URL into screenshots, assets, and design tokens, then follow a 7-step workflow (capture, DESIGN.md, SCRIPT.md, storyboard, composition, render, deliver) to produce a promo video. - Use Case: A user provides a product landing page URL and asks for a 30-second social ad. The Skill captures the site, extracts its brand colors and fonts into a DESIGN.md, writes a narration script, builds a multi-scene composition with shader transitions, and renders a final MP4. ## Quick Start Ask the agent to render a short animated promo video from a script or website URL, and it will scaffold a project with npx hyperframes init, build the composition, and render it to an MP4 file.

Frequently Asked Questions about hyperframes

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

FAQPage Schema
How do I render a video from HTML and GSAP animations?▼

Scaffold a project with npx hyperframes init, write 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. Lint and preview before the final render.

What tool should I use for math animation vs motion graphics video?▼

Use manim-video for mathematical and geometric explainers such as equations or 3B1B-style content. Use hyperframes for motion graphics, captioned talking-head videos, product tours, social overlays, and anything driven by real video or audio media.

Does hyperframes support text-to-speech narration and captions?▼

Yes, it includes local Kokoro TTS with 54 voices across 8 languages via npx hyperframes tts, and Whisper-based word-level transcription via npx hyperframes transcribe for generating timed captions. Non-English phonemization requires espeak-ng installed system-wide.

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

Chromium 147+ removed the beginFrame CDP command. Upgrade to hyperframes 0.4.2 or later, which auto-detects support and falls back to screenshot mode, or set PRODUCER_FORCE_SCREENSHOT=true. Installing chrome-headless-shell restores the faster capture path.

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 2 GB of scratch disk space. The chrome-headless-shell browser is recommended over system Chrome for best render quality.

When should I not use HTML-to-video rendering?▼

Avoid it for pure math or equation animation, which belongs in manim-video, and for image generation or memes, which belong in image-model skills. It also does not handle live video conferencing or streaming, only deterministic file output.