Freyr:从流媒体平台批量下载音乐的命令行工具

📅 2026/7/2 18:45:55
Freyr:从流媒体平台批量下载音乐的命令行工具
文章目录Freyr从流媒体平台批量下载音乐的命令行工具Freyr从流媒体平台批量下载音乐的命令行工具Freyr 是一款开源的命令行工具可以从 Spotify、Apple Music 和 Deezer 下载音乐。目前在 GitHub 上获得了 2,289 个 Star。Freyr 的工作流程分几步先从流媒体服务提取歌曲的元数据包括标题、专辑、艺术家等信息然后到 YouTube 上搜索匹配的音频源自动筛选最佳音质下载后将音频编码为 Apple AAC 格式默认码率 320kbps最后把元数据和专辑封面嵌入文件并按艺术家和专辑整理成结构化的音乐库。Freyr 支持批量操作。你可以把多个歌曲链接写在文本文件里一次性下载也可以直接传入播放列表或专辑的 URL工具会自动下载其中所有曲目。下载完成后工具会在基础目录下生成 m3u8 格式的播放列表文件方便你在各种播放器中使用。在元数据支持方面三个平台各有不同。Apple Music 和 Deezer 能提取的信息比 Spotify 更丰富比如作曲家、流派等字段。Spotify 不支持这些字段的获取但基础的标题、专辑、艺术家等信息都没有问题。三个平台都能获取封面图、发行日期、唱片公司、版权信息等。工具提供了丰富的配置选项。你可以指定音频码率支持 96k 到 320k 多种选择。下载并发数也可以调整默认是 7 个分块同时下载。如果网络不稳定还能设置重试次数。文件保存路径、封面图尺寸、播放列表生成等都有对应的参数控制。你还可以通过 filter 参数筛选特定歌曲比如只下载某张专辑中符合特定标题模式的曲目。安装方式有三种通过 NPM 或 Yarn 全局安装从源码构建或者直接用 Docker 镜像。Docker 方式最省事不需要手动配置 Python 和 Node.js 环境。手动安装需要准备 Python 3.2 以上版本、Node.js 16 以上版本以及 AtomicParsley 用于音频元数据处理。AtomicParsley 负责将元数据和封面图写入音频文件。使用时在命令行传入歌曲链接即可。比如下载 Spotify 单曲freyr spotify:track:5FNS5Vj69AhRGJWjhrAd01。下载 Apple Music 专辑freyr https://music.apple.com/us/album/xxx。也可以直接传入 Deezer 的链接。工具会自动完成从下载到编码的全流程。下载完成后会显示统计信息包括运行时间、网络流量、输出大小等。单曲下载通常在半分钟左右完成专辑下载取决于曲目数量。需要注意的是Freyr 依赖 YouTube Music 作为音频源所以你的网络环境需要能访问 YouTube Music。音频源默认使用 YouTube Music也可以配置为普通 YouTube。如果某个曲目在 YouTube 上找不到匹配工具会跳过该曲目并报告失败。Freyr 还支持通过配置文件进行个性化设置。你可以把常用的参数写入配置文件避免每次输入冗长的命令。工具也支持离线模式跳过网络连接检查适合在网络受限的环境下使用。进度条显示下载状态支持关闭或切换为单条进度模式。对于开发者来说Freyr 的源码结构清晰使用 Node.js 编写Python 脚本负责部分元数据处理。项目维护活跃有完整的测试用例和 CI 流程。如果你需要从流媒体平台获取音乐并在本地建立音乐库Freyr 是一个值得尝试的工具。并在本地建立音乐库Freyr 是一个值得尝试的工具。