gehdoc/svg-to-video repository overview

⁠SVG to Video Converter (gehdoc/svg-to-video)

A high-fidelity tool powered by Chromium and FFmpeg to render CSS-animated SVGs into video files (MP4, WebM, MKV, MOV) or animated images (aPNG, GIF) with full alpha-channel background transparency.

⁠🚀 Quick Start

⁠1. Render an SVG to Video or Animated GIF

Run the container locally to convert an SVG file (add :Z to -v for SELinux / Fedora compatibility):

docker run --rm \
  --user $(id -u):$(id -g) \
  --shm-size=2gb \
  -v "$(pwd)":/data:Z \
  gehdoc/svg-to-video /data/input.svg 60 /data/output --format webm -d 5 --transparent

(Creates /data/output/input.webm with background transparency).

⁠2. Run in MCP Server Mode (AI Agent Integration)

Connect to AI Assistants (Claude Desktop, Cursor, Antigravity) over Stdio:

docker run -i --rm \
  --user $(id -u):$(id -g) \
  -v "$(pwd)":/app/data:Z \
  gehdoc/svg-to-video mcp

⁠📄 License

This project is open-source software licensed under the MIT License⁠.