261 lines
8.6 KiB
Markdown
261 lines
8.6 KiB
Markdown
# YouTube Downloader
|
||
|
||
Мощное приложение для скачивания видео с YouTube с использованием Python и yt-dlp.
|
||
|
||
## 🚀 Возможности
|
||
|
||
- ✅ Скачивание видео в различных разрешениях (360p, 480p, 720p, 1080p, best)
|
||
- ✅ Скачивание только аудио в формате MP3/AAC
|
||
- ✅ Поддержка плейлистов
|
||
- ✅ **Пакетная загрузка из файла со списком URL**
|
||
- ✅ **Загрузка нескольких URL через командную строку**
|
||
- ✅ **Продолжение загрузки при ошибках (--continue-on-error)**
|
||
- ✅ Прогресс-бар загрузки с цветным выводом
|
||
- ✅ Настраиваемая конфигурация
|
||
- ✅ Валидация URL
|
||
- ✅ История загрузок
|
||
- ✅ CLI интерфейс с множеством опций
|
||
- ✅ Поддержка субтитров
|
||
- ✅ Автоматическое исправление ошибок 403/блокировок
|
||
|
||
## 📦 Установка
|
||
|
||
1. Клонируйте репозиторий:
|
||
```bash
|
||
git clone <your-repo-url>
|
||
cd youtube_downloader
|
||
```
|
||
|
||
2. Установите зависимости:
|
||
```bash
|
||
make install-fresh
|
||
# или
|
||
pip3 install -r requirements.txt
|
||
```
|
||
|
||
3. Установите ffmpeg (для конвертации аудио):
|
||
```bash
|
||
make install-ffmpeg
|
||
# или вручную:
|
||
# Ubuntu/Debian: sudo apt install ffmpeg
|
||
# macOS: brew install ffmpeg
|
||
# Windows: скачайте с https://ffmpeg.org/
|
||
```
|
||
|
||
## 🎯 Быстрый старт
|
||
|
||
```bash
|
||
# Настройка конфигурации
|
||
make config
|
||
|
||
# Скачать видео
|
||
python3 main.py https://www.youtube.com/watch?v=VIDEO_ID
|
||
|
||
# Скачать только аудио
|
||
python3 main.py https://www.youtube.com/watch?v=VIDEO_ID --audio-only
|
||
|
||
# Скачать плейлист
|
||
python3 main.py https://www.youtube.com/playlist?list=PLAYLIST_ID --playlist
|
||
|
||
# Пакетная загрузка из файла
|
||
python3 main.py --batch batch_urls.txt --audio-only
|
||
|
||
# Загрузка нескольких URL
|
||
python3 main.py --urls URL1 URL2 URL3 --quality 720p
|
||
```
|
||
|
||
## 📋 Использование CLI
|
||
|
||
### Основные команды:
|
||
```bash
|
||
# Скачать видео в лучшем качестве
|
||
python3 main.py https://www.youtube.com/watch?v=VIDEO_ID
|
||
|
||
# Скачать в определенном качестве
|
||
python3 main.py https://www.youtube.com/watch?v=VIDEO_ID --quality 720p
|
||
|
||
# Скачать только аудио
|
||
python3 main.py https://www.youtube.com/watch?v=VIDEO_ID --audio-only
|
||
|
||
# Указать папку для загрузки
|
||
python3 main.py https://www.youtube.com/watch?v=VIDEO_ID --output downloads/
|
||
|
||
# Скачать плейлист
|
||
python3 main.py https://www.youtube.com/playlist?list=PLAYLIST_ID --playlist
|
||
|
||
# Показать информацию о видео
|
||
python3 main.py https://www.youtube.com/watch?v=VIDEO_ID --info
|
||
|
||
# Показать доступные форматы
|
||
python3 main.py https://www.youtube.com/watch?v=VIDEO_ID --formats
|
||
```
|
||
|
||
### Пакетная загрузка:
|
||
```bash
|
||
# Создать шаблон файла со списком URL
|
||
make create-batch-template
|
||
|
||
# Загрузка из файла со списком URL
|
||
python3 main.py --batch urls.txt --quality 720p --continue-on-error
|
||
|
||
# Загрузка нескольких URL через командную строку
|
||
python3 main.py --urls URL1 URL2 URL3 --audio-only
|
||
|
||
# Продолжить загрузку при ошибках
|
||
python3 main.py --batch urls.txt --continue-on-error
|
||
```
|
||
|
||
### Конфигурация:
|
||
```bash
|
||
# Настроить параметры по умолчанию
|
||
python3 main.py configure --output-dir downloads --video-quality 720p
|
||
|
||
# Показать текущие настройки
|
||
python3 main.py show-config
|
||
```
|
||
|
||
## 🔧 Дополнительные утилиты
|
||
|
||
```bash
|
||
# Создать шаблон для пакетной загрузки
|
||
python3 utils.py template
|
||
|
||
# Пакетная загрузка из файла
|
||
python3 utils.py batch --file urls.txt --quality 720p
|
||
|
||
# Показать историю загрузок
|
||
python3 utils.py history
|
||
|
||
# Очистить папку загрузок
|
||
python3 utils.py clean
|
||
```
|
||
|
||
## 🛠 Make команды
|
||
|
||
```bash
|
||
make install-fresh # Установить с обновлением yt-dlp
|
||
make install-ffmpeg # Установить ffmpeg для аудио
|
||
make config # Настроить конфигурацию по умолчанию
|
||
make show-config # Показать текущие настройки
|
||
make update-ytdlp # Обновить yt-dlp до последней версии
|
||
make test # Простой тест валидации URL
|
||
make demo-info # Информация о тестовом видео
|
||
make demo-formats # Форматы тестового видео
|
||
make run-examples # Запустить примеры
|
||
make clean # Очистить временные файлы
|
||
make usage # Показать справку по Makefile
|
||
```
|
||
|
||
## 📁 Структура проекта
|
||
|
||
```
|
||
youtube_downloader/
|
||
├── main.py # Основное CLI приложение
|
||
├── downloader.py # Класс загрузчика YouTube
|
||
├── config.py # Управление конфигурацией
|
||
├── utils.py # Дополнительные утилиты
|
||
├── examples.py # Примеры использования
|
||
├── requirements.txt # Зависимости Python
|
||
├── Makefile # Автоматизация задач
|
||
├── README.md # Документация
|
||
├── config.json # Файл конфигурации (создается автоматически)
|
||
└── urls.txt # Шаблон для пакетной загрузки
|
||
```
|
||
|
||
## ⚙ Конфигурация
|
||
|
||
Настройки сохраняются в `config.json`:
|
||
|
||
```json
|
||
{
|
||
"output_directory": "downloads",
|
||
"video_quality": "best",
|
||
"audio_format": "mp3",
|
||
"video_format": "mp4",
|
||
"create_subdirs": true,
|
||
"add_metadata": true,
|
||
"subtitle_languages": ["ru", "en"],
|
||
"download_subtitles": false
|
||
}
|
||
```
|
||
|
||
## 📝 Примеры
|
||
|
||
### Базовое использование в коде:
|
||
```python
|
||
from downloader import YouTubeDownloader
|
||
from config import Config
|
||
|
||
# Создание загрузчика
|
||
config = Config()
|
||
downloader = YouTubeDownloader(config)
|
||
|
||
# Загрузка видео
|
||
success = downloader.download_video(
|
||
url="https://www.youtube.com/watch?v=VIDEO_ID",
|
||
quality="720p",
|
||
audio_only=False
|
||
)
|
||
```
|
||
|
||
### Пакетная загрузка:
|
||
```python
|
||
from utils import BatchDownloader
|
||
|
||
batch = BatchDownloader()
|
||
batch.download_from_file("urls.txt", quality="best", audio_only=False)
|
||
```
|
||
|
||
## 🚨 Требования
|
||
|
||
- Python 3.7+
|
||
- Интернет соединение
|
||
- ffmpeg (для конвертации аудио)
|
||
|
||
## 🔍 Troubleshooting
|
||
|
||
### Ошибки yt-dlp
|
||
Если возникают ошибки с yt-dlp, обновите до последней версии:
|
||
```bash
|
||
make update-ytdlp
|
||
# или
|
||
pip3 install --upgrade yt-dlp
|
||
```
|
||
|
||
### HTTP Error 403: Forbidden
|
||
Приложение автоматически использует несколько стратегий обхода блокировок:
|
||
- Альтернативные User-Agent заголовки
|
||
- Повторные попытки с задержками
|
||
- Различные форматы загрузки
|
||
- Fallback настройки
|
||
|
||
### Проблемы с ffmpeg
|
||
Установите ffmpeg для конвертации аудио:
|
||
```bash
|
||
make install-ffmpeg
|
||
# или вручную:
|
||
# Ubuntu/Debian: sudo apt install ffmpeg
|
||
# macOS: brew install ffmpeg
|
||
# Windows: Скачайте с https://ffmpeg.org/
|
||
```
|
||
|
||
### Медленная загрузка
|
||
- Попробуйте скачать в более низком качестве: `--quality 480p`
|
||
- Используйте только аудио: `--audio-only`
|
||
- Проверьте интернет соединение
|
||
|
||
## 📄 Лицензия
|
||
|
||
Проект создан для образовательных целей. Соблюдайте условия использования YouTube.
|
||
|
||
## 🤝 Вклад в проект
|
||
|
||
1. Форкните репозиторий
|
||
2. Создайте ветку для новой функции
|
||
3. Сделайте изменения
|
||
4. Отправьте Pull Request
|
||
|
||
---
|
||
|
||
**Автор:** GitHub Copilot
|
||
**Версия:** 1.0.0 |