mcpField
M
media-transcoding

media-transcoding

github.com/bobmatnyc创意与媒体78339 次安装15 周前更新
代码仓库

关于 media-transcoding

使用 `hf-videos` 仓库中的 FFmpeg 预设和脚本转换视频的技能，支持单文件及批量处理，并保存备份和日志以供检查与排错。

主要功能

  1. 01按视频质量预设转换
  2. 02批量处理文件
  3. 03检查元数据和进度
  4. 04控制是否覆盖文件
  5. 05保留备份和转换日志

适用场景

  1. 01准备适合网页流媒体的视频
  2. 02生成适合移动设备的视频
  3. 03生成体积较小的视频
  4. 04按原始分辨率归档视频

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/bobmatnyc/claude-mpm-skills --skill media-transcoding

安装后在 Claude Code 中输入/media-transcoding确认已加载。

附带文件metadata.json

详细介绍

媒体转码（FFmpeg）

概述

使用 FFmpeg 预设，将视频输出标准化，以便用于 Web 流媒体、移动设备交付或存档。你的 hf-videos 仓库已包含一个简单的 Bash 脚本，以及一个功能更完善的 Python 脚本，支持预设、备份和日志记录。

快速开始（hf-videos）

./ffmpeg_convert.sh check
./ffmpeg_convert.sh web_standard "My Video.mp4"
./ffmpeg_convert.sh batch_web_standard

输出写入 converted/，备份存放在 backup/，日志写入 conversion.log。

预设摘要（hf-videos）

  • web_standard：最高 1080p、CRF 23、128k 音频、+faststart
  • web_high：最高 1080p、CRF 20、192k 音频
  • mobile：最高 720p、CRF 25、96k 音频
  • ultra_compact：最高 480p、CRF 28、64k 音频
  • archive：原始分辨率、CRF 18、256k 音频

所有预设均使用 H.264 + AAC，并设置 +faststart，生成适合流媒体播放的 MP4 文件。

批量工作流

  1. 先转换单个文件，以验证输出。
  2. 确认预设后，再运行批量转换。
  3. 检查输出文件大小和播放效果。

批量命令：

./ffmpeg_convert.sh batch_web_standard
./ffmpeg_convert.sh batch_mobile
./ffmpeg_convert.sh batch_ultra_compact

高级脚本（convert_video.py）

需要以下功能时，请使用 convert_video.py：

  • 进度监控
  • 元数据检查
  • 覆盖控制
  • 预设列表和批量自动化
python3 convert_video.py --list-presets
python3 convert_video.py --file "My Video.mp4" --preset web_standard
python3 convert_video.py --preset mobile --overwrite

输出约定

  • 转换后的文件使用 _web_standard 等后缀。
  • 备份保留原始文件名。
  • 日志写入 conversion.log，用于审计和故障排查。

故障排查

  • 缺少 FFmpeg：运行 brew install ffmpeg（macOS），或从 ffmpeg.org 安装。
  • 权限错误：运行 chmod +x ffmpeg_convert.sh。
  • 磁盘空间不足：验证后清理 converted/ 和 backup/。

相关技能

  • toolchains/universal/infrastructure/docker

评论

支持 Markdown