Skip to content

Latest commit

 

History

History
136 lines (101 loc) · 4.36 KB

README.en.md

File metadata and controls

136 lines (101 loc) · 4.36 KB
Raw

Music-dl: Listen to what you want

music-dl

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 | 中文文档

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

Installation

Install using pip (Recommended)

$ pip3 install pymusic-dl

Manual

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

Use directly

$ 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 (Omitted some search results):

$ music-dl -k "Bruno Mars"

Searching Bruno Mars from ... QQ ... KUGOU ... NETEASE ... XIAMI ... BAIDU ...
---------------------------

 [  0 ]      QQ | 0:04:30 -  4.13MB - Mark Ronson、Bruno Mars - Uptown Funk - Uptown Special
...
 [  7 ]   KUGOU | 0:03:37 -  3.33MB - Bruno Mars - Talking to the Moon - It's Better If You Don't Understand
...
 [ 22 ]   BAIDU | 0:03:12 -  2.95MB - Bruno Mars - The lazy song - Enjoy the best karaoke's songs

---------------------------

Please enter the download serial number, support the format of 0 3-5 8, enter N to skip download
 >>: 7
 [  7 ]   KUGOU | 0:03:37 -  3.33MB - Bruno Mars - Talking to the Moon - It's Better If You Don't Understand
Downloading...  [####################################]  100%
Saved at：/tmp/Bruno Mars - Talking to the Moon.mp3

Advanced usage:

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.

Credits

LICENSE

MIT License