FFmpeg

Проект FFmpeg · лицензия LGPL-2.1-or-later

Режет, склеивает и перекодирует видео и звук. Агенту нужна почти в любой работе с роликами: вытащить звук из записи, уменьшить файл, вырезать отрывок.

macOS · Windows · LinuxНа компьютере, на сервере и в контейнереБесплатно, LGPL-2.1-or-later

Сверили официальные источники 25.09.2026. Не устанавливали и не запускали. Что именно проверяли

Установить агентом ↓

Какую задачу решает

Режет, склеивает и перекодирует видео и звук. Окон у программы нет: агент говорит ей, что сделать, одной командой. На FFmpeg опираются и другие программы: yt-dlp склеивает через неё видео и звук, Whisper через неё читает запись.

  • Вытаскивает звук из видео, например чтобы отдать запись эфира на расшифровку.
  • Уменьшает тяжёлую запись, чтобы её можно было отправить или выложить.
  • Вырезает отрывок по времени и склеивает куски в один ролик.
  • Делает кадры и превью из видео, переводит файлы из формата в формат.

Пример результата

Говоришь агенту

Вытащи звук из efir.mp4 в efir.m4a и скажи, сколько длится запись и сколько весит файл.

Что получится

Рядом с видео появляется efir.m4a только со звуком, агент называет длительность и размер. Само видео остаётся как было.

Паспорт

Кто делает
Проект FFmpeg
Сайт
ffmpeg.org
Исходный код
git.ffmpeg.org/gitweb/ffmpeg.git
Инструкция
ffmpeg.org/download.html
Лицензия
LGPL-2.1-or-later
Версия
9.0.2 на 25.09.2026
Системы
macOS · Windows · Linux
Где работает
На компьютере, на сервере и в контейнере
Цена
Бесплатно
Проверка
Сверили источники 25.09

Установить агентом

Для Claude Code, Codex, Hermes и любого агента с терминалом
Установи программу «FFmpeg». Работай по шагам и после каждого коротко говори, что сделал.

Что это за программа (каталог smyslokod.ru, официальные источники сверены 25.09.2026):
- официальный сайт: https://ffmpeg.org/
- исходный код: https://git.ffmpeg.org/gitweb/ffmpeg.git
- инструкция по установке: https://ffmpeg.org/download.html
- актуальная версия на 25.09.2026: 9.0.2
- лицензия: LGPL-2.1-or-later

Правила:
1. Ничего не устанавливай и не меняй, пока я не скажу «да» на твой план.
2. Ставь только способами из этого промпта. Сторонние сборки, скрипты с форумов и из чужих репозиториев не бери.
3. Мои проекты не трогай: не меняй их файлы, виртуальные окружения и списки зависимостей (package.json, requirements.txt, pyproject.toml).
4. Команды с sudo, правку профиля оболочки (~/.zshrc, ~/.bashrc) и переменной PATH делай только после моего отдельного «да» на каждую.
5. Не проси у меня пароли и ключи и не выводи их. Если нужен пароль администратора, дай команду, я выполню её сам.

Шаги:
0. Определи, где ты работаешь: мой компьютер, сервер или контейнер. Какая система и процессор, какие менеджеры пакетов есть (Homebrew, apt, winget, uv, pipx). Ставить нужно туда, где ты сам запускаешь команды.
   - на компьютере: обычная установка через менеджер пакетов.
   - на сервере: пакет ffmpeg из репозитория дистрибутива, например на Ubuntu или Debian.
   - в контейнере: в образ на Debian или Ubuntu ставится пакетом ffmpeg. В официальном Docker-образе Hermes Agent FFmpeg уже есть по документации образа: сначала проверь командой ffmpeg -version.
1. Проверь, не стоит ли программа уже: ffmpeg -version. Если стоит и запускается, ничего не ставь и переходи к шагу 5.
2. Отдельных зависимостей у программы нет. Проверь свободное место на диске: нужно от 150 МБ (столько весит архив готовой сборки для Linux); через Homebrew и apt добавляются библиотеки, итог менеджер пакетов покажет до установки.
3. Составь план: каким одним способом из списка ниже будешь ставить, что появится на диске и сколько места займёт, что поменяется в системе и как потом удалить. Покажи план и жди моего «да».
   Способы из официальных источников:
   - macOS, Homebrew: brew install ffmpeg
   - Windows, winget: winget install --id Gyan.FFmpeg -e (сборка gyan.dev, на неё ссылается ffmpeg.org)
   - Linux, apt: sudo apt install ffmpeg (Debian и Ubuntu; версия из репозитория дистрибутива обычно старше)
4. Установи по согласованному плану. Если что-то идёт не так, как в плане, остановись и спроси.
5. Проверь результат:
   - ffmpeg -version: программа запускается без ошибки;
   - Сделай трёхсекундный тестовый звук, перекодируй его и посмотри длительность результата. Делай это во временной папке и не трогай мои файлы.
     ffmpeg -hide_banner -f lavfi -i "sine=frequency=440:duration=3" -c:a aac check.m4a
     ffprobe -hide_banner check.m4a
   - если ты работаешь в папке моего проекта, покажи git status: от установки в проекте не должно появиться изменений.
6. Итог одним сообщением: что установлено, какой версии и куда, сколько места заняло, что поменялось в системе и как всё удалить (macOS, Homebrew: brew uninstall ffmpeg; Windows, winget: winget uninstall --id Gyan.FFmpeg -e; Linux, apt: sudo apt remove ffmpeg).

Если на любом шаге ошибка, не чини наугад: покажи текст ошибки и скажи, что, по-твоему, случилось. Частые проблемы: https://smyslokod.ru/cli/ffmpeg#problemy

Промпт собран из официальных инструкций, сверенных 25.09.2026. Агент сначала проверит, что уже стоит, покажет план с местом на диске и способом удаления и без твоего «да» ничего не поставит. Сами мы этот промпт на живой установке ещё не прогоняли.

Как ставят вручную

Способы из официальных источников, у каждого ссылка на первоисточник.

  • macOS · Homebrew · источник

    brew install ffmpeg

  • Windows · winget · источник

    winget install --id Gyan.FFmpeg -e

    сборка gyan.dev, на неё ссылается ffmpeg.org

  • Linux · apt · источник

    sudo apt install ffmpeg

    Debian и Ubuntu; версия из репозитория дистрибутива обычно старше

Как удалить

  • macOS, Homebrew: brew uninstall ffmpeg
  • Windows, winget: winget uninstall --id Gyan.FFmpeg -e
  • Linux, apt: sudo apt remove ffmpeg

Что нужно для работы

Отдельных зависимостей нет.

Системы

  • macOS - homebrew или готовая сборка по ссылке со страницы загрузки ffmpeg.org.
  • Windows - сборки gyan.dev и BtbN по ссылкам с ffmpeg.org, сборка gyan.dev есть в winget.
  • Linux - пакет дистрибутива (Debian, Ubuntu, Fedora) или готовая сборка BtbN.

Где запускать

Ставить нужно туда, где работает агент: на твой компьютер, сервер или в контейнер.

  • На компьютере - обычная установка через менеджер пакетов.
  • На сервере - пакет ffmpeg из репозитория дистрибутива, например на Ubuntu или Debian.
  • В контейнере - в образ на Debian или Ubuntu ставится пакетом ffmpeg. В официальном Docker-образе Hermes Agent FFmpeg уже есть по документации образа: сначала проверь командой ffmpeg -version.

Сколько ресурсов нужно

Место на диске
От 150 МБ (столько весит архив готовой сборки для Linux); через Homebrew и apt добавляются библиотеки, итог менеджер пакетов покажет до установки
Видеокарта
Не нужна: перекодирование идёт на процессоре. Длинное видео в высоком качестве перекодируется минуты и дольше.
Сеть
Только чтобы скачать программу.

Лицензия и платные замены

Лицензия LGPL-2.1-or-later. Часть модулей идёт под GPL-2.0-or-later: если сборка их включает, под GPL оказывается вся сборка. Условия лицензии важны тем, кто распространяет FFmpeg вместе со своим продуктом. Текст лицензии

Цена: Бесплатно

Платные замены

Платной замены, которую стоит брать для работы агента, нет. Монтажные программы по подписке делают то же руками, а FFmpeg агент запускает командами сам.

Бесплатные замены

  • HandBrake - Бесплатная программа с окнами для перекодирования видео. Удобна руками, агенту привычнее FFmpeg.

О чём помнить

  • С флагом -y FFmpeg без вопроса перезаписывает файл с тем же именем. Проси агента сохранять результат в новый файл.
  • Ставь FFmpeg туда, где работает агент. Если агент на сервере, программа на твоём компьютере ему не поможет.

Частые проблемы

ffmpeg: command not found сразу после установки

Терминал ещё не видит новую программу: не обновилась переменная PATH. Открой новое окно терминала. На Windows со скачанной вручную сборкой добавь её папку bin в PATH или поставь через winget.

Unknown encoder 'libx264'

В сборке нет кодировщика H.264: его нет в сборках без модулей GPL. Поставь полную сборку (Homebrew, пакет дистрибутива или вариант gpl у BtbN) или попроси агента взять встроенный кодировщик.

yt-dlp или Whisper пишут, что не нашли ffmpeg

FFmpeg стоит не там, где они запускаются: например, на компьютере, а агент работает на сервере или в контейнере. Поставь FFmpeg туда же, где запускается агент. Промпт установки начинает с проверки, где он работает.

Проверка

Сверили официальные источники 25.09.2026. Не устанавливали и не запускали.

Когда
25.09.2026
Среда
Официальные сайты, репозитории и реестры пакетов, без установки
Объём
Сверили официальные источники, программу не устанавливали
Что именно сделали
  1. ffmpeg.org/download.html: последний стабильный выпуск 9.0.2 от 18.09.2026; проект выпускает только исходный код, готовые сборки - по ссылкам на Debian, Ubuntu, RPM Fusion, BtbN, gyan.dev и evermeet.cx.
  2. ffmpeg.org/legal.html: лицензия LGPL 2.1 или новее, часть модулей под GPL 2 или новее.
  3. gyan.dev: сборки для Windows ставятся через winget, в реестре winget есть Gyan.FFmpeg версии 9.0.2.
  4. Сборка BtbN для Linux (linux64-gpl) - архив около 153 МБ.
  5. Исходный код FFmpeg: текст ошибки при отсутствии кодировщика - Unknown encoder.
ДатаВерсияОбъёмГдеИтог
25.09.20269.0.2источникибез установкиполучилось

«Проверено» ставим, только когда сами поставили программу и прогнали её на задаче. Сверка ссылок и вывод версии так не называются.

Входит в подборки

Программу делают её авторы. Мы сверяем официальные источники и описываем, что ей нужно, но код остаётся чужим. Перед установкой посмотри план агента: что он поставит и что поменяет в системе.