Skip to main content

music downloader of

Project description

title: Sonimei


music downloader of

full supported in python3.7, macosx


  • parse netease playlist and download all
  • add nosetests
  • maybe more other sites from sonimei

Sites supported

  • qq
  • 163(netease)
  • kugou


  • search of single song name/artist
  • multiple songs split by #
  • download and auto add ID3 tag:cover
  • pagination supported
  • scan directory and update ID3 tags
  • check local file before search
  • the search result: json/html raw file, auto cached, until you delete them
  • the search candidates cached in the app lifecycle
  • colorful ui :)

new features

  • auto cache downloaded album covers, until you manually delete them
  • if you are listening NeteaseMusic, with snm -a will auto get the song's name and try download it, no need to copy/search anymore
  • if the NeteaseMusic with High-Qulity 320Kbps, will prompt to download it directly, but you can always skip it.
  • if some song download failed, will store it, and with snm -fs you can re-download it again.


cd <PATH>/Sonimei-Music
python install
# reinstall
pip/3 uninstall sonimei -y && python instal

sonime config/stored files/caches


config file: ~/.sonimei/sonimei.cfg

enabled = false
file_pth = /Users/lihe/.sonimei/sonimei.log
file_backups = 3
file_size = 5
level = 10
symbol = ☰☷☳☴☵☲☶☱

# install hacknerd font for full chars
symbols =  ,,,, ,,,,,,,,,,,,,,,,

save_dir = ~/Music/sonimei


edit config:sonimei.cfg


cached raw: ~/.crawler/

cached covers: ~/.crawler/

cached netease raw: ~/.crawler/


if installed snm can be called from terminal

new feature

A. snm -a will get current playing neteasemusic song, and try download
B. snm -fs will found all download failed songs, and try re-download them.


no params: snm

if no params supplied, will show -h hints

show help: snm -h/--help


search single song/artist


keys supported in search lifecycle

nN load next page

pP load previous page

bB go back one layer

1~10 the number, will download the song

s skip current song, if in scan mode

choose site: -s 163/kugou

but now, both not available I just use the sonimei site result, I don't use 163/kugou, I prefer qq, so I just leave it here.



will scan songs saved dir, and try to fix ID3 tags and cover


Project details

Download files

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

Source Distribution

sonimei- (17.3 kB view hashes)

Uploaded source

Built Distribution

sonimei- (31.5 kB view hashes)

Uploaded py3

Supported by

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