Metadata-Version: 2.1
Name: musicftdl
Version: 0.1.1
Summary: A CLI tool to download music of Jay Chou and other singers with full song tags.
Home-page: https://github.com/lonsty/musicftdl
Author: Allen Shaw
Author-email: lonsty@sina.com
License: MIT license
Keywords: musicftdl
Platform: UNKNOWN
Classifier: Development Status :: 2 - Pre-Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Natural Language :: English
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Requires-Python: >=3.6
Requires-Dist: Click (>=7.0)
Requires-Dist: eyeD3 (>=0.9.5)
Requires-Dist: pydantic (>=1.5.1)
Requires-Dist: requests (>=2.23.0)
Requires-Dist: prettytable (>=2.0.0)
Requires-Dist: python-dateutil (>=2.8.1)

=========================
Music Full Tag Downloader
=========================


.. image:: https://img.shields.io/pypi/v/musicftdl.svg
        :target: https://pypi.python.org/pypi/musicftdl

.. image:: https://img.shields.io/travis/lonsty/musicftdl.svg
        :target: https://travis-ci.com/lonsty/musicftdl

.. image:: https://readthedocs.org/projects/musicftdl/badge/?version=latest
        :target: https://musicftdl.readthedocs.io/en/latest/?badge=latest
        :alt: Documentation Status




A CLI tool to download music of Jay Chou and other singers with full song tags.


* Free software: MIT license
* Documentation: https://musicftdl.readthedocs.io.


Features
--------

* **Search**: Search songs by keywords.
* **Download**: Download song(s) by singer/album/song mid or keyword.
* **Tag**: After downloading, tags are automatically added to the song (eg artist, album, sum of tracks, album cover image, release date), this feature is only available for `MP3` format songs.

Usage
-----

.. code-block:: console

    $ pip install -U musicftdl

Example for downloading all `周杰伦's` songs with `320k` bitrate, and save to the directory of `/mnt/e/Music/musicftdl` :

.. code-block:: console

    $ musicftdl download -d /mnt/e/Music/musicftdl -f 320 -s 0025NhlN2yWrP4

.. image:: docs/img/SC01.png

.. image:: docs/img/SC02.png

.. image:: docs/img/SC03.png

.. image:: docs/img/SC04.png


=======
History
=======

0.1.1 (2021-04-11)
------------------

Fixed bug:

* Upgrade dependency `prettytable>=2.0.0`.

0.1.0 (2020-05-11)
------------------

New feature:

* Download songs of selected types of albums (Studio Album, EP Single, Live Album, Others).
* Print error messages to help users troubleshoot.

Fixed bug:

* Fixed an issue where empty files were created when songs could not be downloaded.

0.1.0a (2020-05-10)
-------------------

* First release on PyPI.


