Подготовка видео для Telegram-бота: полное руководство

При работе с Telegram Bot API часто возникают проблемы с отправкой видео: оно может терять пропорции, не воспроизводиться автоматически или иметь слишком большой размер. Правильная подготовка видеофайлов перед отправкой решает 99% этих проблем.

Это руководство покажет, как установить и использовать мощный инструмент FFmpeg на Windows, Ubuntu/Debian и macOS для решения всех этих задач.

Шаг 1: Установка FFmpeg на Windows — «швейцарского ножа» для видео

FFmpeg — это бесплатная программа с открытым исходным кодом, которая умеет делать с аудио и видео практически всё. Мы установим её и настроим для удобной работы.

1. Скачайте сборку FFmpeg. Перейдите на сайт gyan.dev. В разделе “release builds” скачайте архив ffmpeg-release-full.7z. Это полный набор, который нам понадобится.
2. Распакуйте архив. Вам понадобится архиватор, поддерживающий формат .7z, например, 7-Zip. Распакуйте содержимое архива в постоянное место на вашем компьютере, например, в C:\ffmpeg. Внутри этой папки должна появиться папка с версией (например, ffmpeg-6.0-full_build), а внутри неё — папка bin.
3. Добавьте FFmpeg в системную переменную PATH. Это самый важный шаг, который позволит вам вызывать ffmpeg из любой папки в командной строке.Для Windows 10/11:
   1. Нажмите клавишу Win, начните вводить “переменные” и выберите “Изменение системных переменных среды”.
   2. В открывшемся окне “Свойства системы” нажмите кнопку “Переменные среды…”.
   3. В нижнем блоке “Системные переменные” найдите и выделите переменную Path, затем нажмите “Изменить…”.
   4. В новом окне нажмите “Создать” и вставьте полный путь к папке bin внутри вашей папки ffmpeg. Например: C:\ffmpeg\ffmpeg-6.0-full_build\bin
   5. Нажмите “ОК” во всех окнах, чтобы сохранить изменения.
   Для Windows 7:
   1. Нажмите правой кнопкой мыши на “Компьютер” (или “Мой компьютер”) и выберите “Свойства”.
   2. В левой части окна выберите “Дополнительные параметры системы”.
   3. В открывшемся окне “Свойства системы” перейдите на вкладку “Дополнительно” и нажмите кнопку “Переменные среды…”.
   4. В нижнем блоке “Системные переменные” найдите и выделите переменную Path, затем нажмите “Изменить…”.
   5. В поле “Значение переменной” (Variable value) перейдите в самый конец строки. Если строка не заканчивается точкой с запятой (;), добавьте её. Затем вставьте полный путь к папке bin внутри вашей папки ffmpeg. Например: ;C:\ffmpeg\ffmpeg-6.0-full_build\bin
   6. Нажмите “ОК” во всех окнах, чтобы сохранить изменения.
4. Проверьте установку. Откройте новую командную строку (Win + R, введите cmd, нажмите Enter) и выполните команду:ffmpeg -versionЕсли вы видите информацию о версии FFmpeg, значит, всё установлено правильно.

Шаг 2: Установка FFmpeg на Ubuntu/Debian

На дистрибутивах Linux, таких как Ubuntu или Debian, установка FFmpeg значительно проще и обычно не требует ручной настройки переменной PATH, так как пакетный менеджер делает это автоматически.

1. Обновите список пакетов. Откройте терминал (обычно Ctrl+Alt+T) и выполните команду:sudo apt update
2. Установите FFmpeg. После обновления списка пакетов установите FFmpeg:sudo apt install ffmpegВ процессе установки вам может потребоваться ввести пароль пользователя и подтвердить установку, нажав Y и Enter.
3. Проверьте установку. После завершения установки выполните в терминале команду:ffmpeg -versionЕсли вы видите информацию о версии FFmpeg, значит, установка прошла успешно. FFmpeg будет доступен из любой директории.

Шаг 3: Установка FFmpeg на macOS

На macOS FFmpeg также легко устанавливается с помощью популярного пакетного менеджера Homebrew.

1. Установите Homebrew (если еще не установлен). Откройте приложение “Терминал” (можно найти через Spotlight: Cmd + Пробел, введите “Терминал”) и выполните следующую команду:/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"Следуйте инструкциям в терминале. Возможно, потребуется ввести пароль пользователя.
2. Установите FFmpeg. После установки Homebrew выполните команду:brew install ffmpegHomebrew автоматически скачает и установит FFmpeg со всеми необходимыми зависимостями.
3. Проверьте установку. После завершения установки выполните в терминале команду:ffmpeg -versionЕсли вы видите информацию о версии FFmpeg, значит, установка прошла успешно. Возможно, потребуется перезапустить терминал, чтобы изменения вступили в силу. FFmpeg будет доступен из любой директории.

Шаг 4: Готовые «рецепты» команд

Теперь, когда FFmpeg установлен, вы можете использовать эти команды. Прежде чем выполнять команды, вам нужно открыть терминал (командную строку или PowerShell) и перейти в папку, где находится ваше видео.

1. Как открыть терминал в Windows:Универсальный способ (для Windows 7, 10, 11):Самый быстрый и надежный способ — нажать клавиши Win + R, в открывшемся окне “Выполнить” ввести cmd и нажать Enter. Откроется классическая командная строка.Дополнительные способы:
   • Для Windows 10 и 11: Нажмите правой кнопкой мыши на меню “Пуск” (или нажмите Win + X). В появившемся меню выберите “Терминал Windows” или “Windows PowerShell”.
   • Для Windows 7: Откройте меню “Пуск”, в строке поиска введите cmd или “Командная строка” и выберите найденную программу из списка.
2. Перейдите в папку с видео: В открытом терминале используйте команду cd (change directory), чтобы перейти в папку, где находится ваш видеофайл. Например:cd C:\Users\ВашеИмя\Videos\МоиВидеоЗамените путь на актуальный для вашей папки.
3. Выполните команду FFmpeg: Скопируйте нужную команду FFmpeg, замените input.mp4 на имя вашего файла и нажмите Enter.

Задача 1: Видео для автозапуска (эффект GIF) и сжатие

Чтобы видео в Telegram проигрывалось автоматически, как GIF, оно не должно содержать аудиодорожки. Этот метод идеально подходит для создания коротких зацикленных анимаций, так как он не только удаляет звук, но и сжимает видео.

ffmpeg -i input.mp4 -an -c:v libx264 -preset medium -crf 26 output_animation.mp4

• -i input.mp4 — указывает исходный файл.
• -an — (audio no) полностью удаляет аудиодорожку, что необходимо для автозапуска.
• -c:v libx264 — указывает на использование популярного видеокодека H.264 для сжатия.
• -preset medium — хороший баланс между скоростью кодирования и качеством сжатия.
• -crf 26 — устанавливает уровень качества. Для коротких анимаций значения 24-28 обычно являются отличным компромиссом между качеством и размером.
• output_animation.mp4 — имя готового файла.

Задача 2: Исправление пропорций и сжатие видео

Это решение проблемы, когда Telegram “сплющивает” прямоугольное видео в квадрат. Мы заранее уменьшим разрешение до приемлемого, сохранив пропорции.

ffmpeg -i input.mp4 -vf "scale=800:-2" -c:v libx264 -preset medium -crf 24 output_resized.mp4

• -vf "scale=800:-2" — видеофильтр масштабирования. Ширина будет 800px, а высота (-2) будет вычислена автоматически с сохранением пропорций.
• -c:v libx264 — использует популярный и эффективный видеокодек H.264.
• -preset medium — баланс между скоростью кодирования и качеством.
• -crf 24 — уровень качества (Constant Rate Factor). Значения 18-28 — хороший компромисс. Чем меньше число, тем выше качество и размер файла.
• output_resized.mp4 — имя готового файла.

Совет: Если у вас вертикальное видео, используйте "scale=-2:800", чтобы ограничить высоту.

Задача 3: Вырезать фрагмент из видео

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

ffmpeg -i input.mp4 -ss 00:01:30 -to 00:01:45 -c copy output_cut.mp4

• -ss 00:01:30 — (seek start) время начала фрагмента (1 минута, 30 секунд).
• -to 00:01:45 — время окончания фрагмента (1 минута, 45 секунд).
• -c copy — копирует потоки без перекодирования, что делает процесс почти мгновенным.

Задача 4: Комбо — вырезать, сжать и убрать звук

Объединяем предыдущие техники в одну мощную команду.

ffmpeg -i input.mp4 -ss 00:00:10 -to 00:00:20 -vf "scale=800:-2" -an -c:v libx264 -preset medium -crf 25 output_final.mp4

Здесь мы вырезаем 10-секундный фрагмент, масштабируем его до 800px по ширине, удаляем звук и сохраняем с хорошим сжатием.

Совет: Максимальное сжатие (минимальный размер файла)

Если ваша главная цель — получить файл как можно меньшего размера при сохранении приемлемого качества, вы можете использовать самый медленный пресет кодирования. Это может занять очень много времени.

ffmpeg -i input.mp4 -c:v libx264 -preset veryslow -crf 23 output_min_size.mp4

• -preset veryslow — использует самые сложные и медленные алгоритмы для достижения наилучшей эффективности сжатия. Файл будет меньше, чем с пресетом slow или medium при том же значении -crf.
• -crf 23 — стандартное значение качества для кодека libx264. Вы по-прежнему контролируете качество этим параметром, а пресет влияет на то, насколько эффективно будет достигнуто это качество.

Внимание: Использование -preset veryslow может увеличить время кодирования в несколько раз по сравнению с -preset medium. Используйте его, только когда размер файла критически важен.

Заключение

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