Skip to main content

Download and display album art for mpd tracks.

Project 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

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

bum-0.1.2.tar.gz (4.2 kB view hashes)

Uploaded source

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