FFmpeg

FFmpeg требуется для любого аудио / видео рабочего процесса:

• Сгенерировать субтитры — декодирование исходного аудио для STT
• Сгенерировать голос — объединение TTS-клипов с таймингом в один файл
• Дубляж — STT → TTS → обратно в видео
• Живой перевод — когда захват системного аудио идёт через parec

Он не встроен — установи его один раз в системе.

Установка

macOSUbuntu / DebianFedora / RHELArch / ManjaroWindows

brew install ffmpeg

sudo apt update && sudo apt install ffmpeg

sudo dnf install ffmpeg

Или для более полной сборки сначала включи RPM Fusion.

sudo pacman -S ffmpeg

Скачай статичную сборку с https://www.gyan.dev/ffmpeg/builds/ (сборки "release essentials" достаточно), распакуй, затем добавь папку bin/ в свой PATH:

1. Нажми Win + R, набери sysdm.cpl, нажми Enter
2. Дополнительно → Переменные среды → Системные переменные → Path → Изменить
3. Создать → вставь абсолютный путь к папке bin FFmpeg
4. OK везде, перезапусти открытые терминалы

Проверка

ffmpeg -version

Ты должен увидеть баннер версии с --enable-libx264 --enable-libvpx в строке конфигурации. Если видишь "command not found", установка не оказалась в PATH.

Pre-flight проверка в приложении

Страницы Голос / Дубляж вызывают shutil.which("ffmpeg") перед началом работы. Если FFmpeg не найден, ты увидишь дружелюбный диалог ошибки со ссылкой обратно сюда, а не наполовину выполненную задачу.

Распространённая ошибка

Ошибка	Значение
FFMPEG_NOT_FOUND	ffmpeg не в PATH в момент, когда страница попыталась его запустить. Установи (выше) и перезапусти приложение.

В MCP-сервере (ait-mcp) та же ошибка переоборачивается в человеко-читаемое сообщение:

«FFmpeg требуется для декодирования этого аудио/видео файла, но не установлен или не в PATH. Установи FFmpeg и попробуй снова.»