bum

bum

🎵 Download and display album art for mpd/mopidy tracks.

Showing:

Popularity

Downloads/wk

0

GitHub Stars

119

Maintenance

Last Commit

2mos ago

Contributors

7

Package

Dependencies

0

License

MIT

Categories

Readme

🎵 bum

PyPI MIT licensed Build Status Donate

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 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).

showcase

Dependencies

  • python 3.6+
  • python-mpv
  • python-mpd2
  • musicbrainzngs

Installation

pip3 install --user bum

Usage

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.
  --port                Use a custom mpd port.

Donations will allow me to spend more time working on bum.

If you like bum and want to give back in some way you can donate here:

https://patreon.com/dyla

Rate & Review

Great Documentation0
Easy to Use0
Performant0
Highly Customizable0
Bleeding Edge0
Responsive Maintainers0
Poor Documentation0
Hard to Use0
Slow0
Buggy0
Abandoned0
Unwelcoming Community0
100
No reviews found
Be the first to rate

Alternatives

No alternatives found

Tutorials

No tutorials found
Add a tutorial