---

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  # 2x speed
{baseDir}/scripts/speed.sh -i video.mp4 -r 0.5 -o slow.mp4  # 0.5x speed

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