Music-dl: Listen to what you want

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 是一个基于Python3的命令行工具，可以从多个网站搜索和下载音乐，方便寻找音乐，解决不知道哪个网站有版权的问题。工具的本意是聚合搜索，API 是从公开的网络中获得，不是破解版，也听不了付费歌曲。

禁止将本工具用于商业用途，如产生法律纠纷与本人无关。

支持QQ音乐、网易云音乐、虾米音乐、酷狗音乐和百度音乐，查看支持的音乐源列表

注意: 部分音乐源在一些国家和地区不可用，可以考虑使用**大陆代理。获取公共代理的方式可以参考我的另一个项目https://github.com/0xHJK/Proxies，两分钟获得数千个有效代理。

部分歌曲支持无损音乐
优先搜索高品质音乐（flac -> 320K -> 128K）
支持 HTTP 和 SOCKS 代理
支持多线程搜索
支持搜索结果去重和排序
支持搜索关键字高亮
支持下载歌词和封面（部分）

注意：仅支持Python3，建议使用 Python3.5 以上版本

安装

使用pip安装（推荐，注意前面有一个py）：

$ pip3 install pymusic-dl

手动安装（最新）：

$ git clone https://github.com/0xHJK/music-dl.git
$ cd music-dl
$ python3 setup.py install

不安装直接运行：

$ git clone https://github.com/0xHJK/music-dl.git
$ cd music-dl
$ pip3 install -r requirements.txt
$ ./music-dl

# 或 python3 music-dl

在以下环境测试通过：

系统名称	系统版本	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

使用方式

$ 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   Keyword
  -s, --source TEXT    Supported music source: qq netease kugou baidu xiami
                       flac
  -c, --count INTEGER  Number of search results
  -o, --outdir TEXT    Output directory
  -x, --proxy TEXT     Proxy (e.g. http://127.0.0.1:1087)
  -m, --merge          对搜索结果去重和排序（默认去重）
  -v, --verbose        Verbose mode
  -l, --lyrics         同时下载歌词
  -p, --picture        同时下载封面
  --help               Show this message and exit.

默认搜索qq netease kugou baidu xiami flac，每个数量限制为5，保存目录为当前目录。
指定序号时可以使用1-5 7 10的形式。
默认对搜索结果排序和去重，排序顺序按照歌手和歌名排序，当两者都相同时保留最大的文件。
无损音乐歌曲数量较少，如果没有无损会显示320K或128K。
支持http代理和socks代理，格式形如-x http://127.0.0.1:1087或-x socks5://127.0.0.1:1086

示例（可以不写任何参数运行music-dl）：

支持的音乐源列表

音乐源	缩写	网址	音乐	封面	歌词
QQ音乐	qq	https://y.qq.com/	✓	✕	✕
酷狗音乐	kugou	http://www.kugou.com/	✓	✓	✕
网易云音乐	netease	https://music.163.com/	✓	✓	✕
百度音乐	baidu	http://music.baidu.com/	✓	✓	✓
虾米音乐	xiami	https://www.xiami.com/	✕	-	-
百度无损音乐	flac	http://music.baidu.com/	✓	✓	✓

欢迎提交插件支持更多音乐源！插件写法参考extractors中的文件

更新记录

2019-04-08 发布v2.2.1版本
2019-04-04 因为虾米音乐API变更，暂时屏蔽虾米搜索结果#22
2019-04-02 修复#18和#21的BUG，优化显示效果，支持部分音乐源歌词和封面下载
2019-03-11 开启默认支持所有音乐源，默认对搜索结果排序去重，优化显示效果，高亮搜索关键字和高品质音乐
2019-02 完成部分翻译（英语、德语、日语、克罗地亚语）感谢@anomie31 @DarkLinkXXXX @terorie的帮助，目前翻译尚未完善，欢迎提交PR改进翻译
2019-01-31 新增单元测试，集成发布，新增LOGO，新增小徽章，发布v2.1.0版本
2019-01-28 重写一半以上代码，全面优化，发布到pip库，发布v2.0.0版本
2019-01-26 支持http和socks代理，删除wget库，新增click库，发布v1.1版
2019-01-25 支持百度无损音乐
2019-01-24 优化交互、修复bug
2019-01-22 解决Windows兼容问题，支持多线程，发布v1.0版
2019-01-21 支持虾米音乐，支持去重
2019-01-20 支持百度音乐
2019-01-17 支持指定目录、数量、音乐源
2019-01-12 QQ音乐320K失效
2019-01-11 支持网易云音乐
2019-01-09 完成v0.1版，支持酷狗和QQ

提Issues说明

检查是否是最新的代码，检查是否是Python3.5+，检查依赖有没有安装完整。
说明使用的操作系统，例如Windows 10 x64
说明Python版本，以及是否使用了pyenv等虚拟环境
说明使用的命令参数、搜索关键字和出错的音乐源
使用-v参数重试，说明详细的错误信息，最好有截图
如果有新的思路和建议也欢迎提交

Credits 致谢

本项目受以下项目启发，参考了其中一部分思路，向这些开发者表示感谢。

打赏

欢迎丢馒头包子可乐手抓饼鸡翅秋刀鱼给我，谢谢~

LICENSE

MIT License

xiaozhanhun007/music-dl