← home


mpris-remote is a utility that controls an MPRIS-capable music player.

Supported players include:

The level of MPRIS compliance varies wildly between these different players, but mpris-remote tries to work around that as much as possible. Some players don't report status information, some don't support metadata, etc.

Code is at github. It's a Python script and doesn't require any building or installation. Just put it somewhere in your PATH. It does depend on the Python D-BUS module.

git clone git://github.com/mackstann/mpris-remote.git

The usage text is hopefully pretty self-explanatory. Use -h or --help to read it.


$ mpris-remote clear
$ mpris-remote random true
$ mpris-remote loop true
$ find ~/music -name '*.mp3' | mpris-remote addtrack -
$ mpris-remote play

Nick Welch <nick@incise.org> · github