125 lines
4.6 KiB
Markdown
125 lines
4.6 KiB
Markdown
# 📋 Руководство по пакетной загрузке 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 стратегии
|
||
# Просто дождитесь повторных попыток
|
||
``` |