Skip to main content

Control various media players from a single command line interface.

Project description

player_do provides a simple command line interface to control whatever media player is running on your computer.

It is designed to allow you to configure the media buttons on your keyboard (play, pause, next etc.) to Do The Right Thing without having to change anything if you switch to a different media player.

It also includes commands ‘install_gnome’,’install_mate’, and ‘install_gnome3’ to help set up keyboard shortcuts initially on GNOME2/Mate/GNOME3/Cinnamon. It can, however, be used with any system where you can map keyboard shortcuts to commands.

The currently supported media players can be seen by running ‘player_do help’. Those that have been tested include the following:

  • Audacious

  • Amarok

  • Banshee

  • Clementine

  • cmus

  • Exaile

  • Guayadeque

  • moc

  • Quodlibet

  • Rhythmbox

  • shell-fm

  • VLC (2.0 and later)

Many other players will be supported due to support for the MPRIS DBUS protocol, without a specific backend. If you only need support for those players, consider using MPRIS-remote.

To add more supported programs, see the existing code in the ‘backends’ directory. Patches gratefully received!

Source code: http://bitbucket.org/spookylukey/playerdo/src

Bug tracking: http://bitbucket.org/spookylukey/playerdo/issues

Change log

Version 0.7

  • Added support for installing shortcuts in Mate and GNOME3/Cinnamon

Version 0.6.1

  • Fixed small bug introduced in 0.6

Version 0.6

  • Added support for cmus

Version 0.5.2

  • Fixed incorrect use of MPRIS2 protocol that caused VLC 2.0 to crash. Thanks to orbisvicis for the very helpful bug report and patch.

Version 0.5.1

  • Fixed some Python 3 incompatibilities

  • Fixed crash if DBus library is not installed

  • Fixed support for newer version of Banshee

Version 0.5

  • Added support for quodlibet

  • Fixed support for Guayadeque

Version 0.4

  • Added support for MPRIS2 players

  • Added install_gnome command to help set up keyboard shortcuts on GNOME

  • Eliminated dependency on shc.hs for the shell-fm backend

  • Various bug fixes/optimisations

Version 0.3

  • Fixed fatal packaging bug!

  • Improved help text for MPRIS players (lists currently running players).

  • Made dbus dependency optional

  • Support for Python 3 via 2to3.

Version 0.2

  • Added support for Banshee.

  • Implemented ‘test’ command where needed.

  • Small bug fixes.

Version 0.1

  • Initial release.

  • Support for any MPRIS player, shell-fm, mocp and rhythmbox.

Project details


Download files

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

Source Distribution

playerdo-0.7.tar.gz (11.3 kB view hashes)

Uploaded Source

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page