scroll-cinema

Convert a video into a frame-accurate scroll-driven website using FFmpeg, Lenis, and GSAP ScrollTrigger.

Updated Apr 3, 2026
One-click install
npx skills add https://github.com/BEIRUX/agent-skills --skill scroll-cinema
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: scroll-cinema
Source: https://github.com/BEIRUX/agent-skills/tree/main/scroll-cinema
Command: npx skills add https://github.com/BEIRUX/agent-skills --skill scroll-cinema

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires ffmpeg, ffprobe, and includes scripts (resource) and references (resource) components.

What problem does it solve?

Many marketing and product teams have a video but lack a pixel-accurate, scroll-driven web experience that scrubs the footage smoothly and synchronizes layered section animations; native video playback is asynchronous and cannot guarantee frame-accurate scrubbing. Scroll-cinema converts a source video into a preloaded image sequence and a canvas-based renderer so the site can drive frame playback deterministically and choreograph premium section animations.

Core Features & Use Cases

  • Frame extraction & interpolation: FFmpeg analysis with optional motion interpolation for short clips to reach a smooth target frame count.
  • Canvas-first playback: Preloads image sequences and renders frames to a canvas for pixel-perfect, instant frame switching.
  • Scroll choreography: Integrates Lenis smooth scrolling with GSAP ScrollTrigger to map scroll progress to frame indices and animate fixed overlay sections.
  • Production scaffold: Opinionated HTML/CSS/JS patterns, quality checklist, and a loader/preload strategy for reliable delivery.
  • Use Cases: product landing pages from demo videos, fashion/editorial showcases, brand hero experiences, and portfolio presentations that require cinematic pacing.

Quick Start

Use the scroll-cinema skill to extract frames from product-demo.mp4 into a frames/ folder and build a canvas-based scroll site with the provided scaffold.

Frequently Asked Questions about scroll-cinema

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

FAQPage Schema
How do I convert a video into a scroll-driven website with frame-accurate playback?

FFmpeg analyzes the source video and extracts a preloaded image sequence, while GSAP ScrollTrigger maps scroll progress to frame indices on a canvas to create a frame-accurate, scroll-driven website.

Why does scroll-driven video scrubbing use an image sequence instead of native video playback?

Scroll-driven video scrubbing uses an image sequence because native video playback is asynchronous and cannot guarantee frame-accurate scrubbing. Rendering preloaded frames to a canvas ensures pixel-perfect, instant frame switching for deterministic playback.

Do I need FFmpeg installed to extract frames for a cinematic scroll website?

Yes, FFmpeg and ffprobe are required dependencies. The skill uses FFmpeg for video analysis, optional motion interpolation, and frame extraction to generate the image sequence required for the canvas renderer.

Can I use GSAP ScrollTrigger and Lenis to synchronize fixed overlay sections with video frames?

Yes, the skill integrates Lenis smooth scrolling with GSAP ScrollTrigger to map scroll progress to frame indices and animate fixed overlay sections, ensuring choreographed transitions synchronized with the canvas frame playback.

What's the best way to build a cinematic landing page from a product demo video?

The best way is using an opinionated production scaffold that extracts frames into an image sequence and renders them on a canvas, using Lenis and GSAP ScrollTrigger to choreograph scroll progress with fixed overlay section animations.

What are the limitations of using canvas rendering for scroll-driven video experiences?

Canvas rendering requires preloading an entire extracted image sequence, which increases initial load times and memory usage, making it less suitable for very long videos without a strict preload strategy and quality checklist.