# 📋 Руководство по пакетной загрузке YouTube Downloader

## 🎯 Способы пакетной загрузки

### 1. Загрузка из файла со списком URL

Создайте текстовый файл с URL (один на строку):

```bash
# Создать шаблон
python3 utils.py template batch_urls.txt

# Отредактировать файл и добавить URL
nano batch_urls.txt

# Загрузить все URL из файла
python3 main.py --batch batch_urls.txt --audio-only
```

**Пример содержимого файла:**
```
# Мои любимые видео
https://www.youtube.com/watch?v=dQw4w9WgXcQ
https://www.youtube.com/watch?v=VIDEO_ID_2
https://www.youtube.com/watch?v=VIDEO_ID_3

# Плейлист (используйте с --playlist)
https://www.youtube.com/playlist?list=PLAYLIST_ID
```

### 2. Загрузка нескольких URL через командную строку

```bash
python3 main.py --urls URL1 URL2 URL3 --quality 720p
```

## 🛠 Опции для пакетной загрузки

### Основные параметры:
- `--batch FILE` - Файл со списком URL
- `--urls URL1 URL2...` - Несколько URL через пробел
- `--continue-on-error` - Продолжать при ошибках
- `--quality QUALITY` - Качество для всех видео
- `--audio-only` - Только аудио для всех
- `--output DIR` - Папка сохранения

### Примеры команд:

```bash
# Скачать аудио из файла, продолжать при ошибках
python3 main.py --batch my_urls.txt --audio-only --continue-on-error

# Скачать несколько видео в 720p
python3 main.py --urls URL1 URL2 URL3 --quality 720p

# Скачать плейлист из файла  
python3 main.py --batch playlists.txt --playlist

# Показать информацию о первом URL из файла
python3 main.py --batch urls.txt --info

# Сохранить в определенную папку
python3 main.py --batch urls.txt --output /path/to/folder
```

## 📊 Отчеты о загрузке

После пакетной загрузки отображается:
- ✅ Количество успешных загрузок
- ❌ Количество ошибок  
- 📋 Список неудачных URL (до 5 первых)
- 📁 Путь к сохраненным файлам

## 🔧 Make команды для тестирования

```bash
make create-batch-template  # Создать шаблон
make test-batch            # Тест с показом info
make demo-batch            # Демо загрузки аудио
```

## 💡 Советы и рекомендации

### Формат файла со списком URL:
- Один URL на строку
- Строки с `#` - комментарии (игнорируются) 
- Пустые строки игнорируются
- UTF-8 кодировка

### Обработка ошибок:
- По умолчанию остановка на первой ошибке
- `--continue-on-error` - продолжить загрузку других URL
- Подробные сообщения об ошибках в выводе

### Производительность:
- Загрузка по одному URL (последовательно)
- Автоматические задержки между запросами
- Fallback стратегии при блокировках

## ❗ Важные моменты

1. **Лимиты YouTube**: Не злоупотребляйте пакетной загрузкой
2. **Права авторов**: Соблюдайте авторские права
3. **Дисковое пространство**: Контролируйте объем загрузок
4. **Сетевая нагрузка**: Учитывайте трафик интернета

## 🐛 Troubleshooting

**Проблема**: Некоторые URL не загружаются
```bash
# Решение: включить продолжение при ошибках
python3 main.py --batch urls.txt --continue-on-error
```

**Проблема**: Медленная загрузка
```bash  
# Решение: попробовать более низкое качество
python3 main.py --batch urls.txt --quality 480p
```

**Проблема**: Ошибки 403
```bash
# Решение: приложение автоматически применит fallback стратегии
# Просто дождитесь повторных попыток
```