# Конвертация видео без установки FFmpeg на компьютер

Нужно превратить большой MOV-файл в компактный MP4 или извлечь из него звук? Запустите временную Linux-машину с FFmpeg специально под эту задачу, а затем удалите.

* **Скачайте:** [набор инструментов и тестовые файлы](/example-assets/file-toolbox.zip).
* **Вам понадобится:** Python 3.10+ на вашем компьютере. Устанавливать FFmpeg или Docker не нужно.

## Запуск[​](#run "Прямая ссылка на Запуск")

Распакуйте архив `file-toolbox`. В аккаунте должна быть квота на создание хотя бы одной песочницы (2 vCPU, 2048 МиБ RAM, 4096 МиБ диска) и права на шаблон `base`. Шаблону нужен доступ к apt-репозиториям и sudo без пароля. Платформа установит инструменты во время запуска.

Для тестирования возьмите непустой локальный файл размером до **64 МиБ**. В вашей установке платформы лимит загрузки может быть ниже. Скрипт примера ограничивает скачивание каждого файла 256 МиБ и ждет установку и конвертацию до 20 минут.

Настройка доступа к API (один раз)

Укажите HTTPS-адрес платформы и персональный токен с правами *Полные*:

```
export JUSTRUN_API="https://your-just-run-host"
read -rsp 'just-run PAT: ' JUSTRUN_PAT; printf '\n'
export JUSTRUN_PAT
```

```
cd file-toolbox
python3 run.py video sample.mov
```

Замените `sample.mov` на путь к вашему файлу. Если в пути есть пробелы, возьмите его в кавычки. Исходный файл не изменится. Скрипт загрузит файл и инструкции в песочницу, установит FFmpeg, сконвертирует видео, скачает результат и удалит машину. Публичные порты не нужны, персональный токен остается на вашем компьютере.

## Что получится[​](#result "Прямая ссылка на Что получится")

Откройте **`video-result/video.mp4`**. Файл `result.json` содержит кодеки, длительность, размеры кадра и файлов, а также версию FFmpeg. В `job.log` лежит вывод инструментов.

| Вход                           | Выход                                         |
| ------------------------------ | --------------------------------------------- |
| Первая видеодорожка            | H.264, yuv420p, до 1280 × 720, четные размеры |
| Первая аудиодорожка, если есть | AAC, стерео                                   |
| Контейнер                      | MP4 с индексом в начале файла (`faststart`)   |

Тестовый файл на три секунды после конвертации уменьшился с **1,96 Мбайт до 384 Кбайт**. [Откройте полученный MP4](/example-assets/toolbox-sample.mp4). В нем движущаяся картинка и звук 440 Гц. Размер вашего файла может измениться иначе.

Проверьте ориентацию, звук и длительность в новом файле. Разрешение маленьких видео может увеличиться, а качество — снизиться из-за сжатия. Скрипт оставляет только первые дорожки. Он удаляет субтитры, остальные дорожки, главы и метаданные. Конвертация не сохраняет точность цветов HDR.

## Только звук[​](#audio-only "Прямая ссылка на Только звук")

```
python3 run.py audio sample.mov
```

Откройте **`audio-result/audio.mp3`**. Скрипт создает новую песочницу и кодирует первую аудиодорожку в MP3. Если в видео нет звука, скрипт выдаст ошибку и запишет причину в лог. [Послушайте тестовый результат](/example-assets/toolbox-sample.mp3).

## Как адаптировать[​](#customise "Прямая ссылка на Как адаптировать")

Логика обработки лежит в `job.py`, а работа с платформой — в `run.py`. Скрипт обрабатывает видео внутри песочницы так:

```
ffmpeg -i input.mov -map 0:v:0 -map '0:a:0?' \
  -vf 'scale=1280:720:force_original_aspect_ratio=decrease:force_divisible_by=2' \
  -c:v libx264 -preset veryfast -crf 26 -pix_fmt yuv420p \
  -c:a aac -b:a 128k -ac 2 -movflags +faststart video.mp4
```

Этот фрагмент отвечает за конвертацию. Скрипт также настраивает протоколы, метаданные и таймауты, а затем проверяет результат через ffprobe. Чтобы изменить параметры, изучите [документацию FFmpeg](https://ffmpeg.org/ffmpeg.html).

Второй запуск того же рецепта завершится ошибкой: папка `video-result` уже существует. Для новой конвертации добавьте к команде флаг `--output`:

```
python3 run.py video sample.mov --output another-video
```

## Удаление ресурсов[​](#cleanup "Прямая ссылка на Удаление ресурсов")

И после успеха, и после ошибки скрипт пытается удалить песочницу. Если процесс прервался, сохраните `.file-toolbox-state.json` и повторите:

```
python3 run.py --cleanup
```

Если API недоступен, позднее найдите выведенный ID в разделе *Песочницы*. Удаление песочницы оставляет исходник и скачанные файлы локально. Оборванное скачивание может оставить `.part`-файл; возобновление загрузки не обещается. При ошибке конвертации смотрите `job.log`, если он скачался.

**Дальше:** [превратите DOCX в PDF через LibreOffice](/examples/convert-docx-to-pdf.md).
