Display MPD's current song's cover art on top of wallpaper
Project description
mpdbg
About
mpdbg is a program that listens to a Music Player Daemon and changes the desktop wallpaper image depending on the current song. If the song has a cover art image, it will be drawn on top of wallpaper. A couple of effects can be applied to original wallpaper in this case, if user chooses so. If the current song doesn't have a cover art image, the original wallpaper wil be displayed.
Check out mpdbg's homepage for downloads and such.
Installation
Install from PyPI:
pip install --user mpdbg
You also can install the program by downloading mpdbg-x.y.z-py3-none-any.whl from project's releases page and running:
pip install --user ./mpdbg-x.y.z-py3-none-any.whl
Either of these commands would install mpdbg for current user and an executable script to ~/.local/bin/mpdbg.
Building
Install poetry and execute following in the project directory:
poetry build
Usage
Usage: mpdbg run [OPTIONS]
run
Options:
-w, --wallpaper FILE The image file to use as wallpaper
[required]
-s, --wallpaper-setter TEXT The wallpaper setter command. Use $image in
command to insert quoted path to the image
file. [required]
-e, --effect [blur|grayscale] Effect to apply to wallpaper when displaying
an album cover (multiple can be specified)
-l, --log-level [debug|info|warning|error|critical]
Set log level.
--help Show this message and exit.
To set MPD socket location or address and port, use environment variables MPD_HOST and MPD_PORT. If they're not set, address localhost and port 6600 will be used. You can set them in ~/.profile, for example. Here's couple of examples:
# connecting to a tcp port
export MPD_HOST=localhost
export MPD_PORT=6600
# connecting to a unix socket
export MPD_HOST=/path/to/mpd.socket
# using a password
export MPD_HOST=MYPASSWORD@localhost
export MPD_PORT=6600
Example for using mpdbg with swww wallpaper setter:
mpdbg run -w ~/wallpaper.png -s 'swww img --transition-type center $image' -e blur
The command above would use ~/wallpaper.png as wallpaper and swww as wallpaper setter. The wallpaper would also be blurred when displaying a cover art image on top of it.
Project details
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.