@assemblyline-agents/ffmpeg

Official Assembly Line stdio connection for workspace-scoped FFmpeg operations.

FFmpeg is a host executable, not a remote account connection. This package bundles a small MCP server that exposes reviewed media operations and launches ffmpeg or ffprobe without a shell. It never exposes arbitrary command-line flags to the model.

Setup

Install FFmpeg on every runtime host:

# macOS
brew install ffmpeg

# Debian/Ubuntu
apt-get update && apt-get install -y ffmpeg

assembly-line add ffmpeg agent

The selected plugin enables every reviewed media operation. Require approval for editing operations with typed connection exceptions:

capabilities:
  ffmpeg:
    connections:
      ffmpeg:
        approval:
          trim_media: always
          transcode_media: always
          concat_media: always
          replace_audio: always
          reframe_vertical: always

The connection exposes:

• probe_media
• trim_media
• transcode_media
• concat_media
• replace_audio
• extract_frames
• reframe_vertical

All input and output paths must resolve inside the plugin-owned workspace root, including symlink targets. The deployment owner can select trusted ffmpegCommand and ffprobeCommand paths; agents cannot replace those executables or add unreviewed flags.

concat_media expects codec-compatible, normalized clips. Transcode source clips to a common size, frame rate, codec, and audio layout before stitching when they come from different devices or platforms.

extract_frames returns paths only by default. A custom plugin implementation may set previewFrames from one through twelve when the user requests or approves a frame-based approximation. Assembly Line never invokes frame sampling as a fallback for native video understanding, and agents must not claim that sampled stills are equivalent to watching temporal video.