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`).
![showcase](http://i.imgur.com/uKomDoL.gif)
## Dependencies
- `python 3.6+`
- `python-mpv`
- `musicbrainzngs`
- `mpc`
## Installation
```py
pip install bum
```
## Usage
```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.
```
## 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.
```sh
#!/bin/sh
# Wake up bum on song change.
while :; do
mpc idleloop player | pkill -USR1 bum$
done
```
`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`).
![showcase](http://i.imgur.com/uKomDoL.gif)
## Dependencies
- `python 3.6+`
- `python-mpv`
- `musicbrainzngs`
- `mpc`
## Installation
```py
pip install bum
```
## Usage
```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.
```
## 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.
```sh
#!/bin/sh
# Wake up bum on song change.
while :; do
mpc idleloop player | pkill -USR1 bum$
done
```
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.0.2.tar.gz
(3.8 kB
view hashes)