makevideo
Open source · CPU-only · no API key

Fast, standard video generation for AI agents.

Write a video as Markdown or JSON. makevideo voices it with a local neural voice, times every scene to the real audio, adds captions and transitions, and renders an MP4 — on a plain CPU, faster than it plays.

Quick start

# video.md
# Weekly update
What shipped this week
> Here is what shipped this week.

## Highlights
- Faster builds
- New onboarding
> Two highlights. Builds are faster. And onboarding is new.
npx -y github:random00000000/makevideo video.md          # → video.mp4 + video.srt + poster + report
npx -y github:random00000000/makevideo video.md --fast   # ~10x real-time voice for drafts
npx -y github:random00000000/makevideo preview video.md  # contact sheet of every scene in ~1 s

Put it where your agents are

Any MCP client

Claude Desktop, Cursor, VS Code, Codex: add npx -y github:random00000000/makevideo mcp. Tools: make_video, preview_video (returns an image), check_video.

MCP setup →

Claude Code plugin

/plugin marketplace add random00000000/makevideo — then just say “make a video about…”.

Agent workflow →

Every agent in a repo

npx -y github:random00000000/makevideo agents --all writes a “use makevideo for videos” block into AGENTS.md, CLAUDE.md, Cursor rules and Copilot instructions.

How it works →

What you get without asking

Narration by default

Every scene is spoken. Same voice on every video. Symbols like 42%, v1.2 and $3M are read correctly.

Premium look

Transitions blended from real frames, kinetic statements, animated charts, split media layouts, bundled fonts.

Hard to get wrong

Lint flags walls of text and unsynced lists before rendering. Errors name the scene and show a working example.

Fast on a CPU

Frame holding, render processes and cached speech: a 74 s video re-renders in ~28 s on a laptop.

Guides

Narrated game trailers and devlogs from gameplay recordings

Record gameplay from a window, then turn clips into a narrated trailer or devlog with titles, captions and transitions — all from the command line.

How to make narrated videos with an AI agent (Claude Code, Codex, Cursor)

A repeatable way for coding agents to produce narrated, captioned MP4 videos — explainers, recaps, changelogs, demos — without building a new pipeline every time.

makevideo vs Remotion vs MoviePy vs ffmpeg scripts — which to use for programmatic video?

An honest comparison of ways to generate video from code, and when an opinionated, narration-first tool like makevideo is the right choice.

Turn a Markdown file into a narrated MP4 video

Write a video as Markdown — headings are scenes, quote lines are narration — and render it to a narrated, captioned MP4 with one command.

Give any MCP client a video tool (Claude Desktop, Cursor, VS Code, Codex)

Run makevideo as a Model Context Protocol server so any MCP-capable assistant can preview and render narrated MP4 videos.

Narrated text-to-video on a CPU — no GPU, no API key (Node.js)

Generate narrated MP4 videos from text on a plain CPU in Node.js, with a local neural TTS voice, captions and transitions. Measured timings included.

Make TikTok, Reels and YouTube Shorts programmatically, with word-by-word captions

Generate vertical 1080x1920 short-form videos with big word-by-word captions, a local voice-over and GIF export — from Markdown or JSON, on a CPU.