FFmpeg与ImageMagick媒体处理指南：视频音频图像转换、优化与流媒体

media-processing by mrgoonie/claudekit-skills

286 周安装量

1,900 GitHub Stars

GitHub

安装命令

npx skills add https://github.com/mrgoonie/claudekit-skills --skill media-processing

内容创作自动化命令行工具

🇨🇳中文介绍

媒体处理技能

使用 FFmpeg 和 ImageMagick 命令行工具处理视频、音频和图像，用于转换、优化、流媒体和操作任务。

何时使用此技能

在以下情况下使用：

转换媒体格式（视频、音频、图像）
使用编解码器编码视频（H.264、H.265、VP9、AV1）
处理图像（调整大小、裁剪、特效、水印）
从视频中提取音频
创建流媒体清单（HLS/DASH）
生成缩略图和预览
批量处理媒体文件
优化文件大小和质量
应用滤镜和特效
创建合成图像或视频

工具选择指南

FFmpeg：视频/音频处理

使用 FFmpeg 处理：

视频编码、转换、转码
音频提取、转换、混音
直播流（RTMP、HLS、DASH）
视频滤镜（缩放、裁剪、旋转、叠加）
硬件加速编码
媒体文件检查（ffprobe）
帧提取、拼接
编解码器选择与优化

ImageMagick：图像处理

使用 ImageMagick 处理：

图像格式转换（PNG、JPEG、WebP、GIF）
调整大小、裁剪、变换
批量图像处理（mogrify）
视觉效果（模糊、锐化、棕褐色调）
文本叠加和水印
图像合成与蒙太奇
颜色调整、滤镜
缩略图生成

决策矩阵

任务	工具	原因

广告位招租

在这里展示您的产品或服务

触达数万 AI 开发者，精准高效

联系我们

批量图像调整大小

# 将所有 JPEG 调整为 800 像素宽度
mogrify -resize 800x -quality 85 *.jpg

# 输出到单独的目录
mogrify -path ./output -resize 800x600 *.jpg

# 在 5 秒处提取帧
ffmpeg -ss 00:00:05 -i video.mp4 -vframes 1 -vf scale=320:-1 thumb.jpg

# 生成 HLS 播放列表
ffmpeg -i input.mp4 \
  -c:v libx264 -preset fast -crf 22 -g 48 \
  -c:a aac -b:a 128k \
  -f hls -hls_time 6 -hls_playlist_type vod \
  playlist.m3u8

# 在角落添加水印
magick input.jpg watermark.png -gravity southeast \
  -geometry +10+10 -composite output.jpg

为 Web 优化视频

# H.264，压缩效果好
ffmpeg -i input.mp4 \
  -c:v libx264 -preset slow -crf 23 \
  -c:a aac -b:a 128k \
  -movflags +faststart \
  output.mp4

创建响应式图像

# 生成多种尺寸
for size in 320 640 1024 1920; do
  magick input.jpg -resize ${size}x -quality 85 "output-${size}w.jpg"
done

# 从 1:30 到 3:00（重新编码以确保精度）
ffmpeg -i input.mp4 -ss 00:01:30 -to 00:03:00 \
  -c:v libx264 -c:a aac output.mp4

# 将 PNG 转换为优化的 JPEG
mogrify -path ./optimized -format jpg -quality 85 -strip *.png

# 使用调色板的高质量 GIF
ffmpeg -i input.mp4 -vf "fps=15,scale=640:-1:flags=lanczos,split[s0][s1];[s0]palettegen[p];[s1][p]paletteuse" output.gif

# 高斯模糊
magick input.jpg -gaussian-blur 0x8 output.jpg

# 第 1 遍（分析）
ffmpeg -y -i input.mkv -c:v libx264 -b:v 2600k -pass 1 -an -f null /dev/null

# 第 2 遍（编码）
ffmpeg -i input.mkv -c:v libx264 -b:v 2600k -pass 2 -c:a aac output.mp4

# NVIDIA NVENC
ffmpeg -hwaccel cuda -i input.mp4 -c:v h264_nvenc -preset fast -crf 22 output.mp4

# Intel QuickSync
ffmpeg -hwaccel qsv -c:v h264_qsv -i input.mp4 -c:v h264_qsv output.mp4

复杂图像处理流程

# 调整大小、裁剪、边框、调整
magick input.jpg \
  -resize 1000x1000^ \
  -gravity center \
  -crop 1000x1000+0+0 +repage \
  -bordercolor black -border 5x5 \
  -brightness-contrast 5x10 \
  -quality 90 \
  output.jpg

# 缩放、降噪、水印
ffmpeg -i video.mp4 -i logo.png \
  -filter_complex "[0:v]scale=1280:720,hqdn3d[v];[v][1:v]overlay=10:10" \
  -c:a copy output.mp4

从图像创建动画 GIF

# 创建带延迟的 GIF
magick -delay 100 -loop 0 frame*.png animated.gif

# 优化大小
magick animated.gif -fuzz 5% -layers Optimize optimized.gif

# 详细的 JSON 输出
ffprobe -v quiet -print_format json -show_format -show_streams input.mp4

# 获取分辨率
ffprobe -v error -select_streams v:0 \
  -show_entries stream=width,height \
  -of csv=s=x:p=0 input.mp4

# 基本信息
identify image.jpg

# 详细格式信息
identify -verbose image.jpg

# 自定义格式
identify -format "%f: %wx%h %b\n" image.jpg

使用 CRF 进行质量控制 - 对于视频来说比比特率更好
尽可能复制流 - 使用 -c copy 避免重新编码
硬件加速 - GPU 编码速度快 5-10 倍
合适的预设 - 平衡速度与压缩率
使用 mogrify 批量处理 - 原地图像处理
剥离元数据 - 使用 -strip 减小文件大小
渐进式 JPEG - 使用 -interlace Plane 获得更好的网页加载效果
限制内存 - 防止大型批处理时崩溃
在样本上测试 - 批量处理前验证设置
并行处理 - 对多个文件使用 GNU Parallel

references/ 目录中的详细指南：

ffmpeg-encoding.md - 视频/音频编解码器、质量优化、硬件加速
ffmpeg-streaming.md - HLS/DASH、直播流、自适应比特率
ffmpeg-filters.md - 视频/音频滤镜、复杂滤镜图
imagemagick-editing.md - 格式转换、特效、变换
imagemagick-batch.md - 批量处理、mogrify、并行操作
format-compatibility.md - 格式支持、编解码器推荐

-c:v - 视频编解码器（libx264, libx265, libvpx-vp9）
-crf - 质量（0-51，值越低越好，23=默认）
-preset - 速度/压缩率（ultrafast 到 veryslow）
-b:v - 视频比特率（例如，2M, 2500k）
-vf - 视频滤镜

-c:a - 音频编解码器（aac, mp3, opus）
-b:a - 音频比特率（例如，128k, 192k）
-ar - 采样率（44100, 48000）

ImageMagick 几何尺寸

800x600 - 适应（保持宽高比）
800x600! - 强制精确尺寸
800x600^ - 填充（可能裁剪）
800x - 仅宽度
x600 - 仅高度
50% - 缩放百分比

FFmpeg "Unknown encoder"

# 检查可用编码器
ffmpeg -encoders | grep h264

# 安装编解码器库
sudo apt-get install libx264-dev libx265-dev

ImageMagick "not authorized"

# 编辑策略文件
sudo nano /etc/ImageMagick-7/policy.xml
# 将 <policy domain="coder" rights="none" pattern="PDF" />
# 改为 <policy domain="coder" rights="read|write" pattern="PDF" />

# 限制内存使用
ffmpeg -threads 4 input.mp4 output.mp4
magick -limit memory 2GB -limit map 4GB input.jpg output.jpg

2026 年 1 月 22 日

🇺🇸English

Media Processing Skill

Process video, audio, and images using FFmpeg and ImageMagick command-line tools for conversion, optimization, streaming, and manipulation tasks.

When to Use This Skill

Use when:

Converting media formats (video, audio, images)
Encoding video with codecs (H.264, H.265, VP9, AV1)
Processing images (resize, crop, effects, watermarks)
Extracting audio from video
Creating streaming manifests (HLS/DASH)
Generating thumbnails and previews
Batch processing media files
Optimizing file sizes and quality
Applying filters and effects
Creating composite images or videos

Tool Selection Guide

FFmpeg: Video/Audio Processing

Use FFmpeg for:

Video encoding, conversion, transcoding
Audio extraction, conversion, mixing
Live streaming (RTMP, HLS, DASH)
Video filters (scale, crop, rotate, overlay)
Hardware-accelerated encoding
Media file inspection (ffprobe)
Frame extraction, concatenation
Codec selection and optimization

ImageMagick: Image Processing

Use ImageMagick for:

Image format conversion (PNG, JPEG, WebP, GIF)
Resizing, cropping, transformations
Batch image processing (mogrify)
Visual effects (blur, sharpen, sepia)
Text overlays and watermarks
Image composition and montages
Color adjustments, filters
Thumbnail generation

Decision Matrix

Task	Tool	Why
Video encoding	FFmpeg	Native video codec support
Audio extraction	FFmpeg	Direct stream manipulation
Image resize	ImageMagick	Optimized for still images
Batch images	ImageMagick	mogrify for in-place edits
Video thumbnails	FFmpeg	Frame extraction built-in
GIF creation	FFmpeg or ImageMagick	FFmpeg for video source, ImageMagick for images
Streaming	FFmpeg	Live streaming protocols
Image effects	ImageMagick	Rich filter library

Installation

macOS

brew install ffmpeg imagemagick

Ubuntu/Debian

sudo apt-get install ffmpeg imagemagick

Windows

# Using winget
winget install ffmpeg
winget install ImageMagick.ImageMagick

# Or download binaries
# FFmpeg: https://ffmpeg.org/download.html
# ImageMagick: https://imagemagick.org/script/download.php

Verify Installation

ffmpeg -version
ffprobe -version
magick -version
# or
convert -version

Quick Start Examples

Video Conversion

# Convert format (copy streams, fast)
ffmpeg -i input.mkv -c copy output.mp4

# Re-encode with H.264
ffmpeg -i input.avi -c:v libx264 -crf 22 -c:a aac output.mp4

# Resize video to 720p
ffmpeg -i input.mp4 -vf scale=-1:720 -c:a copy output.mp4

Audio Extraction

# Extract audio (no re-encoding)
ffmpeg -i video.mp4 -vn -c:a copy audio.m4a

# Convert to MP3
ffmpeg -i video.mp4 -vn -q:a 0 audio.mp3

Image Processing

# Convert format
magick input.png output.jpg

# Resize maintaining aspect ratio
magick input.jpg -resize 800x600 output.jpg

# Create square thumbnail
magick input.jpg -resize 200x200^ -gravity center -extent 200x200 thumb.jpg

Batch Image Resize

# Resize all JPEGs to 800px width
mogrify -resize 800x -quality 85 *.jpg

# Output to separate directory
mogrify -path ./output -resize 800x600 *.jpg

Video Thumbnail

# Extract frame at 5 seconds
ffmpeg -ss 00:00:05 -i video.mp4 -vframes 1 -vf scale=320:-1 thumb.jpg

HLS Streaming

# Generate HLS playlist
ffmpeg -i input.mp4 \
  -c:v libx264 -preset fast -crf 22 -g 48 \
  -c:a aac -b:a 128k \
  -f hls -hls_time 6 -hls_playlist_type vod \
  playlist.m3u8

Image Watermark

# Add watermark to corner
magick input.jpg watermark.png -gravity southeast \
  -geometry +10+10 -composite output.jpg

Common Workflows

Optimize Video for Web

# H.264 with good compression
ffmpeg -i input.mp4 \
  -c:v libx264 -preset slow -crf 23 \
  -c:a aac -b:a 128k \
  -movflags +faststart \
  output.mp4

Create Responsive Images

# Generate multiple sizes
for size in 320 640 1024 1920; do
  magick input.jpg -resize ${size}x -quality 85 "output-${size}w.jpg"
done

Extract Video Segment

# From 1:30 to 3:00 (re-encode for precision)
ffmpeg -i input.mp4 -ss 00:01:30 -to 00:03:00 \
  -c:v libx264 -c:a aac output.mp4

Batch Image Optimization

# Convert PNG to optimized JPEG
mogrify -path ./optimized -format jpg -quality 85 -strip *.png

Video GIF Creation

# High quality GIF with palette
ffmpeg -i input.mp4 -vf "fps=15,scale=640:-1:flags=lanczos,split[s0][s1];[s0]palettegen[p];[s1][p]paletteuse" output.gif

Image Blur Effect

# Gaussian blur
magick input.jpg -gaussian-blur 0x8 output.jpg

Advanced Techniques

Multi-Pass Video Encoding

# Pass 1 (analysis)
ffmpeg -y -i input.mkv -c:v libx264 -b:v 2600k -pass 1 -an -f null /dev/null

# Pass 2 (encoding)
ffmpeg -i input.mkv -c:v libx264 -b:v 2600k -pass 2 -c:a aac output.mp4

Hardware-Accelerated Encoding

# NVIDIA NVENC
ffmpeg -hwaccel cuda -i input.mp4 -c:v h264_nvenc -preset fast -crf 22 output.mp4

# Intel QuickSync
ffmpeg -hwaccel qsv -c:v h264_qsv -i input.mp4 -c:v h264_qsv output.mp4

Complex Image Pipeline

# Resize, crop, border, adjust
magick input.jpg \
  -resize 1000x1000^ \
  -gravity center \
  -crop 1000x1000+0+0 +repage \
  -bordercolor black -border 5x5 \
  -brightness-contrast 5x10 \
  -quality 90 \
  output.jpg

Video Filter Chains

# Scale, denoise, watermark
ffmpeg -i video.mp4 -i logo.png \
  -filter_complex "[0:v]scale=1280:720,hqdn3d[v];[v][1:v]overlay=10:10" \
  -c:a copy output.mp4

Animated GIF from Images

# Create with delay
magick -delay 100 -loop 0 frame*.png animated.gif

# Optimize size
magick animated.gif -fuzz 5% -layers Optimize optimized.gif

Media Analysis

Inspect Video Properties

# Detailed JSON output
ffprobe -v quiet -print_format json -show_format -show_streams input.mp4

# Get resolution
ffprobe -v error -select_streams v:0 \
  -show_entries stream=width,height \
  -of csv=s=x:p=0 input.mp4

Image Information

# Basic info
identify image.jpg

# Detailed format
identify -verbose image.jpg

# Custom format
identify -format "%f: %wx%h %b\n" image.jpg

Performance Tips

Use CRF for quality control - Better than bitrate for video
Copy streams when possible - Avoid re-encoding with -c copy
Hardware acceleration - GPU encoding 5-10x faster
Appropriate presets - Balance speed vs compression
Batch with mogrify - In-place image processing
Strip metadata - Reduce file size with -strip
Progressive JPEG - Better web loading with -interlace Plane
Limit memory - Prevent crashes on large batches
Test on samples - Verify settings before batch
Parallel processing - Use GNU Parallel for multiple files

Reference Documentation

Detailed guides in references/:

ffmpeg-encoding.md - Video/audio codecs, quality optimization, hardware acceleration
ffmpeg-streaming.md - HLS/DASH, live streaming, adaptive bitrate
ffmpeg-filters.md - Video/audio filters, complex filtergraphs
imagemagick-editing.md - Format conversion, effects, transformations
imagemagick-batch.md - Batch processing, mogrify, parallel operations
format-compatibility.md - Format support, codec recommendations

Common Parameters

FFmpeg Video

-c:v - Video codec (libx264, libx265, libvpx-vp9)
-crf - Quality (0-51, lower=better, 23=default)
-preset - Speed/compression (ultrafast to veryslow)
-b:v - Video bitrate (e.g., 2M, 2500k)
-vf - Video filters

FFmpeg Audio

-c:a - Audio codec (aac, mp3, opus)
-b:a - Audio bitrate (e.g., 128k, 192k)
-ar - Sample rate (44100, 48000)

ImageMagick Geometry

800x600 - Fit within (maintains aspect)
800x600! - Force exact size
800x600^ - Fill (may crop)
800x - Width only
x600 - Height only
50% - Scale percentage

Troubleshooting

FFmpeg "Unknown encoder"

# Check available encoders
ffmpeg -encoders | grep h264

# Install codec libraries
sudo apt-get install libx264-dev libx265-dev

ImageMagick "not authorized"

# Edit policy file
sudo nano /etc/ImageMagick-7/policy.xml
# Change <policy domain="coder" rights="none" pattern="PDF" />
# to <policy domain="coder" rights="read|write" pattern="PDF" />

Memory errors

# Limit memory usage
ffmpeg -threads 4 input.mp4 output.mp4
magick -limit memory 2GB -limit map 4GB input.jpg output.jpg

Resources

FFmpeg: https://ffmpeg.org/documentation.html
FFmpeg Wiki: https://trac.ffmpeg.org/
ImageMagick: https://imagemagick.org/
ImageMagick Usage: https://imagemagick.org/Usage/

Weekly Installs

286

Repository

mrgoonie/claude…t-skills

GitHub Stars

1.9K

First Seen

Jan 22, 2026

Security Audits

Gen Agent Trust HubPass SocketPass SnykWarn

Installed on

opencode234

gemini-cli219

claude-code218

codex216

cursor199

github-copilot185

Skills CLI 使用指南：AI Agent 技能包管理器安装与管理教程

27,400 周安装

FFmpeg与ImageMagick媒体处理指南：视频音频图像转换、优化与流媒体

🇨🇳中文介绍

媒体处理技能

何时使用此技能

工具选择指南

FFmpeg：视频/音频处理

ImageMagick：图像处理

决策矩阵

相关 Skills

安装

macOS

Ubuntu/Debian

Windows

验证安装

快速入门示例

视频转换

音频提取

图像处理

批量图像调整大小

视频缩略图

HLS 流媒体

图像水印

常见工作流程

为 Web 优化视频

创建响应式图像

提取视频片段

批量图像优化

视频 GIF 创建

图像模糊效果

高级技巧

多遍视频编码

硬件加速编码

复杂图像处理流程

视频滤镜链

从图像创建动画 GIF

媒体分析

检查视频属性

图像信息

性能提示

参考文档

常用参数

FFmpeg 视频

FFmpeg 音频

ImageMagick 几何尺寸

故障排除

资源

🇺🇸English

Media Processing Skill

When to Use This Skill

Tool Selection Guide

FFmpeg: Video/Audio Processing

ImageMagick: Image Processing

Decision Matrix

Installation

macOS

Ubuntu/Debian

Windows

Verify Installation

Quick Start Examples

Video Conversion

Audio Extraction

Image Processing

Batch Image Resize

Video Thumbnail

HLS Streaming

Image Watermark

Common Workflows

Optimize Video for Web

Create Responsive Images

Extract Video Segment

Batch Image Optimization

Video GIF Creation

Image Blur Effect

Advanced Techniques

Multi-Pass Video Encoding

Hardware-Accelerated Encoding

Complex Image Pipeline

Video Filter Chains

Animated GIF from Images

Media Analysis