Tidal + 网易云音乐离线下载工具指南（2026 现状）

# 依赖
brew install ffmpeg python@3

# 主程序
pip3 install streamrip --upgrade

# 如遇 OAuth invalid_client 错误（Tidal 轮换凭据），切 dev 分支：
pip3 install git+https://github.com/nathom/streamrip.git@dev --upgrade

rip config open   # 用默认编辑器打开 config.toml

[tidal]
quality = 2                # 0=128k AAC, 1=320k, 2=HiFi FLAC, 3=HiRes FLAC, 4=Max
download_base_path = "~/Music/streamrip"
# 不要在配置文件里写账号密码 —— streamrip 用 OAuth 设备码，不存明文凭据

# === 单张专辑（URL） ===
rip --quality 2 url https://tidal.com/browse/album/147569387

# === 搜索 + 交互式下载 ===
rip search tidal album 'fleetwood mac rumours'
rip search tidal playlist 'lo-fi beats'
rip search tidal track 'daft punk get lucky'

# === 歌单 / 艺人全集 ===
rip url https://tidal.com/browse/playlist/abc123
rip url https://tidal.com/browse/artist/12345 --include-singles

# === 下载后自动转 MP3（需 ffmpeg） ===
rip --codec mp3 --quality 2 url https://tidal.com/browse/album/147569387

# === 临时覆盖默认音质 ===
rip --quality 3 url https://tidal.com/browse/album/147569387

brew install uv
mkdir ~/ncm-dl && cd ~/ncm-dl

# 写到 shell rc（~/.zshrc）
export MUSIC_U='你的_cookie_值'
export LEVEL=lossless              # standard | higher | exhigh | lossless | hires

# NetEase 下载目录（由 dl-ncm 脚本自动创建）
public/sharing/listening/netease   # → Nutstore 同步路径

# === 搜索 ===
uv run ncm-dl search "晴天 周杰伦"

# === 单曲下载（按 ID，来自搜索结果） ===
uv run ncm-dl dl 186016

# === 只取流媒体 URL，不下载 ===
uv run ncm-dl url 186016

# === 完整歌单 ===
uv run ncm-dl playlist PLAYLIST_ID --level lossless

# === 临时指定音质 ===
uv run ncm-dl dl 186016 --level hires

git clone https://github.com/NeteaseCloudMusicApiEnhanced/api-enhanced.git
cd api-enhanced && pnpm install
ENABLE_FLAC=true \
SELECT_MAX_BR=true \
ENABLE_GENERAL_UNBLOCK=true \
node app.js   # 启动 API 服务器，默认 :3000

// song_url/v1 返回直接可下载的 URL
const res = await fetch('http://localhost:3000/song/url/v1?id=186016&level=lossless', {
  headers: { Cookie: `MUSIC_U=${process.env.MUSIC_U}` }
});
const { data: [{ url, type, size }] } = await res.json();
// url 即 FLAC/MP3 直链，type 是后缀名

# V0 高质量变码率（~190-250 kbps，体积约为 320k CBR 的 70%）
ffmpeg -i input.flac -q:a 0 output.mp3

# 320k CBR
ffmpeg -i input.flac -b:a 320k output.mp3

# 把目录下所有 FLAC 转为 V0 MP3，删除原 FLAC
find ~/Music/tidal -name '*.flac' -exec sh -c \
  'ffmpeg -i "$0" -q:a 0 "${0%.flac}.mp3" && rm "$0"' {} \;

# 仅转码不删除
find ~/Music/tidal -name '*.flac' -exec sh -c \
  'ffmpeg -i "$0" -q:a 0 "${0%.flac}.mp3"' {} \;

# ncm-dl 走的是 music.163.com API，海外 IP 可能被限流
export https_proxy=http://your-cn-proxy:7890
export http_proxy=http://your-cn-proxy:7890
uv run ncm-dl search "晴天"

ENABLE_RANDOM_CN_IP=true   # 随机伪造 CN 出口 IP（依赖服务端 IP 库）

# === 系统依赖 ===
brew install ffmpeg python@3 uv

# === Tidal ===
pip3 install streamrip --upgrade
rip config open   # 编辑 ~/.config/streamrip/config.toml

# === 网易云 ===
uv tool install ncm-dl
# 把下面两行加到 ~/.zshrc
# export MUSIC_U='你的_cookie'
# export LEVEL=lossless

# === Helper 脚本（已部署到 ~/bin/）===
# dl-tidal <url>    → 下载到 walkingweekend/public/sharing/listening/tidal/
# dl-ncm <song_id>  → 下载到 walkingweekend/public/sharing/listening/netease/

~/bin/
├── dl-tidal    # rip --quality 2 url "$@" → public/sharing/listening/tidal/
└── dl-ncm      # ncm-dl dl "$@" 或 ncm-dl pl "$@" → public/sharing/listening/netease/

# Tidal（需 streamrip + OAuth）
dl-tidal https://tidal.com/browse/album/147569387

# NetEase 单曲（需 MUSIC_U cookie）
dl-ncm 186016 --level lossless

# NetEase 歌单
dl-ncm playlist 123456 --level lossless