2026-06-21 14:26:15 +08:00
2026-06-21 14:26:15 +08:00
2026-06-21 14:26:15 +08:00
2026-06-21 14:26:15 +08:00
2026-06-21 14:26:15 +08:00
2026-06-21 14:26:15 +08:00
2026-06-21 14:26:15 +08:00
2026-06-21 14:26:15 +08:00
2026-06-21 14:26:15 +08:00
2026-06-21 14:26:15 +08:00
2026-06-21 14:26:15 +08:00
2026-06-21 14:26:15 +08:00
2026-06-21 14:19:44 +08:00
2026-06-21 14:26:15 +08:00

YouTube Downloader Pro

一个基于 Python、yt-dlp 和 FFmpeg 开发的现代化 YouTube 视频下载工具。

Version Python License


✨ 功能特性

核心功能

  • 🎬 单视频下载 — 支持多种清晰度选择,从 144P 到 8K
  • 📋 播放列表下载 — 批量解析播放列表,支持选择性下载
  • 🔗 高清视频自动合并 — 自动下载音视频流并使用 FFmpeg 合并
  • 📝 字幕下载 — 支持自动字幕和官方字幕(SRT/VTT 格式)
  • 🖼 封面下载 — 高质量封面图保存(JPG/PNG)
  • ⚡ 多线程下载 — 可配置 1-32 线程并发,充分利用带宽
  • 📊 下载队列管理 — 支持暂停、恢复、取消和失败重试
  • 🎨 深色/浅色主题 — 支持跟随系统主题自动切换

特色亮点

  • 现代化 PySide6 界面,操作流畅
  • 实时下载进度显示(速度、进度条、剩余时间)
  • 批量下载设置自由组合(视频/音频/字幕/封面)
  • 完整日志系统,方便问题排查
  • 自动检测 FFmpeg,无需手动配置

📸 界面截图

截图位置预留 — 请在应用运行后截图替换

┌──────────────────────────────────────────────────────┐
│  🔗 [YouTube URL 输入框..................] [获取信息] [下载] │
├──────────────────────────────────────────────────────┤
│  ┌─────────┐                                          │
│  │ 封面图   │  视频标题                                │
│  │         │  👤 作者  ⏱ 时长  📅 上传日期            │
│  └─────────┘                                          │
├──────────────────────────────────────────────────────┤
│  格式选择                                              │
│  🎬 视频格式: [1080p | MP4 | AVC1 | 60FPS | 1.2GB ▾]  │
│  🎵 音频格式: [MP3 192kbps ▾]                         │
├──────────────────────────────────────────────────────┤
│  ☑ 下载字幕 [中文 ▾]  ☐ 下载封面  ☑ 自动合并音视频    │
├──────────────────────────────────────────────────────┤
│  下载队列                                    [暂停] [恢复]│
│  任务 │ 状态 │ 速度 │ 已下载/总大小 │ 进度 │ 操作     │
│  ...  │ 下载中│ 5MB/s│ 45M/300M   │ [=== ]│ [取消]  │
└──────────────────────────────────────────────────────┘

🔧 安装教程

环境要求

组件 要求
Python 3.12 或更高版本
pip 最新版本
FFmpeg 用于高清视频音视频合并(可选但推荐)

步骤 1: 克隆项目

git clone https://github.com/xiaohui/youtube-downloader-pro.git
cd youtube-downloader-pro

步骤 2: 创建虚拟环境(推荐)

# Windows
python -m venv venv
venv\Scripts\activate

# macOS / Linux
python3 -m venv venv
source venv/bin/activate

步骤 3: 安装依赖

pip install -r requirements.txt

步骤 4: 运行应用

python main.py

🎬 FFmpeg 配置教程

高清视频(1080P 及以上)通常音频和视频流分离,需要 FFmpeg 合并。

Windows 安装

  1. 访问 FFmpeg 官网
  2. 下载 Windows 版本(推荐 gyan.dev 或 BtbN 构建版)
  3. 解压到 C:\ffmpeg\
  4. 将 C:\ffmpeg\bin\ 添加到系统环境变量 PATH
  5. 或直接在应用设置中手动指定 ffmpeg.exe 路径

macOS 安装

brew install ffmpeg

Linux 安装

# Ubuntu/Debian
sudo apt install ffmpeg

# Fedora
sudo dnf install ffmpeg

# Arch
sudo pacman -S ffmpeg

验证安装

ffmpeg -version

应用会自动检测 FFmpeg,也可在 设置 → 高级 → FFmpeg 路径 中手动指定。


📖 使用方法

下载单个视频

  1. 复制 YouTube 视频链接
  2. 粘贴到应用顶部输入框
  3. 点击 获取信息 查看视频详情
  4. 选择需要的清晰度和格式
  5. 可选勾选字幕、封面下载
  6. 点击 下载

下载播放列表

  1. 复制播放列表链接(如 https://www.youtube.com/playlist?list=xxx)
  2. 粘贴并点击 获取信息
  3. 在列表中勾选需要下载的视频(支持全选/取消全选)
  4. 点击 下载选中

批量下载设置

在下载选项区域可自由组合:

  • ✅ 下载视频 + ✅ 下载字幕 + ✅ 下载封面
  • ✅ 仅下载音频(选择音频格式)
  • 任意组合

下载队列管理

  • 暂停/恢复: 控制下载进程
  • 取消: 取消单个或全部任务
  • 重试失败: 一键重试所有失败任务
  • 清空已完成: 清理已完成的任务记录

📁 项目结构

youtube_downloader/
├── main.py                      # 应用入口
├── __init__.py                  # 包初始化
│
├── ui/                          # UI 层
│   ├── __init__.py
│   ├── main_window.py           # 主窗口
│   ├── settings_window.py       # 设置窗口
│   ├── about_window.py          # 关于窗口
│   └── widgets/                 # 可复用组件
│       └── __init__.py
│
├── downloader/                  # 下载器核心
│   ├── __init__.py
│   ├── video_downloader.py      # 视频下载逻辑
│   ├── playlist_downloader.py   # 播放列表解析
│   ├── subtitle_downloader.py   # 字幕下载
│   ├── thumbnail_downloader.py  # 封面下载
│   ├── ffmpeg_merger.py         # FFmpeg 合并
│   ├── format_parser.py         # 格式解析
│   └── download_queue.py        # 下载队列管理
│
├── models/                      # 数据模型
│   ├── __init__.py
│   ├── task.py                  # 下载任务模型
│   └── settings.py              # 设置模型
│
├── config/                      # 配置管理
│   ├── __init__.py
│   └── settings_manager.py      # 设置持久化
│
├── utils/                       # 工具模块
│   ├── __init__.py
│   ├── logger.py                # 日志系统
│   └── validators.py            # URL 验证
│
├── resources/                   # 资源文件
│   ├── icons/
│   └── images/
│
├── requirements.txt             # 依赖清单
└── README.md                    # 项目文档

📦 打包为 EXE

使用 PyInstaller 打包为单文件 EXE

# 安装 PyInstaller
pip install pyinstaller

# 打包
pyinstaller --onefile --windowed --name "YouTube Downloader Pro" main.py

或使用提供的 spec 文件:

pyinstaller "YouTube Downloader Pro.spec"

打包后的 EXE 文件位于 dist/ 目录,用户无需安装 Python 即可运行。


❓ 常见问题

Q: 下载失败:ERROR: Unable to download webpage

A: 这通常是网络问题:

  • 检查网络连接是否正常
  • 尝试使用代理(设置 → 高级 → 代理服务器)
  • yt-dlp 会自动处理大部分 YouTube 变更,保持版本更新

Q: 高清视频没有声音

A: 需要 FFmpeg 合并音视频流:

  • 确认 FFmpeg 已安装(状态栏可查看)
  • 勾选"自动合并音视频"选项
  • yt-dlp 会自动下载音视频流并调用 FFmpeg 合并

Q: 字幕下载失败

A:

  • 检查视频是否有对应语言的字幕
  • 尝试切换自动字幕/官方字幕
  • 部分视频可能没有特定语言的字幕

Q: 如何更新 yt-dlp?

pip install --upgrade yt-dlp

Q: 下载速度慢

A:

  • 在设置中增加下载线程数
  • 检查是否启用了下载限速
  • 使用代理服务器可能改善连接

👨‍💻 开发者


📄 许可证

MIT License — 详见 LICENSE 文件


⚠️ 免责声明

本工具仅供个人学习和研究使用。请遵守 YouTube 服务条款和当地法律法规。下载受版权保护的内容需获得权利人授权。 #� �Y�o�u�T�u�b�e�-�D�o�w�n�l�o�a�d�e�r�-�P�r�o� � �

S
Description
一个基于 Python、yt-dlp 和 FFmpeg 开发的现代化 YouTube 视频下载工具。
Readme
20 MiB
1 Stars 1 Watchers 0 Forks
Generate repository badges
Languages
C 87.7%
Assembly 7.5%
HTML 2.6%
Makefile 1.3%
Python 0.3%
Other 0.4%