Skip to main content

mpdnotify - get notification when changing song

Project description


Notifies when mpd's song changes.



It has been test on Debian 9.5, it shall work on any other Linux distribution with Python >= 3.2. Please let me now if it works on OSX.


For now, mpdnotify is not a PyPa's package.




git clone
cd mpdnotify
pip3 install -r requirements.txt -e .


A few arguments can be passed to mpdnotify :

  • -a / --appname : specifies the app name for notify-send.
  • -c / --config : path to the configuration file.
  • --host : mpd's address.
  • -m / --musicdir : path to mpd's music library folder.
  • -p / --port : mpd's server port.
  • -o / --oneshot : send a notification and exit immediately.

All this arguments can be save in a configuration file, please see mpdnotifyrc.sample for further informations.

Once running, mpdnotify will wait for the next song to send a notification (unless -o / --oneshot has been passed). Cover is used as notification icon if a file (cover/front/album).(png/jpg) is find in the same folder as the music file.


  • Add a test suite.
  • Allow user to change the notification format.
  • If cover cannot be found as an image, look at the tags.

Project details

Release history Release notifications | RSS feed

This version


Download files

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

Files for mpdnotify, version 1.0
Filename, size File type Python version Upload date Hashes
Filename, size mpdnotify-1.0.tar.gz (4.9 kB) File type Source Python version None Upload date Hashes View
Filename, size mpdnotify-1.0-py3-none-any.whl (5.8 kB) File type Wheel Python version py3 Upload date Hashes View

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Huawei Huawei PSF Sponsor Microsoft Microsoft PSF Sponsor NVIDIA NVIDIA PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page