Home

Awesome

Music-dl: Listen to what you want

<p align="center"> <a href="https://github.com/0xHJK/music-dl"> <img src="https://github.com/0xHJK/music-dl/raw/master/static/logo.png" height="400" alt="music-dl"> </a> </p> <hr> <p align="center"> <a href="https://travis-ci.org/0xHJK/music-dl"> <img src="https://travis-ci.org/0xHJK/music-dl.svg?branch=master"> </a> <a><img src="https://img.shields.io/pypi/pyversions/pymusic-dl.svg"></a> <a href="https://codecov.io/gh/0xHJK/music-dl"> <img src="https://codecov.io/gh/0xHJK/music-dl/branch/master/graph/badge.svg"/> </a> <a href="https://github.com/0xHJK/music-dl/releases"> <img src="https://img.shields.io/github/release/0xHJK/music-dl.svg"> </a> <a><img src="https://img.shields.io/github/license/0xHJK/music-dl.svg"></a> </p>

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群:785798493

最近API封杀有点多,个人有点维护不过来,需要大家帮忙更新。查看 支持的音乐源列表

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

功能

注意:仅支持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版本
macOS10.143.7.0
macOS10.133.7.0
WindowsWindows 7 x643.7.2
WindowsWindows 10 x643.7.2
Ubuntu16.04 x643.5.2

使用方式

v3.0预览版命令有较大的改变,建议先查看帮助

$ 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    搜索关键字,歌名和歌手同时输入可以提高匹配(如 空帆船 朴树)
  -u, --url TEXT        通过指定的歌曲URL下载音乐
  -p, --playlist TEXT   通过指定的歌单URL下载音乐
  -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              同时下载歌词
  --cover               同时下载封面
  --nomerge             不对搜索结果列表排序和去重
  --help                Show this message and exit.

示例:

支持的音乐源列表

音乐源缩写网址有效无损320K封面歌词歌单单曲
QQ音乐qqhttps://y.qq.com/--
酷狗音乐kugouhttp://www.kugou.com/----
网易云音乐neteasehttps://music.163.com/-
咪咕音乐miguhttp://www.migu.cn/
百度音乐baiduhttp://music.baidu.com/-
虾米音乐xiamihttps://www.xiami.com/----

-表示不一定支持,表示部分或完全支持,表示尚未支持

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

更新记录

提Issues说明

Credits 致谢

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

用爱发电

维护不易,欢迎扫描恰饭二维码

LICENSE

MIT License