name: ffmpeg-cli
description: Comprehensive video/audio processing with FFmpeg. Use for: (1) Video transcoding and format conversion, (2) Cutting and merging clips, (3) Audio extraction and manipulation, (4) Thumbnail and GIF generation, (5) Resolution scaling and quality adjustment, (6) Adding subtitles or watermarks, (7) Speed adjustment (slow/fast motion), (8) Color correction and filters.
metadata: {"clawdbot":{"emoji":"🎬","requires":{"bins":["ffmpeg"]},"install":[{"id":"brew","kind":"brew","formula":"ffmpeg","bins":["ffmpeg"],"label":"Install ffmpeg (brew)"}]}}
FFmpeg CLI
Quick Reference
| Task | Command |
|---|
| Cut video | {baseDir}/scripts/cut.sh -i <input> -s <start> -e <end> -o <output> |
| Merge clips | {baseDir}/scripts/merge.sh -o <output> <file1> <file2> ... |
| Extract audio | {baseDir}/scripts/extract-audio.sh -i <video> -o <output.mp3> |
| Generate thumbnail | {baseDir}/scripts/thumb.sh -i <video> -t <timestamp> -o <out.jpg> |
| Create GIF | {baseDir}/scripts/gif.sh -i <video> -s <start> -e <end> -o <out.gif> |
| Convert format | {baseDir}/scripts/convert.sh -i <input> -o <output.mp4> |
| Change speed | {baseDir}/scripts/speed.sh -i <input> -r <0.5-2.0> -o <output> |
| Add watermark | {baseDir}/scripts/watermark.sh -i <video> -w <image> -o <output> |
Scripts
cut.sh - Cut video segment
{baseDir}/scripts/cut.sh -i video.mp4 -s 00:01:30 -e 00:02:45 -o clip.mp4
merge.sh - Concatenate videos
{baseDir}/scripts/merge.sh -o merged.mp4 part1.mp4 part2.mp4 part3.mp4
extract-audio.sh - Pull audio track
{baseDir}/scripts/extract-audio.sh -i video.mp4 -o audio.mp3
thumb.sh - Extract frame as image
{baseDir}/scripts/thumb.sh -i video.mp4 -t 00:00:15 -o frame.jpg
gif.sh - Convert clip to GIF
{baseDir}/scripts/gif.sh -i video.mp4 -s 00:00:10 -e 00:00:15 -o clip.gif
convert.sh - Transcode to new format
{baseDir}/scripts/convert.sh -i input.avi -o output.mp4
speed.sh - Adjust playback speed
{baseDir}/scripts/speed.sh -i video.mp4 -r 2.0 -o fast.mp4
{baseDir}/scripts/speed.sh -i video.mp4 -r 0.5 -o slow.mp4
watermark.sh - Overlay image watermark
{baseDir}/scripts/watermark.sh -i video.mp4 -w logo.png -o output.mp4
Notes
- All scripts support common video formats (mp4, avi, mov, mkv, webm, etc.)
- Output quality is optimized for balanced file size and clarity
- Use
-h or no args to see script usage
