:man source:   mpris-remote
:man manual:   mpris-remopte Manual

mpris-remote(1)
================

Name
----
mpris-remote - control mpris compatible audio players

Synopsis
--------
mpris-remote [ _options_ ]

Description
------------

*mpris* is a dbus standard interface to control media players. Many players
like amarok, Audacious, QMMP, mpd with mpDris support this interface.

*mpris-remote* is a command-line interface to control media players via mpris.

Options
--------

*-h*, *--help*::
Prints usage of mpris-remote and exit.

*addtrack* _uri_ [_true_]::
Add track at specified _uri_ to media-player. Filetypes, protocols, locations are dependent on the media player. If _true_ is specified starts immediate playback of added track. _uri_ can be set to _-_ to read uris from stdin.

*clear*::
Clear current playlist.

*deltrack* _tracknumber_::
Remove _tracknumber_ from current playlist.

*identity*:
Print the identity of the player. Typically version and name.

*loop* [_true_|_false_]::
If the parameter is omitted prints whether media player will loop track list. Otherwise sets whether track list loops or not.

*next*::
Next track.

*numtrack*::
Prints number of tracks in current playlist.

*play*::
Start playback

*playstatus*::
Print information about the current status of the player.

*prev*, *previous*::
Previous track.

*position*::
Prints position in current track

*random* [_true_|_false_]::
If the parameter is omitted prints whether media player has random/shuffle enabled. Otherwise set random/shuffle status.

*repeat* [_true_|_false_]::
Set current track repeat.

*seek* _time_::
Seeks to specified _time_ in track. _time_ is specified as milliseconds from 0.

*stop*::
Stop playback

*trackinfo* [_track_]::
Prints trackinfo. If track is committee prints trackinfo for current track. If track is * prints trackinfo for all tracks in playlist.

*tracknum*::
Prints track number in current playlist

*volume* [_PERCENT_]::
If percent is omitted returns current volume. Otherwise sets player volume to specified percentage.

*quit*::
Exit player.

Environment Variables
----------------------
*MPRIS_REMOTE_PLAYER*::
If unset or set to _*_, mpris-remote will communicate with the first player
it finds registered under "_org.mpris.*_" through D-BUS. If you only have one
MPRIS-compliant player running, then this will be fine. If you have more
than one running, you will want to set this variable to the name of the
player you want to connect to.  For example, if set to foo, it will try to
communicate with the player at "org.mpris.foo" and will fail if nothing
exists at that name.

See also
--------

For more information about mpris see http://www.mpris.org/1.0/spec.html

Author
------
*mpris-remote* was written by Nick Welch <nick@incise.org>.
