Skip to main content

Download and display album art for mpd tracks.

Project description

# 🎵 bum

`bum` is a daemon that downloads album art for songs playing in `mpd` and displays them in a little window. `bum` doesn't loop on a timer, instead you can send it `SIGUSR1` to make it wake up and download album art for the current playing track. This makes `bum` lightweight and makes it idle at `~0%` CPU usage.

Note: `bum` is meant to be used with files that don't have embedded album art (`mopidy-spotify`).


## Dependencies

- `python 3.6+`
- `python-mpv`
- `musicbrainzngs`
- `mpc`

## Installation

pip install 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.

## Customization

### ncmpcpp

You can configure `ncmpcpp` to send `SIGUSR1` to `bum` on every song change.

# .ncmpcpp/config

# Execute bum on song change.
execute_on_song_change = "pkill -USR1 bum"

### shell

You can use `mpc idleloop` to send `SIGUSR1` to `bum` on every song change.

# Wake up bum on song change.
while :; do
mpc idleloop player | pkill -USR1 bum$

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for bum, version 0.0.2
Filename, size File type Python version Upload date Hashes
Filename, size bum-0.0.2.tar.gz (3.8 kB) File type Source Python version None Upload date Hashes View

Supported by

Pingdom Pingdom Monitoring Google Google Object Storage and Download Analytics Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page