About this project

vos is a programmatic video engine and CLI designed to turn product interactions into high-quality demo videos, store listings, and social media clips. It operates on the principle that a video frame is a pure function of time, ensuring deterministic results across different environments (browser, Node.js, or server). Key capabilities include: - Programmatic Animation: Uses JSON descriptions to compile Three.js scenes and GSAP-dialect timelines into self-contained programs. - Screen-Recording Pipeline: The CLI can script a browser to record a product, track cursor movements, and automatically plan zooms and pacing. - Data-Driven Editing: Editing decisions are stored in JSON documents, allowing for re-renders without the need for re-recording. - Distributed Rendering: Supports sharding timelines into parallel chunks for faster rendering via @vosjs/render-core. - Modular Architecture: A monorepo consisting of specialized packages for timeline math (@vosjs/timeline), tweening (@vosjs/tween), core engine logic (@vosjs/core), and element rendering (@vosjs/elements). The system is resolution-independent and supports mixed media, including text, images, SVG, and video overlays rendered as Three.js elements.