This project presents a novel "scroll-scrubbed" video demo, showcasing a continuous camera flight through a 3D world. It targets developers and content creators seeking immersive, narrative-driven web experiences, offering a unique way to blend video playback with user interaction via scrolling. The primary benefit is a seamless, engaging visual journey driven entirely by user scroll input.

How It Works

The core mechanism maps user scroll position directly to the currentTime of pre-rendered video clips, effectively turning scrolling into a camera control. Each scene is a short video, and transitions between scenes are generated using Seedance 2, employing the actual last frame of one clip and the first frame of the next as keyframes. This frame-exact approach ensures a continuous, cut-free visual flow, creating the illusion of a single, uninterrupted camera path. All visual assets, including stills and motion, are generated using the Kubeez platform's tools like GPT-image-2 and Seedance 2. The front-end utilizes a dependency-free vanilla-JS engine to manage scroll-to-time mapping, lazy loading, and playback.

Quick Start & Requirements

To build or customize content, users typically interact with the Kubeez platform (mcp.kubeez.com/mcp) and its associated skills, such as scroll-world-video. Installation involves adding the Kubeez MCP plugin via Claude Code or similar agents (/plugin marketplace add KubeezMedia/kubeez-scroll-world-video, /plugin install scroll-world-video@kubeez). Running the provided demo locally requires serving the files via HTTP (e.g., python -m http.server 8080) and accessing http://localhost:8080. Content generation necessitates a Kubeez account and credits.

Highlighted Details

• Scroll input directly controls video playback time, not page scrolling.
• Frame-exact transitions generated from boundary frames ensure seamless scene changes.
• All imagery and motion are produced using the Kubeez platform (GPT-image-2, Seedance 2).
• The front-end engine is vanilla JavaScript, designed for portability and minimal dependencies.
• Video encoding (crf 20, -g 8, faststart) is optimized for smooth scrubbing performance even on static hosts.

Maintenance & Community

Specific details regarding maintainers, active community channels (like Discord/Slack), or ongoing development roadmaps are not detailed in the provided README. The project appears to be a showcase of the Kubeez platform's capabilities.

Licensing & Compatibility

The README states the "scroll engine and method are open," but content generation is exclusively through the Kubeez platform. No explicit open-source license (e.g., MIT, Apache) is mentioned for the engine code itself. Commercial use is implicitly governed by the terms of the Kubeez platform.

Limitations & Caveats

A significant adoption blocker is the mandatory reliance on the Kubeez platform and its associated costs (credits) for generating any custom world content. The effectiveness of the continuous shot relies heavily on carefully crafted transitions; deviating from the recommended low, continuous forward glide during transition generation can lead to jarring visual jumps when scrubbed.