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

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

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

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

# Создать шаблон
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 через командную строку

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 - Папка сохранения

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

# Скачать аудио из файла, продолжать при ошибках
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 команды для тестирования

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

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

Формат файла со списком URL:

Один URL на строку
Строки с # - комментарии (игнорируются)
Пустые строки игнорируются
UTF-8 кодировка

Обработка ошибок:

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

Производительность:

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

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

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

🐛 Troubleshooting

Проблема: Некоторые URL не загружаются

# Решение: включить продолжение при ошибках
python3 main.py --batch urls.txt --continue-on-error

Проблема: Медленная загрузка

# Решение: попробовать более низкое качество
python3 main.py --batch urls.txt --quality 480p

Проблема: Ошибки 403

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

4.6 KiB Raw Permalink Blame History Unescape Escape