Metadata-Version: 1.2
Name: bum
Version: 0.1.2
Summary: Download and display album art for mpd tracks.
Home-page: https://github.com/dylanaraps/bum
Author: Dylan Araps
Author-email: dylan.araps@gmail.com
License: MIT
Download-URL: https://github.com/dylanaraps/bum/archive/0.1.2.tar.gz
Description: 🎵 bum
        =====
        
        |PyPI| |MIT licensed| |Build Status|
        
        ``bum`` is a daemon that downloads album art for songs playing in
        ``mpd``/``mopidy`` and displays them in a little window. ``bum`` doesn't
        loop on a timer, instead it waits for ``mpd``/``mopidy`` to send a
        ``player`` event. When it receives a ``player`` event it wakes up and
        downloads album art for the current playing track. This makes ``bum``
        lightweight and makes it idle at ``~0%`` CPU usage.
        
        ``bum`` uses `musicbrainz <https://musicbrainz.org/>`__ to source and
        download cover art, if an album is missing it's cover art you can easily
        create an account and fill in the data yourself. ``bum`` outputs a
        ``release-id`` which you can use to find the exact entry on musicbrainz.
        
        Note: ``bum`` is meant to be used with files that don't have embedded
        album art (``mopidy-spotify``).
        
        .. figure:: http://i.imgur.com/uKomDoL.gif
           :alt: showcase
        
           showcase
        
        Dependencies
        ------------
        
        -  ``python 3.6+``
        -  ``python-mpv``
        -  ``python-mpd2``
        -  ``musicbrainzngs``
        
        Installation
        ------------
        
        .. code:: py
        
            pip install bum
        
        Usage
        -----
        
        .. code:: sh
        
            usage: bum [-h] [--size "px"] [--cache_dir "/path/to/dir"] [--version]
        
            bum - Download and display album art for mpd tracks.
        
            optional arguments:
              -h, --help            show this help message and exit
              --size "px"           what size to display the album art in.
              --cache_dir "/path/to/dir"
                                    Where to store the downloaded cover art.
              --version             Print "bum" version.
        
        .. |PyPI| image:: https://img.shields.io/pypi/v/bum.svg
           :target: https://pypi.python.org/pypi/bum/
        .. |MIT licensed| image:: https://img.shields.io/badge/license-MIT-blue.svg
           :target: ./LICENSE.md
        .. |Build Status| image:: https://travis-ci.org/dylanaraps/bum.svg?branch=master
           :target: https://travis-ci.org/dylanaraps/bum
        
Platform: UNKNOWN
Classifier: Environment :: X11 Applications
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: POSIX :: Linux
Classifier: Programming Language :: Python :: 3.6
Requires-Python: >=3.6
