alisa0808/vox-director — explained in plain English
Analysis updated 2026-05-18
Turn a one-line topic into a finished paper-collage style explainer video automatically.
Produce a short ad style video with narration, music, and captions with minimal manual editing.
Generate several visual styles for the same opening beat and pick the one you like before committing.
Animate real people or brand content using the frame-by-frame local motion path instead of a general AI video model.
| alisa0808/vox-director | zli12321/lhtb | kuskhan/jetendard | |
|---|---|---|---|
| Stars | 349 | 345 | 344 |
| Language | Python | Python | Python |
| Setup difficulty | moderate | hard | — |
| Complexity | 3/5 | 4/5 | 2/5 |
| Audience | vibe coder | researcher | developer |
Figures from each repo's GitHub metadata at analysis time.
Requires a Claude Code or similar coding agent, an Atlas Cloud API key, and local ffmpeg plus Python with Pillow installed.
Vox Director turns a single topic you type into a finished short explainer video, made in the paper collage style popularized by Vox's explainer videos, with hand cut looking paper cutouts, torn edges, tape, and bold headline text, all animated with narration, music, and captions. It is built as an agent skill, meaning it is not a standalone app but a workflow that a coding agent like Claude Code or Codex can follow, calling the Atlas Cloud API for AI models and the ffmpeg tool for video editing on your own machine. The process runs through several automated stages driven by a single project file. First the agent drafts a narrative arc for your topic and writes out a beat map, which you approve before anything else happens. Second, it renders the same opening beat in three or four different visual styles so you can pick the look you want by eye. From there it generates one finished collage poster image per beat, then animates each poster into a moving clip using an AI video model. A narrator voice and background music are generated separately, and everything is assembled into a final video with ffmpeg, which lines up the music under the narration and burns in captions and a watermark. For content involving real people or brands, there is a different animation path that avoids some of the content restrictions of general purpose AI video models by cutting the poster into individual pieces locally and animating them frame by frame instead of asking an AI model to animate the whole image at once. To use it, you install the skill files into your coding agent's skills folder, set an Atlas Cloud API key, and make sure ffmpeg and Python with the Pillow image library are installed. You then simply describe the video you want to your agent, for example a short collage video introducing a topic in a chosen language and aspect ratio, and the agent runs the whole pipeline, stopping twice to ask which beat map and style you prefer before producing the finished video file. The project is released under the MIT license.
An agent skill that turns a one-line topic into a finished Vox-style paper-collage explainer video, fully automated except for two approval steps.
Mainly Python. The stack also includes Python, ffmpeg, Atlas Cloud API.
Free to use, modify, and distribute for any purpose, including commercial use, as long as the original copyright notice is kept.
Setup difficulty is rated moderate, with roughly 30min to a first successful run.
Mainly vibe coder.
This repo across BitVibe Labs
Verify against the repo before relying on details.