Skip to content
TakoAPI
Back to skills

mediaproc

by psyb0t

Media & Streaming
—Not yet rated
Your rating

Brief

Process media files (video, audio, images) via a locked-down SSH container.

Description

What This Skill Does

Runs ffmpeg, sox, and ImageMagick commands over SSH through a locked-down container. Supports video transcoding, audio processing, and image manipulation. File upload, processing, and download go through a shell wrapper script using two environment variables.

Keeps media processing tools in an isolated SSH container rather than installed on the host, removing shell injection risk and local dependency conflicts.

When to Use It

  • Transcoding a video file to H.264 for web playback
  • Extracting an audio track from a recorded video
  • Resizing or thumbnailing product images in batch
  • Normalizing audio levels before publishing a podcast episode
  • Generating a preview frame from a video at a specific timestamp

Example Workflow

INPUT

User asks: convert input.mp4 to H.264 and download the result

AGENT
  1. 1

    Upload input.mp4 to the container using 'put input.mp4'

  2. 2

    Run ffmpeg with libx264 to transcode to output.mp4

  3. 3

    Download output.mp4 from the container using 'get output.mp4'

  4. 4

    Remove input.mp4 and output.mp4 from the container to clean up

OUTPUT

output.mp4 saved locally, encoded in H.264

Requirements

  • MEDIAPROC_HOST environment variable
  • MEDIAPROC_PORT environment variable
  • Running mediaproc Docker instance (self-hosted)

Installation

clawhub install psyb0t/mediaproc

Run the CLI command, or paste the prompt into Claude Code, Cursor, Codex or whichever coding agent you use.

Links