CharlesPikachu / musicdl

📚 Documents: musicdl.readthedocs.io 
 🎧 Live Demo · MusicSquare (音乐广场) 
 🛠 Source Code (MusicSquare) 
 MusicSquare is a browser-based music playground — search, play, and download tracks directly in your browser. 
 ⚠️ For learning and testing only: please respect copyright and the terms of each music platform.
 学习收获更多有趣的内容, 欢迎关注微信公众号：Charles的皮卡丘 
# 🎉 What's New
- 2026-10-16: Released musicdl v2.14.2 — performed monthly maintenance on common music clients and fixed broken API integrations in four affected clients.
- 2026-10-10: Released musicdl v2.14.1 — monthly maintenance of third-party music clients: fixed API issues on four platforms and replaced three discontinued ones with similar alternatives.
- 2026-09-23: Released musicdl v2.14.0 — fix several bugs in Apple Music, and refactor parts of the third-party parsing interfaces for Qobuz, Deezer, and TIDAL Music.
# 🎵 Introduction
A lightweight music downloader built entirely in pure Python, designed for simplicity, clarity, and ease of use. 
It is suitable for personal listening workflows, collection management, and academic or educational purposes such as music information retrieval, data collection, and reproducible research. 
With a clean codebase and minimal dependencies, the project is easy to use, extend, and study. 
If you find this project useful, please consider giving it a ⭐ star to support ongoing development, help more people discover it, and stay updated with future improvements.
# ⚠️ Disclaimer
This repository is provided solely for educational and research purposes. Commercial use is prohibited. 
The software only interacts with publicly accessible web endpoints and does not host, store, mirror, or distribute any copyrighted or proprietary content. 
No executables are distributed with this repository. Redistribution, resale, or bundling of this software (or any derivative packaged distribution) without explicit permission is strictly prohibited. 
Access to paid, subscription, or otherwise restricted content must be obtained through authorized channels (*e.g.*, purchase or subscription via the relevant service). Use of this software to circumvent paywalls, DRM, licensing restrictions, or other access controls is strictly prohibited. 
If you are a copyright or rights holder and believe that this repository infringes your rights, please contact me with sufficient detail (*e.g.*, relevant URLs and proof of ownership), and I will promptly investigate and take appropriate action, which may include removal of the referenced material.
# 🎧 Supported Music Client
| Category | MusicClient (EN) | MusicClient (CN) | 🔎 Search | ⬇️ Download | Code Snippet |
| :-- | :-- | :-- | :--: | :--: | :-- |
| **Platforms in Greater China** | BilibiliMusicClient | Bilibili音乐 | ✅ | ✅ | bilibili.py |
| | BodianMusicClient | 波点音乐 | ✅ | ✅ | bodian.py |
| | FiveSingMusicClient | 5SING音乐 | ✅ | ✅ | fivesing.py |
| | KugouMusicClient | 酷狗音乐 | ✅ | ✅ | kugou.py |
| | KuwoMusicClient | 酷我音乐 | ✅ | ✅ | kuwo.py |
| | Migu