freyr-js

Freyr 是一个用于从流媒体服务下载音乐曲目的命令行工具。给定 Spotify、Apple Music 或 Deezer 的 URL 或短 URI，它会提取曲目元数据（标题、艺术家、专辑、曲目/碟片编号、发行日期、ISRC、唱片公司、版权、封面等），然后查询 YouTube Music 等音频源以查找匹配的音频，下载原始文件，以可配置的比特率（96–320kbps，默认 320k）编码为 Apple AAC（.m4a），嵌入元数据和专辑封面，并将输出整理为 ARTIST/ALBUM/TRACK 目录结构。 支持的查询类型包括曲目、专辑、艺术家和播放列表。可以通过传递多个查询作为参数或通过输入文件（-i/--input）进行批量下载，其中每行是一个查询，# 表示注释。urify 子命令可在服务 URL 和 freyr 兼容的短 URI 之间转换。 显著选项包括比特率选择、并发分块下载（-n/--chunks）、重试次数、自定义输出目录、检查其他目录中已有曲目（-D）、封面命名和大小或禁用封面、源优先级排序（youtube、yt_music，使用 ! 排除）、元数据过滤器、各阶段并发调整（queries、tracks、trackStage、downloader、encoder、embedder）、无缝播放标志、强制覆盖、播放列表生成（m3u8）及目录、追加、转义和命名空间前缀选项、店面国家代码、禁用树状组织、缓存目录控制、内存缓存大小、网络超时、认证和浏览器启动开关、进度条样式，以及显式 AtomicParsley 二进制路径。 可通过 npm（npm install -g freyr）或 Yarn 安装，也可从源码安装，或使用官方 Docker 镜像（freyrcli/freyrjs），并附有文档化的 docker run 命令和别名示例。要求包括 Python >= 3.2、Node.js >= 16 和 AtomicParsley >= 20230114。README 指出，由于原始音频来自 YouTube Music，因此用户所在地区必须可用 YouTube Music。该项目已获得许可，并包含 CI 检查、CodeFactor 评级、npm 和 Docker 下载徽章以及捐赠链接。