create-vod/README_RU.md

# Create VOD 🎬

🇺🇸 English README: https://gromlab.ru/vod/create-vod/src/branch/master/README.md

CLI инструмент для конвертации видео в форматы DASH и HLS с поддержкой аппаратного ускорения (NVENC / Intel QSV / AMD AMF / VAAPI), адаптивным стримингом и автоматической генерацией превью.

**Возможности:**
- ⚡ Аппаратное ускорение: NVENC / Intel QSV / AMD AMF / VAAPI (автовыбор по приоритету)
- 🎯 Форматы: DASH и HLS (оба из одних сегментов)
- 📊 Профили качества: множественные битрейты и FPS, авто или кастом
- 🖼️ Превью: thumbnail спрайты + VTT, постер с первого кадра
- ⏱️ Прогресс: CLI прогресс-бары по профилям и общему этапу

## Install
Для корректной работы CLI требуется установленые в системе FFmpeg и MP4Box. 
```bash
# Arch Linux
sudo pacman -S ffmpeg gpac

# Ubuntu/Debian
sudo apt install ffmpeg gpac

# macOS
brew install ffmpeg gpac
```

## Быстрый старт
Перед запуском убедитесь, что в системе установлены `FFmpeg` и `MP4Box` (см. Install).
```bash
npx @gromlab/create-vod video.mp4
```

**Результат:** В текущей директории появится структура выходных файлов:
```
video/
├── manifest.mpd       # DASH манифест
├── master.m3u8        # HLS мастер-плейлист
├── poster.jpg         # Постер с указанного таймкода
├── thumbnails.jpg     # Спрайт превью
├── thumbnails.vtt     # Таймкоды превью
├── audio/             # Аудиосегменты (init + m4s)
├── 1080p/             # Сегменты H.264 1080p
├── 720p/              # Сегменты H.264 720p
├── 480p/              # Сегменты H.264 480p
├── 360p/              # Сегменты H.264 360p
├── 1080p-av1/         # Сегменты AV1 1080p (если выбран av1)
└── ...                # Остальные профили/кодеки по схеме {profile}-{codec}
```

## Параметры CLI

```bash
create-vod <input-video> [output-dir] [-r resolutions] [-c codec] [-p poster-timecode] [-e encoder] [-d decoder] [-m]
```

### Основные параметры

| Параметр | Описание | По умолчанию | Обязательный |
|----------|----------|--------------|--------------|
| `input-video` | Путь к входному видео файлу | - | ✅ |
| `output-dir` | Директория для выходных файлов | `.` (текущая папка) | ❌ |

### Опциональные ключи

| Ключ | Описание | Значения / формат | По умолчанию | Пример |
|------|----------|-------------------|--------------|--------|
| `-r, --resolutions` | Выбор профилей качества | `360`, `720@60`, `1080-60` | авто | `-r 720,1080,1440@60` |
| `-c, --codec` | Видео кодек(и) | `h264`, `av1` (через пробел или запятую) | `h264` | `-c h264,av1` |
| `-p, --poster` | Таймкод для постера | `HH:MM:SS` или секунды | `00:00:00` | `-p 00:00:05` или `-p 10` |
| `-e, --encoder` | Видео энкодер | `auto`, `nvenc`, `qsv`, `amf`, `vaapi`, `videotoolbox`, `v4l2`, `cpu` | `auto` | `-e nvenc` |
| `-d, --decoder` | Видео декодер (hwaccel) | `auto`, `nvenc`, `qsv`, `vaapi`, `videotoolbox`, `v4l2`, `cpu` | `auto` | `-d cpu` |
| `-m, --muted` | Отключить аудио дорожку в выходных файлах | `flag` | `off` | `-m` |

### Примеры использования

```bash
# Базовая конвертация (DASH + HLS, авто кодек, автопрофили)
npx @gromlab/create-vod video.mp4

# Указать выходную директорию
npx @gromlab/create-vod video.mp4 ./output

# Только выбранные разрешения
npx @gromlab/create-vod video.mp4 -r 720,1080,1440

# Высокий FPS для игровых стримов
npx @gromlab/create-vod video.mp4 -r 720@60,1080@60

# Постер с 5-й секунды
npx @gromlab/create-vod video.mp4 -p 5

# Комбинация параметров
npx @gromlab/create-vod video.mp4 ./output -r 720,1080@60,1440@60 -p 00:00:10

# Без звука
npx @gromlab/create-vod video.mp4 -m
```

### Поддерживаемые разрешения

| Разрешение | Стандартное название | FPS варианты |
|------------|---------------------|--------------|
| `360` | 360p (640×360) | 30, 60, 90, 120 |
| `480` | 480p (854×480) | 30, 60, 90, 120 |
| `720` | 720p HD (1280×720) | 30, 60, 90, 120 |
| `1080` | 1080p Full HD (1920×1080) | 30, 60, 90, 120 |
| `1440` | 1440p 2K (2560×1440) | 30, 60, 90, 120 |
| `2160` | 2160p 4K (3840×2160) | 30, 60, 90, 120 |

**Примечание:** Высокие FPS (60/90/120) создаются автоматически только если исходное видео поддерживает соответствующий FPS.

## Автоматические настройки

- **Длительность сегментов:** 2 секунды
- **NVENC:** автоопределение (GPU если доступен, иначе CPU)
- **Профили качества:** автоматический выбор на основе разрешения исходного видео
- **Битрейт:** динамический расчет по формуле BPP (Bits Per Pixel)
- **Превью спрайты:** генерируются автоматически (160×90px, интервал 1 сек)
- **Постер:** извлекается с начала видео (кадр 0:00:00, можно изменить через `-p`)
- **Параллельное кодирование:** включено

**Требования:** Node.js ≥18.0.0, FFmpeg, MP4Box (gpac), опционально NVIDIA GPU для ускорения