README.en.md · liyang/music-dl

# Music-dl: Listen to what you want

**[Music-dl](https://github.com/0xHJK/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](#supported-sources).

**Python3 Only. Python 3.5+ Recommended.**

English | [中文文档](https://github.com/0xHJK/music-dl/blob/master/README.md)

> Note: Some music sources may not be available in some countries and regions. If that happens, you could use Chinese proxies. See <https://github.com/0xHJK/Proxies> for public proxies.

- Support for lossless music
- Search for high-quality music with priority ( flac -> 320K -> 128K )
- Support for HTTP and SOCKS proxy
- Support for multithreading searching
- Support for merging and sorting results
- Support keyword highlighting

## Installation

Install using pip (Recommended)

```bash
$ pip3 install pymusic-dl
```

Manual

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

Use directly

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

# OR python3 music-dl
```

## Usage

```
$ music-dl --help
Usage: music-dl [OPTIONS]

Search and download music from netease, qq, kugou, baidu and xiami.
  Example: music-dl -k "Bruno Mars"

Options:
  --version            Show the version and exit.
  -k, --keyword TEXT   Query keyword
  -s, --source TEXT    Support for qq netease kugou baidu xiami flac
  -c, --count INTEGER  Searching count limit (default: 5)
  -o, --outdir TEXT    Output dir (default: current dir)
  -x, --proxy TEXT     Set proxy (like http://127.0.0.1:1087)
  -m, --merge          Sort and merge
  -v, --verbose        Verbose mode
  --help               Show this message and exit.
```

Example:

![](https://github.com/0xHJK/music-dl/raw/master/static/preview-en.png)

## Supported sources

| Music sources             | Abbreviation | Websites                  |
| ------------------------- | ------------ | ------------------------- |
| QQ Music                  | qq           | <https://y.qq.com/>       |
| Kugou Music               | kugou        | <http://www.kugou.com/>   |
| Netease Music             | netease      | <https://music.163.com/>  |
| Baidu Music               | baidu        | <http://music.baidu.com/> |
| Xiami Music               | xiami        | <https://www.xiami.com/>  |
| Lossless Music From Baidu | flac         | <http://music.baidu.com/> |

Welcome to submit plugins to support more music sources! Refer to the files in `extractors`.

![](https://github.com/0xHJK/music-dl/raw/master/static/fork.png)

## Credits

- <https://github.com/requests/requests>
- <https://github.com/soimort/you-get>
- <https://github.com/maicong/music>
- <https://github.com/YongHaoWu/NeteaseCloudMusicFlac>

## LICENSE

[MIT License](https://github.com/0xHJK/music-dl/blob/master/LICENSE)

liyang/music-dl

简介

发行版

贡献者

近期动态

liyang/music-dl .gitee-modal { width: 500px !important; }

简介

发行版

贡献者

近期动态

搜索帮助

liyang/music-dl