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
=====
|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
Release history Release notifications | RSS feed
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)