# CLI Документация

Adaptive Video Converter предоставляет мощный интерфейс командной строки для конвертации видео в адаптивные форматы DASH и HLS.

## Основной синтаксис

```bash
avc <input-video> [output-dir] [options]
```

## Быстрый старт

Простейший способ использования:

```bash
# Конвертация с настройками по умолчанию
avc video.mp4
```

Это создаст в текущей директории папку с именем видео, содержащую:
- DASH и HLS манифесты
- Сегменты для H.264 и AV1
- Автоматически выбранные профили качества
- Превью-спрайты и постер

## Основные возможности

### 🎯 Автоматическая конфигурация
- Автоопределение GPU (NVENC)
- Автовыбор профилей качества на основе исходного видео
- Динамический расчет битрейтов

### ⚡ GPU-ускорение
- NVIDIA NVENC для H.264 и AV1
- Автоматический фоллбек на CPU если GPU недоступен

### 📊 Адаптивный стриминг
- DASH (современный стандарт)
- HLS (совместимость с Apple)
- Множественные профили качества (360p - 4K)
- Поддержка высоких FPS (60/90/120)

### 🎬 Двойное кодирование
- H.264 для максимальной совместимости
- AV1 для оптимального качества/размера
- Возможность выбрать один кодек

## Системные требования

Перед использованием убедитесь, что установлены:

```bash
# Проверка FFmpeg
ffmpeg -version

# Проверка MP4Box
MP4Box -version
```

**Необходимо:**
- Node.js ≥ 18.0.0
- FFmpeg (с NVENC для GPU)
- MP4Box (gpac)

**Опционально:**
- NVIDIA GPU с поддержкой NVENC

## Структура выходных файлов

```
video/
├── manifest.mpd              # DASH манифест
├── master.m3u8               # HLS мастер-плейлист
├── 720p-h264/                # Сегменты профиля 720p H.264
│   ├── 720p-h264_init.mp4
│   └── 720p-h264_*.m4s
├── 720p-av1/                 # Сегменты профиля 720p AV1
├── 1080p-h264/
├── 1080p-av1/
├── thumbnails.jpg            # Спрайт превью (160×90px)
├── thumbnails.vtt            # WebVTT метки для превью
└── poster.jpg                # Постер из видео (1-я секунда)
```

## Следующие шаги

- [Установка](/cli/installation) — Различные способы установки
- [Использование](/cli/usage) — Базовые сценарии использования
- [Опции и ключи](/cli/options) — Полный справочник параметров
- [Примеры](/cli/examples) — Практические примеры для разных задач