sync

README.md

@@ -2,17 +2,17 @@
 
 CLI инструмент для конвертации видео в формат DASH с поддержкой GPU ускорения (NVENC), адаптивным стримингом и автоматической генерацией превью.
 
-**Возможности:** ⚡ NVENC ускорение • 🎯 Множественные битрейты (1080p/720p/480p/360p) • 🖼️ Thumbnail спрайты • 📊 Прогресс в реальном времени
+**Возможности:** ⚡ NVENC ускорение • 🎯 Множественные битрейты • 🖼️ Thumbnail спрайты • 📸 Генерация постера • 📊 Прогресс в реальном времени
 
 ## Быстрый старт
 
 ```bash
 # Использование через npx (без установки)
-npx @grom13/dvc-cli video.mp4 ./output
+npx @grom13/dvc-cli video.mp4
 
 # Или глобальная установка
 npm install -g @grom13/dvc-cli
-dvc video.mp4 ./output
+dvc video.mp4
 ```
 
 **Системные требования:**
@@ -27,26 +27,74 @@ sudo apt install ffmpeg gpac
 brew install ffmpeg gpac
 ```
 
-**Результат:** В папке `./output/video/` будет создан `manifest.mpd` и видео сегменты для разных качеств.
+**Результат:** В текущей директории будет создана папка `video/` с файлами `manifest.mpd`, видео сегментами, постером и превью спрайтами.
 
 ## Параметры CLI
 
 ```bash
-npx @grom13/dvc-cli <input-video> [output-dir]
-# или после установки:
-dvc <input-video> [output-dir]
+dvc <input-video> [output-dir] [-r resolutions] [-p poster-timecode]
 ```
 
+### Основные параметры
+
 | Параметр | Описание | По умолчанию | Обязательный |
 |----------|----------|--------------|--------------|
 | `input-video` | Путь к входному видео файлу | - | ✅ |
-| `output-dir` | Директория для выходных файлов | `./output` | ❌ |
+| `output-dir` | Директория для выходных файлов | `.` (текущая папка) | ❌ |
 
-**Автоматические настройки:**
-- Длительность сегментов: 2 секунды
-- NVENC: автоопределение (GPU если доступен, иначе CPU)
-- Профили качества: автоматический выбор на основе разрешения исходного видео
-- Превью спрайты: генерируются автоматически (160x90px, каждые 10 сек)
-- Параллельное кодирование: включено
+### Опциональные ключи
+
+| Ключ | Описание | Формат | Пример |
+|------|----------|--------|--------|
+| `-r, --resolutions` | Выбор профилей качества | `360`, `720@60`, `1080-60` | `-r 720,1080,1440@60` |
+| `-p, --poster` | Таймкод для постера | `HH:MM:SS` или секунды | `-p 00:00:05` или `-p 10` |
+
+### Примеры использования
+
+```bash
+# Базовая конвертация (результат в текущей папке)
+dvc video.mp4
+
+# Указать выходную директорию
+dvc video.mp4 ./output
+
+# Только выбранные разрешения
+dvc video.mp4 -r 720,1080,1440
+
+# Высокий FPS для игровых стримов
+dvc video.mp4 -r 720@60,1080@60
+
+# Постер с 5-й секунды
+dvc video.mp4 -p 5
+
+# Постер в формате времени
+dvc video.mp4 -p 00:01:30
+
+# Комбинация параметров
+dvc video.mp4 ./output -r 720,1080@60,1440@60 -p 00:00:10
+```
+
+### Поддерживаемые разрешения
+
+| Разрешение | Стандартное название | 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 сек)
+- **Постер:** извлекается с 1-й секунды видео (можно изменить через `-p`)
+- **Параллельное кодирование:** включено
 
 **Требования:** Node.js ≥18.0.0, FFmpeg, MP4Box (gpac), опционально NVIDIA GPU для ускорения