Music-dl is a command line tool which helps you search and download music from multiple sources.
Support for QQ music, Netease music, Xiami music, Kugou music and Baidu music. See supported sources.
Python3 Only. Python 3.5+ Recommended.
English | 中文文檔
Music-dl 是一個(gè)基于Python3的命令行工具，可以從多個(gè)網(wǎng)站搜索和下載音樂(lè)俄烁，方便尋找音樂(lè)，解決不知道哪個(gè)網(wǎng)站有版權(quán)的問(wèn)題及志。工具的本意是聚合搜索但汞，API 是從公開(kāi)的網(wǎng)絡(luò)中獲得，不是破解版，也聽(tīng)不了付費(fèi)歌曲。
禁止將本工具用于商業(yè)用途玄糟，如產(chǎn)生法律糾紛與本人無(wú)關(guān)，如有侵權(quán)袄秩，請(qǐng)聯(lián)系我刪除阵翎。
最近API封殺有點(diǎn)多，個(gè)人有點(diǎn)維護(hù)不過(guò)來(lái)之剧，需要大家?guī)兔Ω鹿馈２榭?支持的音樂(lè)源列表
注意: 部分音樂(lè)源在一些國(guó)家和地區(qū)不可用，可以考慮使用中國(guó)大陸代理背稼。獲取公共代理的方式可以參考我的另一個(gè)項(xiàng)目https://github.com/0xHJK/Proxies贰军，兩分鐘獲得數(shù)千個(gè)有效代理。
功能
- 部分歌曲支持無(wú)損音樂(lè)
- 優(yōu)先搜索高品質(zhì)音樂(lè)（無(wú)損 -> 320K -> 128K）
- 支持 HTTP 和 SOCKS 代理
- 支持多線程搜索
- 支持搜索結(jié)果去重和排序
- 支持搜索關(guān)鍵字高亮
- 支持下載歌詞和封面（部分）
注意：僅支持Python3蟹肘，建議使用 Python3.5 以上版本
安裝
使用pip安裝（推薦词疼，注意前面有一個(gè)py）：
$ pip3 install pymusic-dl
手動(dòng)安裝（最新）：
$ git clone https://github.com/0xHJK/music-dl.git
$ cd music-dl
$ python3 setup.py install
不安裝直接運(yùn)行：
$ git clone https://github.com/0xHJK/music-dl.git
$ cd music-dl
$ pip3 install -r requirements.txt
$ ./music-dl
# 或 python3 music-dl
在以下環(huán)境測(cè)試通過(guò)：
| 系統(tǒng)名稱 | 系統(tǒng)版本 | Python版本 |
|---|---|---|
| macOS | 10.14 | 3.7.0 |
| macOS | 10.13 | 3.7.0 |
| Windows | Windows 7 x64 | 3.7.2 |
| Windows | Windows 10 x64 | 3.7.2 |
| Ubuntu | 16.04 x64 | 3.5.2 |
使用方式
v3.0預(yù)覽版命令有較大的改變，建議先查看幫助
$ music-dl --help
Usage: music-dl [OPTIONS]
Search and download music from netease, qq, kugou, baidu and xiami.
Example: music-dl -k "周杰倫"
Options:
--version Show the version and exit.
-k, --keyword TEXT 搜索關(guān)鍵字帘腹，歌名和歌手同時(shí)輸入可以提高匹配（如 空帆船 樸樹(shù)）
-u, --url TEXT 通過(guò)指定的歌曲URL下載音樂(lè)
-p, --playlist TEXT 通過(guò)指定的歌單URL下載音樂(lè)
-s, --source TEXT Supported music source: qq netease kugou baidu
-n, --number INTEGER Number of search results
-o, --outdir TEXT Output directory
-x, --proxy TEXT Proxy (e.g. http://127.0.0.1:1087)
-v, --verbose Verbose mode
--lyrics 同時(shí)下載歌詞
--cover 同時(shí)下載封面
--nomerge 不對(duì)搜索結(jié)果列表排序和去重
--help Show this message and exit.
- 默認(rèn)搜索
qq netease kugou baidu贰盗，每個(gè)數(shù)量限制為5，保存目錄為當(dāng)前目錄阳欲。 - 指定序號(hào)時(shí)可以使用
1-5 7 10的形式舵盈。 - 默認(rèn)對(duì)搜索結(jié)果排序和去重，排序順序按照歌手和歌名排序球化，當(dāng)兩者都相同時(shí)保留最大的文件秽晚。
- 無(wú)損音樂(lè)歌曲數(shù)量較少，如果沒(méi)有無(wú)損會(huì)顯示320K或128K赊窥。
- 支持http代理和socks代理爆惧，格式形如
-x http://127.0.0.1:1087或-x socks5://127.0.0.1:1086
示例：
支持的音樂(lè)源列表
| 音樂(lè)源 | 縮寫 | 網(wǎng)址 | 有效 | 無(wú)損 | 320K | 封面 | 歌詞 | 歌單 | 單曲 |
|---|---|---|---|---|---|---|---|---|---|
| QQ音樂(lè) | https://y.qq.com/ | ? | - | - | ? | ? | ? | ? | |
| 酷狗音樂(lè) | kugou | http://www.kugou.com/ | ? | - | - | - | ? | ? | ? |
| 網(wǎng)易云音樂(lè) | netease | https://music.163.com/ | ? | - | ? | ? | ? | ? | ? |
| 咪咕音樂(lè) | migu | http://www.migu.cn/ | ? | ? | ? | ? | ? | ? | ? |
| 百度音樂(lè) | baidu | http://music.baidu.com/ | ? | - | ? | ? | ? | ? | ? |
| 蝦米音樂(lè) | xiami | https://www.xiami.com/ | ? | - | - | - | - | ? | ? |
-表示不一定支持，?表示部分或完全支持锨能，?表示尚未支持
歡迎提交插件支持更多音樂(lè)源扯再！插件寫法參考addons中的文件
[圖片上傳失敗...(image-fbc801-1607052253118)]
更新記錄
- 2019-08-25 修復(fù)了QQ音樂(lè)、網(wǎng)易云音樂(lè)址遇、酷狗音樂(lè)熄阻，新增咪咕音樂(lè)
- 2019-08-03 修復(fù)了一些bug，屏蔽了不支持的源倔约，目前僅百度音樂(lè)可用
- 2019-06-13 重新增加蝦米音樂(lè)高品質(zhì)音樂(lè)支持秃殉，感謝群友0.0提供的API
- 2019-06-11 v3.0預(yù)覽版，代碼重構(gòu)，支持網(wǎng)易云音樂(lè)歌單和單曲下載钾军，支持百度高品質(zhì)音樂(lè)
- 2019-04-08 發(fā)布v2.2.1版本
- 2019-04-04 因?yàn)槲r米音樂(lè)API變更鳄袍，暫時(shí)屏蔽蝦米搜索結(jié)果#22
- 2019-04-02 修復(fù)#18和#21的BUG，優(yōu)化顯示效果吏恭，支持部分音樂(lè)源歌詞和封面下載
- 2019-03-11 開(kāi)啟默認(rèn)支持所有音樂(lè)源拗小，默認(rèn)對(duì)搜索結(jié)果排序去重，優(yōu)化顯示效果樱哼，高亮搜索關(guān)鍵字和高品質(zhì)音樂(lè)
- 2019-02 完成部分翻譯（英語(yǔ)哀九、德語(yǔ)、日語(yǔ)搅幅、克羅地亞語(yǔ)）感謝@anomie31 @DarkLinkXXXX @terorie的幫助阅束，目前翻譯尚未完善，歡迎提交PR改進(jìn)翻譯
- 2019-01-31 新增單元測(cè)試茄唐，集成發(fā)布息裸，新增LOGO，新增小徽章琢融，發(fā)布v2.1.0版本
- 2019-01-28 重寫一半以上代碼界牡，全面優(yōu)化，發(fā)布到pip庫(kù)漾抬，發(fā)布v2.0.0版本
- 2019-01-26 支持http和socks代理宿亡，刪除wget庫(kù)，新增click庫(kù)纳令，發(fā)布v1.1版
- 2019-01-25 支持百度無(wú)損音樂(lè)
- 2019-01-24 優(yōu)化交互挽荠、修復(fù)bug
- 2019-01-22 解決Windows兼容問(wèn)題，支持多線程平绩，發(fā)布v1.0版
- 2019-01-21 支持蝦米音樂(lè)圈匆，支持去重
- 2019-01-20 支持百度音樂(lè)
- 2019-01-17 支持指定目錄、數(shù)量捏雌、音樂(lè)源
- 2019-01-12 QQ音樂(lè)320K失效
- 2019-01-11 支持網(wǎng)易云音樂(lè)
- 2019-01-09 完成v0.1版跃赚，支持酷狗和QQ
提Issues說(shuō)明
- 檢查是否是最新的代碼，檢查是否是Python3.5+性湿，檢查依賴有沒(méi)有安裝完整纬傲。
- 說(shuō)明使用的操作系統(tǒng)，例如Windows 10 x64
- 說(shuō)明Python版本肤频，以及是否使用了pyenv等虛擬環(huán)境
- 說(shuō)明使用的命令參數(shù)叹括、搜索關(guān)鍵字和出錯(cuò)的音樂(lè)源
- 使用
-v參數(shù)重試，說(shuō)明詳細(xì)的錯(cuò)誤信息宵荒，最好有截圖 - 如果有新的思路和建議也歡迎提交
Credits 致謝
本項(xiàng)目受以下項(xiàng)目啟發(fā)汁雷，參考了其中一部分思路净嘀，向這些開(kāi)發(fā)者表示感謝。
- https://github.com/requests/requests
- https://github.com/soimort/you-get
- https://github.com/maicong/music
- https://github.com/YongHaoWu/NeteaseCloudMusicFlac
- https://github.com/darknessomi/musicbox
