Metadata-Version: 2.1
Name: sonimei
Version: 0.1.4
Summary: music downloader of music.sonimei.cn
Home-page: https://github.com/coghost/Sonimei-Music
Author: lihe
Author-email: imanux@sina.com
License: GPL
Project-URL: Bug Reports, https://github.com/coghost/Sonimei-Music/issues
Project-URL: Source, https://github.com/coghost/Sonimei-Music
Keywords: sonimei,music downloader
Platform: UNKNOWN
Classifier: Programming Language :: Python :: 3.7
Description-Content-Type: text/x-rst
Requires-Dist: wget
Requires-Dist: izen
Requires-Dist: click
Requires-Dist: logzero
Requires-Dist: mutagen
Requires-Dist: lxml

=======
Sonimei
=======

Sonimei
-------

music downloader of `sonimei.cn <http://music.sonimei.cn/>`__

    full supported in python3.7, macosx

Todo
~~~~

-  [ ] parse netease playlist and download all
-  [ ] cache qq album
-  [ ] add nosetests

Sites supported
~~~~~~~~~~~~~~~

-  [x] qq
-  [x] netease

Capability
~~~~~~~~~~

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

Install
~~~~~~~

.. code:: bash

    cd <PATH>/Sonimei-Music
    python setup.py install

sonime config/stored files/caches
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

config
^^^^^^

config file: ``~/.sonimei/sonimei.cfg``

.. code:: python

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

    [pretty]
    # install hacknerd font for full chars
    symbols =  ,,,, ,,,,,,,,ﴖ,,,,,,,♪,

    [snm]
    save_dir = ~/Music/sonimei

songs
^^^^^

edit config:\ ``sonimei.cfg``

caches
^^^^^^

cached raw: ``~/.crawler/music.sonimei.cn/``

cached netease raw: ``~/.crawler/music.163.com``

usage
~~~~~

if installed ``snmcli`` can be called from terminal

no params: ``snmcli``
^^^^^^^^^^^^^^^^^^^^^

if no params supplied, will show ``-h`` hints

show help: ``snmcli -h/--help``
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

.. figure:: https://github.com/coghost/Sonimei-Music/blob/master/docs/images/help.png
   :alt: help

   help
search single song/artist
^^^^^^^^^^^^^^^^^^^^^^^^^

.. figure:: https://github.com/coghost/Sonimei-Music/blob/master/docs/images/search_n_b.png
   :alt: search\_n\_b

   search\_n\_b
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 netease
^^^^^^^^^^^^^^^^^^^^^^^

.. figure:: https://github.com/coghost/Sonimei-Music/blob/master/docs/images/from_netease.png
   :alt: from\_netease

   from\_netease
scan
^^^^

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

.. figure:: https://github.com/coghost/Sonimei-Music/blob/master/docs/images/scan.png
   :alt: scan

   scan


