Join GitHub today
GitHub is home to over 28 million developers working together to host and review code, manage projects, and build software together.Sign up
mpd CLI client with OSD notifications through DBUS, XOSD or libnotify
Fetching latest commit…
Cannot retrieve the latest commit at this time.
|Failed to load latest commit information.|
This script acts as a client for a MPD server and displays information about the current song being played using one of the supported notification backends. The script doesn't need to be run as a daemon, instead it should be called on a per command basis (like mpc). This is useful when the script is bound to keyboard shortcuts. It may execute any command supported by the mpd module and additionaly "toggle" and "info". It supports three types of notification: > Desktop Notifications Specification through DBUS > XOSD through pyosd > Desktop Notifications Specification through libnotify Options can be passed as arguments or can also be fetched from a configuration file located by default at ~/.mpcosdrc, although a different path may be specified. The format of the configuration file is as follows: > Lines beginning with a "#" are ignored > key = value pairs accepted only Dependencies ========= python >= 2.5 python-mpdclient DBUS python-dbus an implementation of the Desktop Notifications Specification (e.g. notify-osd, xfce4-notifyd) XOSD pyosd LIBNOTIFY pynotify How to run it ========= Usage: mpc_osd.py <options> command Available options: -c, --config path to mpcosdrc configuration file -d, --display display notification to use: dbus | xosd | libnotify -s, --stack stack notifications, default is not stacked: libnotify always stacks notifications dbus does not stack notifications by default xosd does not support stacking -h, --host mpd server: tcp host | unix socket -p, --port mpd server tcp port --font xosd font --color xosd color --help show this message Available commands: play play current song pause pause current song toggle toggle play/pause stop stop current song info display information for the current song next next song in playlist previous previous song in playlist shuffle shuffle the playlist