mpdbg 0.1.3

Display MPD's current song's cover art on top of wallpaper

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.

Example for Windows CMD prompt using WallpaperChanger as wallpaper setter:

mpdbg run -w C:\wallpaper.png -s "C:\WallpaperChanger.exe $image 4" -e blur