ytDownloader：支持数百个站点的桌面音视频下载器
ytDownloader 是一款基于 Electron 的现代化图形界面音视频下载工具，支持 YouTube、Facebook、Instagram、TikTok、Twitter 等数百个站点，具备多主题、硬件加速视频压缩、区间选择、字幕与播放列表下载能力，可在 Linux、Windows 与 macOS 上运行，无追踪器与广告。
社区作者 · zZz
它解决什么问题
项目定位
ytDownloader 是一款“现代 GUI 视频与音频下载器”，官方描述为支持数百个站点，包括 Youtube、Facebook、Instagram、Tiktok、Twitter 等，并覆盖 Linux、Windows 与 macOS 三大平台。
主要功能（据 README）
- 支持数百个站点（含 Youtube、Facebook、Instagram、Tiktok、Twitter 等）
- 多种主题
- 带硬件加速的视频压缩器（Video Compressor with Hardware Acceleration）
- 高级选项：区间选择（Range Selection）、字幕（Subtitles）
- 下载播放列表
- 支持 Linux、Windows 与 macOS
- 下载速度快
- 无追踪器与广告
界面截图
仓库提供了多张截图。配图 1 为教程配图；配图 3 为应用界面截图；配图 5（ss-homepage）为主页界面；配图 6（ss-playlist）展示播放列表下载界面；配图 7（ss-compressor）展示视频压缩器界面；配图 8（ss-settings）展示设置界面。配图 2 与配图 4（Chocolatey）分别对应 Microsoft Store 与 Chocolatey 安装渠道的标识图。
使用技术
- yt-dlp
- Electron
- ffmpeg
- nodeJS
- flaticon
国际化（本地化）
官方表示非常欢迎其他语言的翻译。希望协助翻译的用户可通过仓库提供的入口参与；需新建 issue，由维护者将该语言加入 Crowdin。README 明确要求不要提交 json 文件的 pull request，而应使用 Crowdin。
README 中列出已完成的语言包括：Arabic、Basque、Bengali、English、Chinese Simplified、Chinese Traditional、Finnish、Hindi、French、Finnish、German、Greek、Hungarian、Italian、Japanese、Persian、Polish、Portuguese (Brazil)、Russian、Spanish、Turkish、Ukrainian、Vietnamese，状态均为已支持。
许可证
来源正文未给出许可证信息，此处标注为“待核验”。
适用对象
需要跨平台、图形界面、批量或播放列表式下载网络音视频的普通用户；需要带硬件加速压缩与字幕、区间下载等进阶功能的用户；希望在 Windows/Linux/macOS 上统一使用同一款下载客户端的使用者。
— 本文由 AI 根据公开来源辅助整理，命令、版本与许可证请在使用前到原始页面复核。
安装 / 开始使用
准备工作
- 按平台选择安装包；从源码构建需要预先安装 Node.js（含 npm）。
- macOS 需要额外安装 yt-dlp（见下文）。
Windows 🪟
1）Microsoft Store：从 Microsoft Store 下载应用（配图 2 为商店标识）。
2）传统方式：下载并安装 exe 或 msi 文件。exe 文件允许你选择自定义下载位置，msi 文件不会询问安装位置。Windows Defender 可能弹出“Windows Protected Your PC”提示，此时点击 More info，再点击 Run Anyway。
3）Chocolatey：
choco install ytdownloader4）Scoop：
scoop install https://raw.githubusercontent.com/aandrew-me/ytDownloader/main/ytdownloader.json5）Winget：
winget install aandrew-me.ytDownloaderLinux 🐧
Linux 提供 Flatpak、AppImage 和 Snap 三种方式，官方推荐 Flatpak。ARM 处理器用户请从 flathub 下载。
1）AppImage：多数 Linux 发行版支持，具备自动更新支持；下载后直接执行即可，可参考 AppImage 相关说明；推荐使用 AppImageLauncher 来集成 AppImage。
2）Flatpak：
flatpak install flathub io.github.aandrew_me.ytdn3）Snapcraft：
sudo snap install ytdownloadermacOS 🍎
由于应用未签名，直接打开时 macOS 会阻止运行。需要打开终端执行：
sudo xattr -r -d com.apple.quarantine /Applications/YTDownloader.app同时需要用 homebrew 安装 yt-dlp：
brew install yt-dlp从源码构建或运行
需要安装 Nodejs（以及 npm）。基础命令：
git clone https://github.com/aandrew-me/ytDownloader.git
cd ytDownloader
npm i使用 Electron 运行（首次运行）：
npm start注意：需要下载 ffmpeg 并放到项目根目录。如果不需要为 ARM 处理器构建，可根据平台执行 linux.sh / mac.sh / windows.sh 中任意一个文件来下载 ffmpeg；否则需要自行下载 ffmpeg——Windows/Linux 从 README 指定链接下载，macOS 从指定链接下载（README 注明未测试）。
构建 Linux（会按 package.json 中指定的格式生成包，构建产物存放在 release 文件夹）：
npm run linux构建 Windows：
npm run windows构建 macOS：
npm run mac如果只想构建某一种格式，例如只生成 Linux AppImage 构建：
npx electron-builder -l appimage常见问题
- Windows 上出现“Windows Protected Your PC”：点击 More info → Run Anyway。
- macOS 无法打开应用：因应用未签名，需执行 xattr 解除隔离命令；同时确保已通过 homebrew 安装 yt-dlp。
- 构建时缺少 ffmpeg：需手动下载 ffmpeg 放入项目根目录，或执行对应平台的脚本自动下载。
- 翻译贡献方式：不要提交 json 文件的 pull request，请通过 Crowdin 参与；新建 issue 由维护者添加语言。
