# youtube-downloader

**Repository Path**: repl-top/youtube-downloader

## Basic Information

- **Project Name**: youtube-downloader
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-07-13
- **Last Updated**: 2025-07-13

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# YouTube视频下载器

这是一个用Python编写的YouTube视频下载工具，支持下载单个视频和播放列表。

## 功能特性

- 下载单个YouTube视频
- 下载YouTube播放列表
- 获取视频信息（标题、时长、上传者等）
- 自动下载字幕和缩略图
- 支持多种视频格式和质量
- 支持只下载音频
- 支持自定义输出目录和文件名
- 支持播放列表范围下载

## 安装依赖

首先安装所需的Python包：

```bash
pip install -r requirements.txt
```

## 使用方法

### 方法1: 交互式下载器

运行主程序，通过菜单选择操作：

```bash
python youtube_downloader.py
```

程序会显示以下选项：
1. 下载单个视频
2. 下载播放列表
3. 获取视频信息
4. 退出

### 方法2: 简单命令行下载器

直接通过命令行下载视频：

```bash
python simple_downloader.py <YouTube_URL>
```

示例：
```bash
python simple_downloader.py https://www.youtube.com/watch?v=dQw4w9WgXcQ
```

### 方法3: 高级命令行下载器

功能最强大的版本，支持多种选项：

```bash
python advanced_downloader.py [选项] <YouTube_URL>
```

#### 基本用法：
```bash
# 下载最佳质量的视频
python advanced_downloader.py https://www.youtube.com/watch?v=dQw4w9WgXcQ

# 只下载音频（MP3格式）
python advanced_downloader.py -a https://www.youtube.com/watch?v=dQw4w9WgXcQ

# 指定输出目录
python advanced_downloader.py -o my_videos https://www.youtube.com/watch?v=dQw4w9WgXcQ

# 下载指定质量的视频
python advanced_downloader.py -q 720p https://www.youtube.com/watch?v=dQw4w9WgXcQ

# 下载中文字幕
python advanced_downloader.py -s zh https://www.youtube.com/watch?v=dQw4w9WgXcQ
```

#### 高级用法：
```bash
# 列出所有可用格式
python advanced_downloader.py --list-formats https://www.youtube.com/watch?v=dQw4w9WgXcQ

# 下载播放列表的前5个视频
python advanced_downloader.py --playlist-start 1 --playlist-end 5 <播放列表URL>

# 下载播放列表的第3-7个视频
python advanced_downloader.py --playlist-start 3 --playlist-end 7 <播放列表URL>

# 使用特定格式ID下载
python advanced_downloader.py -f 22 https://www.youtube.com/watch?v=dQw4w9WgXcQ
```

## 文件说明

- `youtube_downloader.py` - 完整的交互式下载器
- `simple_downloader.py` - 简化的命令行下载器
- `advanced_downloader.py` - 高级命令行下载器（推荐）
- `requirements.txt` - Python依赖包列表
- `downloads/` - 下载文件保存目录（自动创建）

## 常用选项说明

### 质量选项 (-q, --quality)
- `best` - 最佳质量（默认）
- `worst` - 最低质量
- `720p` - 720p分辨率
- `1080p` - 1080p分辨率
- `480p` - 480p分辨率

### 字幕语言 (-s, --subtitle-lang)
- `en` - 英语（默认）
- `zh` - 中文
- `ja` - 日语
- `ko` - 韩语
- `fr` - 法语
- `de` - 德语

### 播放列表选项
- `--playlist-start` - 开始下载的索引（从1开始）
- `--playlist-end` - 结束下载的索引

## 注意事项

1. 请确保您有足够的磁盘空间来存储下载的视频
2. 下载的视频质量默认为最佳可用质量
3. 程序会自动创建`downloads`目录来保存文件
4. 请遵守YouTube的服务条款和版权法律
5. 某些视频可能因为版权限制无法下载
6. 音频下载需要安装FFmpeg（可选，用于音频转换）

## 故障排除

如果遇到下载问题：

1. 确保网络连接正常
2. 检查YouTube URL是否有效
3. 更新yt-dlp库：`pip install --upgrade yt-dlp`
4. 某些视频可能需要登录或年龄验证
5. 如果音频下载失败，请安装FFmpeg

### 安装FFmpeg（可选）

macOS:
```bash
brew install ffmpeg
```

Ubuntu/Debian:
```bash
sudo apt update
sudo apt install ffmpeg
```

Windows:
从 https://ffmpeg.org/download.html 下载并安装

## 许可证

本项目仅供学习和个人使用。请遵守相关法律法规和YouTube的服务条款。