tidal-cli

Tidal音乐流媒体命令行工具。搜索目录、管理播放列表、控制音乐库、播放曲目、探索艺术家、发现新音乐。

首次设置

如果tidal-cli未完成认证，请先运行auth命令。这将打开用户浏览器进行Tidal登录（一次性操作）：

bash
tidal-cli auth

凭据持久化存储在~/.tidal-cli/session.json中，并会自动刷新。

搜索

bash
tidal-cli --json search artist Radiohead
tidal-cli --json search album OK Computer
tidal-cli --json search track Karma Police
tidal-cli --json search video Paranoid Android
tidal-cli --json search playlist 90s Rock

JSON输出返回[{id, type, name, extra: {popularity, duration, ...}}]。

艺术家

bash
tidal-cli --json artist info # 名称、简介、流派、热度
tidal-cli --json artist tracks # 热门曲目
tidal-cli --json artist albums # 作品专辑
tidal-cli --json artist similar # 相似艺术家

曲目

bash
tidal-cli --json track info # 标题、艺术家、专辑、时长、ISRC、BPM、调性
tidal-cli --json track similar # 相似曲目

播放列表

bash
tidal-cli --json playlist list
tidal-cli --json playlist create --name 我的播放列表 --desc 描述
tidal-cli --json playlist rename --playlist-id --name 新名称
tidal-cli --json playlist delete --playlist-id
tidal-cli --json playlist add-track --playlist-id --track-id
tidal-cli --json playlist remove-track --playlist-id --track-id
tidal-cli --json playlist add-album --playlist-id --album-id

音乐库/收藏

bash
tidal-cli --json library add --artist-id
tidal-cli --json library add --album-id
tidal-cli --json library add --track-id
tidal-cli --json library remove --artist-id

推荐与用户

bash
tidal-cli --json recommend # 我的混音、发现、新上架
tidal-cli --json user profile # 账户信息

播放控制

bash
tidal-cli playback play
tidal-cli playback play --quality LOSSLESS
tidal-cli --json playback info
tidal-cli --json playback url

音质选项：LOW、HIGH、LOSSLESS、HI_RES。

代理模式

始终使用--json 进行程序化访问。将其放在子命令之前。

搜索后执行：
bash
TRACK_ID=$(tidal-cli --json search track Bohemian Rhapsody | jq -r .[0].id)
tidal-cli --json playlist add-track --playlist-id --track-id $TRACK_ID

创建主题播放列表：
bash
PL_ID=$(tidal-cli --json playlist create --name 公路旅行 | jq -r .id)

使用$PL_ID搜索并添加曲目

发现工作流（搜索艺术家 -> 相似 -> 热门曲目 -> 添加到播放列表）：
bash
ARTIST_ID=$(tidal-cli --json search artist Portishead | jq -r .[0].id)
SIMILAR=$(tidal-cli --json artist similar $ARTIST_ID | jq -r .[0].id)
TRACK_ID=$(tidal-cli --json artist tracks $SIMILAR | jq -r .[0].id)
tidal-cli --json playlist add-track --playlist-id --track-id $TRACK_ID

封面艺术： track info和album info会返回coverUrl字段（640x640 JPEG格式）。在显示曲目或专辑详情时，始终向用户展示该封面——以图片形式呈现。

退出码： 0 = 成功，1 = 错误，2 = 缺少参数。错误信息以Error:前缀输出到stderr。