pavel/media-transform
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
media-transform/README.md
pavel 0aee105835 init
2026-03-23 23:08:40 +01:00

1.2 KiB
Raw Permalink Blame History

Convertoor

A small web app that lets a user upload audio, video, or image files, describe an edit in plain English, and have a Zen-powered agent complete it using only ffmpeg and ImageMagick (magick) commands.

Requirements

  • Node.js 22+
  • ffmpeg
  • ImageMagick (magick)
  • ZEN_API_KEY

Run

npm install
ZEN_API_KEY=your_key_here npm start

Then open http://localhost:3000.

Optionally set ZEN_MODEL if you want a different Zen model and ZEN_BASE_URL if you need a non-default endpoint.

Notes

  • Uploaded files and generated outputs are stored in data/<session-id>/.
  • The backend never shells out through bash. It only spawns ffmpeg and magick directly.
  • Command arguments are restricted to the per-job workspace so the agent cannot read or write outside the upload session.
  • Uploads are validated server-side to only accept audio, video, and image MIME types.
  • FFmpeg is run with a restricted protocol allowlist and blocked file-driven/script-like flags.
  • ImageMagick is run with a local restrictive policy.xml in config/imagemagick/policy.xml.
  • Commands are killed after 60 seconds and final outputs larger than 250 MB are rejected.