MPRIS-REMOTE(1) 					       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>.

mpris-remote							    08/06/2010							   MPRIS-REMOTE(1)