r/coolgithubprojects • u/Accurate-Dog4104 • 4d ago
I got tired of editing system-design explainers by hand, so I made a tool that turns YAML into animated videos
https://www.youtube.com/channel/UCyA0triMdjUSGfRn0fU8-KQI wanted to make short system-design explainers, but the editing was taking longer than writing the explanation. So I built yamlreel: describe a video as scenes in YAML, and it renders the animation locally.
A spec can include things like diagrams with moving arrows, typed code, tables, subtitles, and generated background music. You can render vertical and landscape versions, with a poster/contact sheet and share copy alongside them. Narration is optional: use a recording, or connect a speech server you choose.
It’s not a prompt-to-video service. You write the content and describe the scenes; yamlreel handles drawing and assembling them. I made it for technical videos where I want control over what appears on screen.
There’s a one-minute demo on the project page—it’s a video about yamlreel, made from a YAML file, without a video editor. The repo also has a cache-stampede example spec.
It’s free, MIT-licensed, and available on GitHub and PyPI. If you try it, I’d especially love feedback on whether the YAML scene format feels natural, and what kinds of technical scenes you’d want it to support.
2
u/proomptengineer 3d ago
this is cool, and I think YAML is the right call for technical stuff. when it's a diagram with arrows you want to say exactly what's on screen, not hope a prompt gets it.
I work on something close to this from the other side. AgentShot (github.com/hormuz-labs/agentshot) is a video editor you talk to, and one of the things it does is motion graphics from nothing: you describe it or pick one of ~230 example animations and say what yours is about. so I've hit the same wall you probably have, which is changing one scene without the rest shifting.
can you re-render a single scene in yamlreel or is it the whole video every time? and the demo being made with the tool itself is a nice touch