Repolode
kajisho5

kajisho5/ffmpeg-skill

Agent Skill и MCP-сервер с 42 локальными инструментами FFmpeg для монтажа видео и аудио в coding-агентах вроде Claude Code, Cursor и Codex.

Open source альтернатива:DescriptCapCut

Звёзды
2,021
Форки
165
Открытые issues
4
Последний коммит
позавчера

Что это?

ffmpeg-skill позволяет coding-агенту редактировать видео- и аудиофайлы с помощью структурированных Python-скриптов, которые локально управляют ffmpeg и ffprobe. 42 инструмента умеют обрезать и склеивать клипы, удалять тишину, подгонять видео под заданную длительность или соотношение сторон, встраивать субтитры, накладывать графику, конвертировать HDR в SDR, нормализовать громкость, синхронизировать записи и экспортировать видео с настройками для платформ вроде TikTok, Reels, YouTube и X.

Каждый инструмент принимает типизированные аргументы вместо необработанных строк фильтров, поддерживает вывод в режимах --dry-run и --json и выполняет проверку результата. Машиночитаемый контракт описывает входные и выходные данные каждого инструмента; те же инструменты доступны через MCP. Обработка выполняется офлайн, без API-ключей и с использованием только стандартной библиотеки Python, однако для работы нужно установить ffmpeg и python3.

Проект предназначен для разработчиков, которые хотят поручить агенту рутинный монтаж локальных видеоматериалов без загрузки в облачный сервис и хотят, чтобы агент проверял результат перед тем, как сообщить о завершении работы.

Ключевые возможности

  • 01Обрезка и склейка клипов, а также удаление тишины с копированием потоков без потерь, где это возможно.
  • 02Подгонка видео под заданную длительность и соотношение сторон, включая кадрирование до 9:16 и заполнение размытым фоном.
  • 03Встраивание субтитров с таймингом в стиле караоке и переносом строк с учётом безопасных зон платформ.
  • 04Нормализация громкости до целевых значений EBU R128 и конвертация видео HDR в SDR.
  • 05Доступ ко всем инструментам через MCP; контракт генерируется на основе определений argparse.

Сценарии использования

  • Поручить агенту превратить длинную запись в вертикальный 60-секундный клип для Reels или TikTok.
  • Пакетно нормализовать громкость и экспортировать подкасты или материалы для соцсетей из папки.
  • Добавить к видео встроенные субтитры и графические наложения, не загружая его в облачный редактор.
  • Создать скриптовый видеопайплайн, который проверяет каждый результат с помощью ffprobe, прежде чем передать его дальше.

Быстрый старт

  1. 1

    Установить skill для Claude Code

    npx ffmpeg-skill
  2. 2

    Проверить наличие ffmpeg, ffprobe и необходимых компонентов

    npx ffmpeg-skill doctor
  3. 3

    Прочитать машиночитаемый контракт инструмента

    npx ffmpeg-skill contract --json | head -40

Что важно знать

  • ffmpeg и python3 должны быть заранее установлены и доступны в PATH.
  • Копии, установленные программой установки, не обновляются автоматически; чтобы обновить их, повторно выполните команду установки.
  • Некоторым инструментам, например caption.py, нужны компоненты FFmpeg, такие как фильтр subtitles, которого может не быть в базовой сборке Homebrew.

Темы

Частые вопросы

Что такое ffmpeg-skill?
Agent Skill и MCP-сервер с 42 локальными инструментами FFmpeg для монтажа видео и аудио в coding-агентах вроде Claude Code, Cursor и Codex. ffmpeg-skill позволяет coding-агенту редактировать видео- и аудиофайлы с помощью структурированных Python-скриптов, которые локально управляют ffmpeg и ffprobe. 42 инструмента умеют обрезать и склеивать клипы, удалять тишину, подгонять видео под заданную длительность или соотношение сторон, встраивать субтитры, накладывать графику, конвертировать HDR в SDR, нормализовать громкость, синхронизировать записи и экспортировать видео с настройками для платформ вроде TikTok, Reels, YouTube и X.
ffmpeg-skill можно использовать бесплатно? Какая у него лицензия?
ffmpeg-skill распространяется с открытым исходным кодом под лицензией MIT. Перед использованием в коммерческих продуктах проверьте условия лицензии.
ffmpeg-skill всё ещё поддерживается?
Активно поддерживается. Последний коммит в ffmpeg-skill — 17 окт. 2026 г..
Для чего можно использовать ffmpeg-skill?
Поручить агенту превратить длинную запись в вертикальный 60-секундный клип для Reels или TikTok. Пакетно нормализовать громкость и экспортировать подкасты или материалы для соцсетей из папки. Добавить к видео встроенные субтитры и графические наложения, не загружая его в облачный редактор. Создать скриптовый видеопайплайн, который проверяет каждый результат с помощью ffprobe, прежде чем передать его дальше.
Как установить ffmpeg-skill?
Установить skill для Claude Code: npx ffmpeg-skill Проверить наличие ffmpeg, ffprobe и необходимых компонентов: npx ffmpeg-skill doctor Прочитать машиночитаемый контракт инструмента: npx ffmpeg-skill contract --json | head -40
Где скачать ffmpeg-skill?
Исходный код и инструкции по установке — на GitHub: https://github.com/kajisho5/ffmpeg-skill

Описание создано ИИ на основе README проекта. Статистика GitHub обновляется ежедневно.

Похожие проекты