PyTube Downloader快速上手教程:从安装到下载第一个视频的5个步骤
PyTube Downloader快速上手教程:从安装到下载第一个视频的5个步骤
PyTube Downloader(PyTube 下载器)是一款简单、快速、强大的 YouTube 视频下载工具,支持 Mac、Windows 和 Linux,可下载 144p–8K 多种质量、MP4/MP3 等格式的单个视频或整个播放列表。本教程用 5 个步骤带你完成 YouTube 下载器安装,并成功下载第一个视频。
步骤 1:获取 PyTube Downloader 源代码
打开终端,克隆项目仓库:
git clone https://gitcode.com/gh_mirrors/pytu/pytube-downloader
cd pytube-downloader
💡 项目要求 Python 3.10+,请先确认本机已安装 Python。
步骤 2:安装 FFmpeg(视频下载器必备)
FFmpeg 负责视频/音频的合并与转换,是下载高清视频的关键。
- 从 FFmpeg 官网下载并解压
- 将
ffmpeg.exe复制到项目的 ffmpeg/ 目录中
该目录会随项目一起分发,放进去即可,无需配置环境变量。
步骤 3:一键安装 Python 依赖
项目提供了自动安装脚本 dependencies_installer.py,在终端执行:
python dependencies_installer.py # 核心依赖
python dependencies_installer.py windows # Windows 用户:额外安装通知相关组件
它会按照 requirements.txt 自动安装 customtkinter、pytubefix、pillow 等依赖库,无需手动 pip install。
步骤 4:启动 PyTube Downloader
运行主入口 main.py:
python main.py
首次启动后,程序会自动加载主题、语言和设置(默认配置见 data/general.json)。启动后你会看到类似下图的主界面,顶部是链接输入栏,下方分为「已添加 / 下载中 / 已下载 / 历史」四个标签页:
🎨 不喜欢默认外观?按
Ctrl + ,打开设置,在「外观」页可切换主题、强调色、窗口比例与透明度:
步骤 5:下载你的第一个视频
整个下载流程只需 4 次点击:
- 粘贴链接:把 YouTube 视频或播放列表链接粘贴到顶部输入栏
- 选择模式:勾选「视频」(单个视频)或「播放列表」(整列表下载)
- 点击「添加」:应用会自动加载视频信息,包括标题、频道、缩略图
- 选择质量并下载:在下拉框中选择格式与质量(144p–8K、MP4、MP3 等),点击「下载」,即可在「下载中」页实时查看进度和速度
下载完成后,视频会出现在「已下载」页,点击文件夹图标可直接打开文件所在目录,点击播放按钮可立即播放:
实用设置推荐
-
网络设置:调整最大同时下载数(支持多任务并行下载)、开启"自动视频/播放列表下载"后,加载完成即可一键自动下载:
-
下载设置:修改下载路径、开启"播放列表专用目录"和"基于质量的文件夹组织",让文件自动分类整理:
常见问题
| 问题 | 解决方法 |
|---|---|
| 启动报错缺少模块 | 重新运行 python dependencies_installer.py |
| 高清视频下载失败/无声音 | 检查 ffmpeg/ 目录中是否已放入 ffmpeg.exe |
| 界面是英文 | 设置 → 通用 → 语言切换为中文(支持中、英、僧加罗语、泰米尔语、俄语) |
项目结构速览
想深入了解?核心逻辑位于 services/(下载、历史、主题管理等)和 widgets/(界面组件),完整目录说明见 PROJECT_STRUCTURE.md。
⚠️ 本应用仅供个人使用,下载视频时请遵守 YouTube 服务条款并尊重内容创作者的版权。
完成以上 5 个步骤,你就已经掌握了这款 YouTube 下载器的核心用法——粘贴链接、选择质量、点击下载,简单快速又强大!