pi-remotion

Remotion + ffmpeg extension for pi. Render programmatic videos with Remotion, post-process with ffmpeg — all from pi commands and LLM tools.

Install

pi install path:~/Projects/pi-remotion

Commands (slash commands for the human)

| Command | Description | |---|---| | /ffprobe <file> | Inspect video/audio — duration, resolution, codec, bitrate | | /transcode | Convert between formats, change codec/res/fps, trim, compress | | /frames | Extract frames as PNG/JPG images | | /gif | Convert video clip to optimized animated GIF | | /addaudio | Mux audio track onto a video | | /extractaudio | Rip audio track from a video | | /concat | Join multiple video files | | /thumbnail | Grab a single frame as an image | | /render | Trigger Remotion render (runs node render.mjs) |

LLM Tools (the agent can call these directly)

| Tool | Description | |---|---| | video_probe | Get file info (duration, resolution, codec, bitrate) | | video_transcode | Transcode with codec/quality/resolution/trim options | | video_to_gif | Convert to GIF with palette optimization | | video_add_audio | Mux audio onto video | | video_concat | Join multiple files | | remotion_render | Render a Remotion project |

Prerequisites

• ffmpeg + ffprobe on PATH
• Node.js for Remotion rendering
• Remotion projects need their own node_modules (run npm install in the project dir)

Examples

/ffprobe presentations/talk.mp4
/gif input=talk.mp4 output=preview.gif start=00:00:10 duration=00:00:05 width=640
/transcode input=raw.mov output=compressed.mp4 codec=h264 crf=23 scale=1920:-1
/render project=~/Projects/gh-repo/remotion

License

MIT