PyTube Downloader 是一款简单、快速、强大的 YouTube 下载器（支持 Mac、Windows 与 Linux）。内置的动态文件夹组织功能，可以让下载的文件按播放列表、质量、音视频类型自动分类归档，告别"一个下载目录堆满文件"的混乱局面。本教程带你 3 分钟完成全部设置。


为什么需要动态文件夹组织

默认情况下，所有下载文件都会混在一个目录里，时间久了会出现这些问题：

• 📁视频、音频混在一起，找文件全靠搜；
• 🎞️播放列表下载的视频散落各处，无法按系列管理；
• 🔍不同分辨率文件混杂，分不清哪个是 1080p、哪个是 4K。

PyTube Downloader 在"下载"设置面板中提供了3 个文件夹组织开关 + 1 个下载路径设置，打开后即可实现全自动归类。

3步打开"下载"设置面板

1. 启动 PyTube Downloader，按快捷键Ctrl + 反引号（）`，或点击窗口左上角的⚡ 按钮打开设置面板；
2. 在左侧导航栏点击「下载」；
3. 即可看到动态文件夹组织的全部选项。


动态文件夹组织：4个核心选项逐一讲解


1️⃣ 下载路径（根目录）

所有文件归档的"根目录"，点击 📂 图标即可图形化选择文件夹。不修改时，默认使用系统下载目录下的PyTube Downloader子文件夹（逻辑见 settings/general_settings.py）。

2️⃣ 播放列表专用目录

为每个下载的播放列表生成一个专属文件夹，命名为频道 - 播放列表标题。

下载整个播放列表时最有用——一个列表一个文件夹，系列内容永不走丢。

3️⃣ 音频和视频分开文件夹

把下载的文件分流到videos和audios两个子文件夹。适合"视频看画面、MP3 听声音"分开放的习惯。

4️⃣ 基于质量的文件夹组织

按所选质量（如1080p、2160p）自动创建对应子文件夹，文件质量一目了然。

三个开关相互独立，可任意组合，组合规则如下表：

💡 注意优先级：播放列表模式下只会生成播放列表专属文件夹，不再叠加音视频/质量子文件夹（规则实现见 widgets/video/downloading_video.py）。

应用设置并验证归类效果

1. 打开需要的开关后，点击面板底部的「应用」按钮（面板代码见 widgets/setting_panels/downloads_panel.py）；
2. 返回主界面，粘贴链接并下载，文件会自动落位到对应文件夹；
3. 文件命名为频道 - 视频标题，同样经过清理避免非法字符，方便检索。


设置项会实时持久化：默认值定义在 data/general.json，应用启动时自动备份并同步到用户目录（Linux 为~/.local/share/PyTube Downloader/data/general.json，Windows 在AppData，macOS 在Application Support）。

常见问题 FAQ

Q1：开启开关后，旧文件会被移动吗？不会。动态文件夹组织只对新下载的文件生效，历史文件需手动整理（可在「历史」面板定位后处理）。

Q2：为什么videos、audios是英文文件夹名？这是程序内置的固定命名，保证跨平台兼容性，不影响检索。

Q3：设置没生效？确认点击过「应用」按钮；仅"块大小"一项需要重启应用，三个文件夹开关即时生效。

总结

只需在"下载"面板勾选对应开关并点击「应用」，PyTube Downloader 的动态文件夹组织就会自动接管每一次下载，让文件归档零手动。更多目录与代码说明可查阅 PROJECT_STRUCTURE.md。