Skip to main content
Python Software Foundation 20th Year Anniversary Fundraiser  Donate today!

Search and download music from netease, qq, kugou, baidu and xiami.

Project description

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

Note: Some music sources may not be available in some countries and regions. If that happens, you could use Chinese proxies. See 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


Install using pip (Recommended)

$ pip3 install pymusic-dl


$ git clone
$ cd music-dl
$ python3 install

Use directly

$ git clone
$ cd music-dl
$ pip3 install -r requirements.txt
$ ./music-dl

# OR python3 music-dl


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

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

  --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
  -m, --merge          Sort and merge
  -v, --verbose        Verbose mode
  --help               Show this message and exit.


Supported sources

Music sources Abbreviation Websites
QQ Music qq
Kugou Music kugou
Netease Music netease
Baidu Music baidu
Xiami Music xiami
Lossless Music From Baidu flac

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



MIT License

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for pymusic-dl, version 2.2.0
Filename, size File type Python version Upload date Hashes
Filename, size pymusic_dl-2.2.0-py3-none-any.whl (25.6 kB) File type Wheel Python version py3 Upload date Hashes View
Filename, size pymusic-dl-2.2.0.tar.gz (17.7 kB) File type Source Python version None Upload date Hashes View

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring DigiCert DigiCert EV certificate Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page