semvec/pypi-packages huggingface dataset:
playlistfromsong 2.2.2
Generate an offline playlist from a single song
License: MIT license
Keywords: playlistfromsong

================
playlistfromsong
================


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

.. image:: https://img.shields.io/travis/schollz/playlistfromsong.svg
        :target: https://travis-ci.org/schollz/playlistfromsong

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

.. image:: https://pyup.io/repos/github/schollz/playlistfromsong/shield.svg
     :target: https://pyup.io/repos/github/schollz/playlistfromsong/
     :alt: Updates


Generate an offline playlist from a single song.

Features
---------

- Similar song matching using last.fm or Spotify
- Automatic downloading of songs
- Builtin music server for webhooks

Quickstart
------------

First install `ffmpeg`_:

::

        sudo apt-get install ffmpeg    (DEBIAN)
        brew install ffmpeg            (MAC)

.. _ffmpeg: https://ffmpeg.org/download.html

Install with ``pip``::

    pip install playlistfromsong


Download a playlist of 5 songs similar to Miles Davis' *Blue In Green*::

    playlistfromsong --song 'Miles Davis Blue In Green' --num 5 -f /path/to/save

.. image:: http://i.imgur.com/ldVHZcc.gif
     :target: http://i.imgur.com/ldVHZcc.gif
     :alt: Demo1

Use a bearer token ``--bearer`` to use Spotify to find suggestions::

    playlistfromsong --song 'Miles Davis Blue In Green' --num 5 -f /path/to/save -b 'BEARER'

.. image:: http://i.imgur.com/uzEEEFh.gif
     :target: http://i.imgur.com/uzEEEFh.gif
     :alt: Demo1


For more complete usage, see the docs.


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

2.0.0 (2017-07-04)
------------------

* New ``--server`` option for starting a music server

1.0.0 (2017-06-25)
------------------

* Move to cookiecutter for improved packaging and tests

0.21.0 (2017-03-29)
------------------

* First stable release