Media Downloader：macOS 视频下载器

项目简介

Media Downloader 是一款原生 macOS 视频下载器，采用简洁的 Spotlight 风格窗口。它通过 yt-dlp 支持数千个网站，并使用 ffmpeg 完成视频的合并、转码与裁剪。粘贴 YouTube、Instagram、X、TikTok、Vimeo、Reddit 等站点的链接后，应用会下载 MP4 文件、把成品复制到剪贴板、保存到指定文件夹，并保留本地下载历史以便快速访问。

主要功能

• 从 yt-dlp 支持的数千个网站下载视频。
• 粘贴链接，即可在干净的 Spotlight 风格 macOS 窗口中开始下载。
• 尽可能将下载内容转换并合并为兼容性更广的 MP4（H.264/AAC）。
• 下载完成后自动复制文件到剪贴板。
• 保留带缩略图的本地下载历史。
• 在历史记录中再次复制文件、在 Finder 中显示，或打开原始来源链接。
• 裁剪已下载的视频，可保存裁剪后的 MP4 或复制裁剪片段。
• 选择并记住自定义下载文件夹。
• 在设置菜单中检查 GitHub Releases 的应用更新。

安装与使用

从 Releases 下载 macOS 安装包（arm64 DMG）：Download for macOS。打开 DMG 后将 MediaDownloader.app 拖入 Applications 即可完成安装。使用时粘贴视频链接开始下载，完成后文件会自动复制并保存在所选文件夹中。

本地开发需要 macOS 14 或更新版本、Xcode Command Line Tools 或 Xcode（Swift 5.9+），以及 yt-dlp 和 ffmpeg：

xcode-select --install
brew install yt-dlp ffmpeg

在仓库根目录执行构建并运行：

./script/build_and_run.sh

脚本会执行 swift build，在 dist/MediaDownloader.app 生成开发版应用包并启动。也可以直接使用 SwiftPM：

swift build
swift test

脚本还支持 --verify、--logs、--telemetry、--debug、--setup 等模式。

发布签名并公证的 macOS zip 与 DMG：

./script/release_macos.sh v0.2.0

仅本地生成签名公证产物、不发布 GitHub Release：

./script/package_macos.sh

发布凭据应放在由 .env.example 复制而来的本地 .env 文件中。

注意事项

• 站点支持取决于已安装的 yt-dlp 版本；若某站点不再可用，请先升级：brew upgrade yt-dlp。
• 下载文件保存在所选的本地文件夹；应用偏好存于 UserDefaults，历史记录与生成的缩略图存于应用的 Application Support 目录。
• 不要提交 .env、.p8、.p12、证书、描述文件或私钥，仓库已忽略这些文件。

---

本作品整理自 GitHub 开源项目 pixel-point/media-downloader，原作者 @pixel-point。中文介绍由 AI 根据项目 README 整理，以原仓库为准。