init commit

BATCH_GUIDE.md

@@ -0,0 +1,125 @@
+# 📋 Руководство по пакетной загрузке 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 стратегии
+# Просто дождитесь повторных попыток
+```