mediaproc
by psyb0t
Media & StreamingBrief
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
User asks: convert input.mp4 to H.264 and download the result
- 1
Upload input.mp4 to the container using 'put input.mp4'
- 2
Run ffmpeg with libx264 to transcode to output.mp4
- 3
Download output.mp4 from the container using 'get output.mp4'
- 4
Remove input.mp4 and output.mp4 from the container to clean up
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/mediaprocRun the CLI command, or paste the prompt into Claude Code, Cursor, Codex or whichever coding agent you use.