musicdl 轻量级音乐下载器

musicdl 是什么

musicdl 是一个用纯 Python 编写的轻量级音乐下载器，目标是把「搜索 + 下载」这件事做得简单、清晰、易扩展。它通过统一的 MusicClient 抽象对接数十个音乐与有声读物平台，包括网易云音乐、QQ音乐、酷狗、酷我、咪咕、千千静听、汽水音乐、Bilibili、街声、喜马拉雅、懒人听书、荔枝FM、蜻蜓FM、JOOX、TIDAL、YouTube、Apple Music、Spotify、Qobuz、SoundCloud 等。

项目定位偏向个人收听、收藏管理，以及音乐信息检索、数据采集与可复现研究等学术/教育用途。

核心特性

• 纯 Python 实现：依赖少、代码可读性高，便于学习和改造。
• 多平台统一接口：不同平台以独立模块实现，对外暴露一致的搜索与下载方式。
• 模块化扩展：新增平台只需在 musicdl/modules/sources/ 下实现对应的 MusicClient。
• 持续维护：定期修复第三方接口失效问题，并替换已下线的平台。
• 配套资源：提供 ReadTheDocs 文档与浏览器端 Demo「MusicSquare 音乐广场」。

基本使用思路

安装后可通过 Python 代码调用，示意如下（具体参数请以官方文档为准）：

from musicdl import musicdl

config = {'logfilepath': 'musicdl.log', 'savedir': 'downloaded'}
target_srcs = ['kugou', 'netease', 'qqmusic']
client = musicdl.musicdl(config=config)
client.run(target_srcs, search_key='关键词')

适用与注意事项

• 适合作为爬虫、接口逆向、音乐信息检索的学习项目。
• 仅与公开可访问的网页端点交互，不托管、不存储任何受版权保护的内容。
• 禁止商业使用，不得用于绕过付费墙、DRM 或订阅限制；如需付费内容请通过官方渠道获取。
• 第三方接口随时可能变化，遇到失效平台可关注仓库更新或自行适配。