FFmpeg
Проект FFmpeg · лицензия 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
Установить агентом
Установи программу «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
- Среда
- Официальные сайты, репозитории и реестры пакетов, без установки
- Объём
- Сверили официальные источники, программу не устанавливали
- Что именно сделали
- ffmpeg.org/download.html: последний стабильный выпуск 9.0.2 от 18.09.2026; проект выпускает только исходный код, готовые сборки - по ссылкам на Debian, Ubuntu, RPM Fusion, BtbN, gyan.dev и evermeet.cx.
- ffmpeg.org/legal.html: лицензия LGPL 2.1 или новее, часть модулей под GPL 2 или новее.
- gyan.dev: сборки для Windows ставятся через winget, в реестре winget есть Gyan.FFmpeg версии 9.0.2.
- Сборка BtbN для Linux (linux64-gpl) - архив около 153 МБ.
- Исходный код FFmpeg: текст ошибки при отсутствии кодировщика - Unknown encoder.
| Дата | Версия | Объём | Где | Итог |
|---|---|---|---|---|
| 25.09.2026 | 9.0.2 | источники | без установки | получилось |
«Проверено» ставим, только когда сами поставили программу и прогнали её на задаче. Сверка ссылок и вывод версии так не называются.
Входит в подборки
Программу делают её авторы. Мы сверяем официальные источники и описываем, что ей нужно, но код остаётся чужим. Перед установкой посмотри план агента: что он поставит и что поменяет в системе.