SVG to Video

A high-fidelity tool to transform your CSS- and SMIL-animated SVGs into high-quality videos (MP4, WebM, MKV, MOV) or lightweight animated formats (aPNG, GIF) with perfect alpha-channel transparency directly in your browser or via CLI/MCP server.
π Why SVG to Video?
- Transparent Backgrounds: Export your animations with a full alpha channel using WebM or aPNG, and optimized indexed transparency with GIF89a. Perfect for overlays in video editing tools or web use.
- Privacy-First: The Web Studio runs entirely in your browserβyour SVG files never leave your computer.
- Frame-Accurate: Our engine scrubs both the Web Animations API and native SVG SMIL, ensuring every frame is captured exactly as rendered.
- AI Agent Native: Native Model Context Protocol (MCP) server and Agent Skill (
SKILL.md) support indexed on the official MCP Registry (mcp.json) and hosted live on HuggingFace Spaces.
- Universal Animated Formats: Beyond video, generate lightweight Animated PNGs (aPNG) and GIFs perfect for documentation, Slack, or GitHub, with full control over background transparency.
- Copy to Clipboard: Instant export to Base64 Data URLβcopy your video and embed it directly into your HTML, CSS, or JS code without manual downloads. Perfect for rapid prototyping and developers.
- Metadata Injection: Support for custom titles and comments across video (MP4, WebM, MKV, MOV) and animated image (aPNG, GIF) formats.
- Versatile: Whether you need an accessible Web Studio for quick conversions or a powerful CLI tool for batch automation and CI/CD pipelines, this project has you covered.
π Getting Started
Choose the entry point that matches your needs:
- Web Studio: The easiest way to convert SVGs to video, high-fidelity aPNG, or optimized GIF in your browser without any installation.
- CLI / Docker Tool: For batch processing, server-side automation, and CI/CD integration.
- AI Agent & MCP Server: For Claude Desktop, Cursor, Antigravity, and autonomous LLM workflows.
π Web Studio
π Try the Web Studio
Our Web Studio is a serverless, client-side rendering tool. It runs entirely in your browser using WebCodecsβyour SVG files never leave your computer, ensuring absolute privacy. The interface is optimized for high-productivity on screens starting from 720p resolution.
Automated Demo: The demo video at the top of this README is automatically generated and updated by our CI/CD pipeline using Playwright and Driver.js, ensuring it always reflects the latest UI changes.
Privacy Note: We use Umami Analytics to collect anonymous usage data across our Web Studio, CLI, and MCP server interfaces (e.g., number of conversions and format usage) to help us improve the tool. This tracking is cookie-less, respects standard "Do Not Track" settings (set the DO_NOT_TRACK=1 environment variable to opt out), and never collects personal information or SVG contents. See docs/ANALYTICS.md for details.
Explore our Visual Gallery (Storybook) to see how the engine handles complex CSS, SMIL, and fonts.
Quick Start
- Open the Web Studio.
- Drag and drop your
.svg file, or test the engine instantly with 1-click built-in samples.
- Adjust resolution, duration, and FPS.
- Select your format, toggle Transparent Background if needed, and ensure High-Fidelity Capture is enabled for best results.
- Click Export.
For automated or batch processing, use the CLI tool. It is built to run in a headless environment, making it perfect for CI/CD pipelines or server-side automation.
Quick Start
Ensure Node.js and FFmpeg are installed.
npx -y -p @gehdoc/svg-to-video svg-to-video input.svg 60 ./out-dir
npx -y -p @gehdoc/svg-to-video svg-to-video input.svg 60 ./out-dir -d 5 --format gif --transparent
npx -y -p @gehdoc/svg-to-video svg-to-video input.svg 60 ./out-dir --resolution 1080x1920
npx -y -p @gehdoc/svg-to-video svg-to-video input.svg 60 ./out-dir -d 5 --format apng
docker run --rm --shm-size=2gb -e PUPPETEER_ARGS="--no-sandbox" -v $(pwd):/data:Z gehdoc/svg-to-video /data/input.svg 60 /data/out-dir -d 5 --format gif
See docs/CLI.md for full usage, arguments, and options. For local building and source execution, see CONTRIBUTING.md.
π€ AI Agent & MCP Integration
Connect svg-to-video to AI Assistants (Claude Desktop, Cursor, Antigravity, AutoGPT) via Model Context Protocol:
- Add to
mcpServers config:
{
"mcpServers": {
"svg-to-video": {
"command": "npx",
"args": ["-y", "-p", "@gehdoc/svg-to-video", "svg-to-video-mcp"]
}
}
}
- Prompt your AI Assistant:
"Convert examples/example.svg into a 60fps transparent WebM video."
See docs/MCP.md for full setup instructions, tool schemas, Docker execution, and agent prompting guides.
π Official Package Distributions
π¦ Quick Installation & Execution
npx -y -p @gehdoc/svg-to-video svg-to-video input.svg 60 ./out-dir
npm install -g @gehdoc/svg-to-video
docker pull gehdoc/svg-to-video:latest
π Technical Details
For a deep dive into the rendering engine, algorithms, and infrastructure, see docs/ARCHITECTURE.md.
The tool works by isolating the SVG, scrubbing both the Web Animations API and native SVG SMIL DOM, and capturing frames via WebCodecs or FFmpeg.
β FAQ
Common questions about privacy, how frame scrubbing works, CI/CD automation, and transparency support are answered in docs/FAQ.md.
π€ Contributing
Contributions are welcome! This project follows a Spec-Driven Development (SDD) workflow to ensure clear requirements and high quality. Please open an issue or pull request.
Check out our Active Roadmap to see what we're working on next.
For instructions on contributing, build commands, security standards, and the technical roadmap, please see CONTRIBUTING.md.
π Support the Project
If you find this tool helpful, please consider supporting its development:

Your support helps cover maintenance and further development of the tool. Thank you!
π License
This project is licensed under the MIT License.