streamrip 是一个基于 Python 的命令行高保真音乐下载工具核心支持Qobuz、Tidal、Deezer、SoundCloud可整站/专辑/单曲/播放列表/艺人全集下载内置FFmpeg 转码与元数据补全适合音乐收藏与自动化归档。一、核心功能多平台支持Qobuz无损/Hi-Res、TidalHiFi/MQA、Deezer、SoundCloud需对应平台高级订阅。全类型资源下载单曲、专辑、播放列表、艺人全集、厂牌目录、Last.fm 歌单映射。音质与格式最高支持24bit/192kHzQobuz输出FLAC、MP3、AAC、ALAC、Opus。元数据与封面自动补全ID3 标签、专辑封面、歌词、ISRC、流派、年份。批量与脚本化支持 URL 列表批量下载命令行可嵌入 Shell/Python 脚本。FFmpeg 集成下载后自动转码支持无损压缩、音量归一、封面嵌入。跨平台Windows/macOS/Linux提供rip全局命令。二、安装与环境准备1. 依赖要求Python ≥3.10推荐 3.11/3.12FFmpeg必需用于转码/封面处理对应平台高级订阅Qobuz Sublime、Tidal HiFi/Max、Deezer HiFi2. 安装命令# 基础安装pip3installstreamrip--upgrade# Windows 额外依赖解决 curses 报错pip3installstreamrip windows-curses--upgrade# 从源码安装开发版pip3installgithttps://github.com/nathom/streamrip.gitdev3. 验证与初始化# 查看版本rip--version# 生成并打开配置文件首次运行自动创建rip configopen4. 配置文件config.toml核心项[general] download_dir D:/Music # 下载根目录 codec flac # 默认输出格式flac/mp3/aac/alac quality 2 # 默认音质0(128k)~4(24/192k) embed_cover true # 嵌入封面 add_metadata true # 补全元数据 [qobuz] email youremail.com password_md5 md5_hash # 密码MD5非明文 app_id ... # 固定值勿改 [tidal] user_id ... token ...三、命令语法与参数1. 主命令结构rip[全局参数]子命令[资源/参数]2. 全局参数常用参数说明--quality/-q N音质等级0(128k)、1(320k)、2(16/44.1)、3(24/≤96k)、4(24/192k)--codec/-c FORMAT输出格式flac/mp3/aac/alac/opus--directory/-d PATH下载目录覆盖配置--max-workers N并发数默认4--skip-existing跳过已存在文件默认开启3. 核心子命令url直接下载链接资源最常用rip url https://open.qobuz.com/album/xxxxfile批量下载文本文件中的 URL每行一个ripfilelinks.txt--codecmp3search平台内搜索并交互式选择rip search tidal albumFleetwood Mac Rumourslastfm导入 Last.fm 歌单适配 Spotify/Apple Music 歌单rip lastfm https://www.last.fm/user/xxx/playlists/xxxconfig配置管理open/reset/listrip config reset四、8个实际应用案例案例1Qobuz 无损专辑下载24bit/44.1kHzrip--quality2--codecflac urlhttps://open.qobuz.com/album/0060253780968场景收藏经典专辑CD 级无损兼容性好案例2Tidal MQA 高解析专辑24bit/48kHzrip-q3-cflac urlhttps://tidal.com/album/12345678场景Hi-Res 收藏TidalMQA 母带音质案例3批量下载 Qobuz 歌单转 MP3 适配手机新建qobuz_playlists.txthttps://open.qobuz.com/playlist/123 https://open.qobuz.com/playlist/456执行ripfileqobuz_playlists.txt--codecmp3--quality1场景移动端归档320k MP3体积小案例4艺人全专辑归档Qobuz 完整目录rip search qobuz artistTaylor Swift--discography场景艺人全集收藏自动下载所有专辑/EP/单曲案例5SoundCloud 单曲转 AAC高兼容rip-caac urlhttps://soundcloud.com/artist/track场景独立音乐下载AAC 256kApple 设备适配案例6Last.fm 歌单映射Spotify 歌单转无损Spotify 歌单导入 Last.fm执行rip lastfmhttps://www.last.fm/user/xxx/playlists/123-q2场景跨平台歌单迁移自动匹配Qobuz/Tidal 无损案例7下载 Tidal 视频专辑含 MVrip urlhttps://tidal.com/video-album/123--download-videos场景音乐视频收藏1080p MV嵌入专辑目录案例8自定义目录结构按 艺人/专辑 归档rip urlhttps://open.qobuz.com/album/xxxx--directoryD:/Music/{artist}/{album}场景音乐库整理自动生成层级目录便于管理五、常见错误与解决方案1. 安装类错误错误command not found: rip原因Python Scripts 目录未加入环境变量解决将Python安装目录/Scripts添加到系统 PATH错误Windows 安装报错error: windows-curses解决pip install windows-curses或使用WSL22. 配置与认证错误错误Qobuz 登录失败Invalid credentials原因密码为明文需 MD5 哈希解决生成密码 MD5 填入config.toml错误配置文件创建失败Windows原因%APPDATA%\streamrip目录不存在解决手动创建目录或更新到v2.0.23. 下载与转码错误错误FFmpeg 未找到ffmpeg not found解决安装 FFmpeg 并加入 PATHWindows 推荐choco install ffmpeg错误转码 Opus 崩溃Windows原因FFmpeg 子进程兼容问题解决改用WSL2或选择MP3/FLAC格式错误Qobuz 下载IncompleteReadv2.2.0解决降级到v2.1.0或降低音质到q24. 功能限制与合规限制不支持 Spotify/Apple Music 直接下载DRM 加密替代通过Last.fm 歌单映射到 Qobuz/Tidal合规仅用于个人备份禁止商用/分发需持有有效订阅六、使用注意事项订阅优先必须拥有对应平台高级订阅否则无法下载无损内容。FFmpeg 必备转码、封面嵌入、视频下载依赖 FFmpeg。版本管理Windows 避免微软商店版 Python路径重定向问题。音质选择q216/44.1性价比最高人耳难以区分更高音质。批量限速--max-workers 2避免并发过高导致 IP 限流。元数据校验下载后用MusicBrainz Picard补全缺失标签。总结streamrip 是无损音乐收藏利器核心优势在于多平台统一管理、高音质保障、自动化能力。掌握其安装、配置与常用命令可高效构建个人音乐库结合 FFmpeg 与元数据工具可实现下载-转码-整理全流程自动化。《动手学PyTorch建模与应用:从深度学习到大模型》是一本从零基础上手深度学习和大模型的PyTorch实战指南。全书共11章前6章涵盖深度学习基础包括张量运算、神经网络原理、数据预处理及卷积神经网络等后5章进阶探讨图像、文本、音频建模技术并结合Transformer架构解析大语言模型的开发实践。书中通过房价预测、图像分类等案例讲解模型构建方法每章附有动手练习题帮助读者巩固实战能力。内容兼顾数学原理与工程实现适配PyTorch框架最新技术发展趋势。