使用教程

安装 ytDownloader

访问本站下载中心或 GitHub Releases 页面，根据你的操作系统选择对应安装包。Windows 用户推荐下载 .exe 安装程序，macOS 用户根据芯片选择 Apple Silicon 或 Intel 版本的 .dmg，Linux 用户推荐下载 AppImage 或通过 Flatpak 安装。

双击安装包按提示完成安装即可。Windows 与 Linux 版本已内置 yt-dlp 与 FFmpeg，无需额外配置环境。macOS 用户首次启动时如果系统提示「无法验证开发者」，请打开「系统设置 → 隐私与安全性」点击「仍要打开」，或在终端执行：

sudo xattr -r -d com.apple.quarantine /Applications/YTDownloader.app

此外，macOS 用户还需要确保已通过 Homebrew 安装 yt-dlp：brew install yt-dlp。完成后启动 ytDownloader，主界面顶部即会出现一个简洁的链接输入框。

下载第一个视频

打开浏览器，找到你想下载的视频，复制地址栏中的完整链接。回到 ytDownloader，将链接粘贴到顶部输入框中，按回车或点击「获取信息」按钮。软件会自动调用 yt-dlp 解析视频元数据，几秒钟后下方会列出所有可用的下载格式。

格式列表按清晰度从高到低排列，每行显示分辨率、容器格式（MP4/WebM/MKV）、预估文件大小。YouTube 等 DASH 流媒体平台会显示「视频+音频」组合选项，ytDownloader 会自动下载分离的视频流与音频流，然后用内置 FFmpeg 合并为单个文件。

选定格式后点击右侧的下载按钮，下方任务列表会新增一条进度条，实时显示下载速度、已下载大小与预计剩余时间。下载完成后文件会自动保存到默认目录（可在偏好设置中修改），同时弹出系统通知。

小提示：选择「Best Quality」会自动挑选源站最高画质，无需手动比较格式列表，适合大多数场景。

提取音频（MP3 / M4A）

如果你只需要音频（比如把 MV 转成 MP3、把播客视频转成音频随身听），在格式下拉框中切换到「Audio Only」即可。ytDownloader 会列出所有可用的音频流，常见格式包括 MP3、M4A、OPUS、OGG、WAV。

选择目标格式后点击下载，ytDownloader 会下载原始音频流，必要时用 FFmpeg 转码为你指定的格式。MP3 最高支持 320kbps，M4A 通常能直接保留源站的 AAC 编码无需转码，音质最佳。

对于播客主理人、外语学习者，这一功能配合「文件名模板」可以批量整理音频库。例如设置模板为 %(uploader)s/%(upload_date)s - %(title)s.%(ext)s，所有音频会按创作者与日期自动归档。

下载整页播放列表

当检测到链接属于播放列表时（如 YouTube 播放列表 URL 中包含 list= 参数），ytDownloader 会弹出确认对话框，询问你是下载整个列表还是仅下载当前视频。选择「整个列表」后，软件会解析列表中所有视频并显示为可勾选清单。

每条视频前都有独立勾选框，支持全选、反选、按住 Shift 多选。顶部还有过滤选项：按视频时长过滤（比如只下载 10 分钟以内的）、按上传日期过滤（比如只下载最近 30 天的）。这些过滤器能帮你跳过列表中的无关内容，节省存储与带宽。

勾选完成后点击「批量下载」，所有任务会加入队列依次执行。如果某条视频因限流失败，软件会自动重试 3 次。v3.22.0 还新增了任务取消按钮，可随时中止队列。已下载的文件会自动跳过，避免重复下载。

片段下载（Range Selection）

遇到 3 小时的直播回放只想截取其中 5 分钟的精彩片段？ytDownloader 独家的片段下载功能可以做到。在解析视频后展开「高级选项」面板，勾选「启用片段下载」，输入起始时间与结束时间。

时间格式支持 HH:MM:SS（如 00:05:30）或简化的 MM:SS（如 05:30）。ytDownloader 会先下载完整视频流，然后用 FFmpeg 按时间戳精确裁剪，保留你指定的部分。最终生成的文件只包含目标片段，体积通常只有原视频的几分之一。

这一功能非常适合内容创作者从长视频中截取精彩瞬间做短视频、播客主理人截取嘉宾发言片段做预告片，以及学生从长讲座中提取重点片段反复观看。配合 GPU 压缩，整个流程在几分钟内即可完成。

下载字幕

展开「高级选项」面板，勾选「下载字幕」即可启用。ytDownloader 会自动检测视频可用的字幕语言，并提供两种类型供选择：「自动生成」（YouTube 等平台的语音识别字幕）与「人工上传」（创作者或社区提供的字幕）。

在语言下拉框中选择你需要的语言，比如中文（简体）、中文（繁体）、英语、日语等。下载完成后，字幕会以通用 .srt 格式保存在视频文件同目录下，文件名与视频一致。VLC、MPV、PotPlayer 等主流播放器会自动加载同名字幕。

对于需要文字稿的场景（会议纪要、讲座笔记、外语学习），可以勾选「仅下载字幕」选项，跳过视频文件，几秒钟就能拿到一份完整的 .srt 文本。再用任意文本编辑器打开即可阅读或转换为其他格式。

使用 GPU 硬件加速压缩

4K 视频动辄几个 GB，长期积累会迅速占满硬盘。ytDownloader 内置 GPU 加速压缩器，调用 NVIDIA NVENC、Intel Quick Sync 或 AMD VCE 硬件编码器，在保证画质的前提下大幅缩减文件体积。

在视频解析后展开「高级选项」，找到「视频压缩」开关。启用后选择预设：「快速」（压缩比约 50%，速度优先）、「均衡」（压缩比约 35%，速度与画质兼顾）、「高质量」（压缩比约 25%，画质优先）。「自定义」模式允许你设置目标体积百分比与分辨率缩放比例。

软件会自动检测系统可用的 GPU 编码器并默认选用最快的方案。在一台中端游戏本（如 RTX 3060）上，把 5GB 的 4K 视频压缩到 1.4GB 大约只需 2 分钟，比纯 CPU 编码快 5 到 10 倍。压缩完成后会生成新文件，原文件可选保留或删除。

使用 Cookie 下载私有内容

对于私有视频、年龄限制视频、会员专享内容（如 YouTube Premium 独家视频、Bilibili 大会员视频、Patreon 付费内容），ytDownloader 支持读取浏览器 Cookie 用于身份验证。

在偏好设置中找到「Cookie」选项，选择你登录目标网站的浏览器（Chrome / Edge / Firefox / Safari）。ytDownloader 会从该浏览器的本地数据中读取对应站点的 Cookie 并附加到下载请求中，相当于以你的登录身份访问。

所有 Cookie 仅在本机使用，不会被收集、上传或共享给任何第三方。完成下载后可在偏好设置中清除 Cookie 缓存。如果遇到 Cookie 失效（比如目标网站改版），重新登录浏览器再下载即可。

安全提示：请勿在不信任的设备上启用 Cookie 功能。Cookie 等同于你的登录凭证，泄露后可能被用于冒充你的身份。