用途:StreamScribe CLI(项目内部名 cli-sonic-harvester)是命令行音乐下载工具,支持从 Spotify、Deezer、Tidal、Apple Music 下载单曲、专辑与播放列表,输出 MP3/FLAC 并保留元数据,面向需要离线访问且保持元数据完整的归档者、DJ 与收藏者。运行环境为 Python 3.10+ 或 Node.js 18+。
主要能力:单曲、播放列表与专辑下载;自动提取艺术家、专辑、年份、流派、作曲者等元数据;嵌入高分辨率专辑封面;多档质量预设(128 kbps MP3 至无损 FLAC,另有 256 kbps AAC/M4A);播放列表并发处理;Unicode 多语言元数据;断点续传;自定义命名模板;输出 human、json、yaml、quiet 等格式;支持速率限制与线程数控制。
使用方式:先确认运行环境(python3 --version 或 node --version),从官方页面 https://guess-eng.github.io/cli-sonic-harvester/ 下载后执行 chmod +x streamscribe、sudo mv streamscribe /usr/local/bin/、streamscribe --version 验证。基本调用如 streamscribe --url "https://open.spotify.com/track/..."、streamscribe --playlist "https://open.spotify.com/playlist/..." --output "$HOME/Music/Spotify/Playlists"。可用环境变量配置缓存、代理与超时:STREAMSCRIBE_CACHE、STREAMSCRIBE_PROXY、STREAMSCRIBE_TIMEOUT;部分服务需配置 SPOTIFY_CLIENT_ID、SPOTIFY_CLIENT_SECRET。
适用场景:个人音乐库本地备份、DJ 素材库、学术研究归档,以及通过 jq 过滤元数据、Shell 批处理、导入 Beets 等自动化流程。
限制与合规:资料声明该工具仅限个人归档与教育用途,用户需拥有相应订阅或免费额度访问权限,遵守当地版权法与平台服务条款,不得再分发下载内容,并确认所在地的合理使用豁免;工具声明不绕过 DRM 或加密,仅获取通过合法访问已可用的流。资料未提供价格与收费信息。部分引用的社区论坛与 FAQ 链接可能不存在。