'\" t
.\"     Title: mpris-remote
.\"    Author: [see the "Author" section]
.\" Generator: DocBook XSL Stylesheets v1.78.1 <http://docbook.sf.net/>
.\"      Date: 12/13/2015
.\"    Manual: mpris-remopte Manual
.\"    Source: mpris-remote
.\"  Language: English
.\"
.TH "MPRIS\-REMOTE" "1" "12/13/2015" "mpris\-remote" "mpris\-remopte Manual"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
mpris-remote \- control mpris compatible audio players
.SH "SYNOPSIS"
.sp
mpris\-remote [ \fIoptions\fR ]
.SH "DESCRIPTION"
.sp
\fBmpris\fR is a dbus standard interface to control media players\&. Many players like amarok, Audacious, QMMP, mpd with mpDris support this interface\&.
.sp
\fBmpris\-remote\fR is a command\-line interface to control media players via mpris\&.
.SH "OPTIONS"
.PP
\fB\-h\fR, \fB\-\-help\fR
.RS 4
Prints usage of mpris\-remote and exit\&.
.RE
.PP
\fBaddtrack\fR \fIuri\fR [\fItrue\fR]
.RS 4
Add track at specified
\fIuri\fR
to media\-player\&. Filetypes, protocols, locations are dependent on the media player\&. If
\fItrue\fR
is specified starts immediate playback of added track\&.
\fIuri\fR
can be set to
\fI\-\fR
to read uris from stdin\&.
.RE
.PP
\fBclear\fR
.RS 4
Clear current playlist\&.
.RE
.PP
\fBdeltrack\fR \fItracknumber\fR
.RS 4
Remove
\fItracknumber\fR
from current playlist\&.
.RE
.sp
\fBidentity\fR: Print the identity of the player\&. Typically version and name\&.
.PP
\fBloop\fR [\fItrue\fR|\fIfalse\fR]
.RS 4
If the parameter is omitted prints whether media player will loop track list\&. Otherwise sets whether track list loops or not\&.
.RE
.PP
\fBnext\fR
.RS 4
Next track\&.
.RE
.PP
\fBnumtrack\fR
.RS 4
Prints number of tracks in current playlist\&.
.RE
.PP
\fBplay\fR
.RS 4
Start playback
.RE
.PP
\fBplaystatus\fR
.RS 4
Print information about the current status of the player\&.
.RE
.PP
\fBprev\fR, \fBprevious\fR
.RS 4
Previous track\&.
.RE
.PP
\fBposition\fR
.RS 4
Prints position in current track
.RE
.PP
\fBrandom\fR [\fItrue\fR|\fIfalse\fR]
.RS 4
If the parameter is omitted prints whether media player has random/shuffle enabled\&. Otherwise set random/shuffle status\&.
.RE
.PP
\fBrepeat\fR [\fItrue\fR|\fIfalse\fR]
.RS 4
Set current track repeat\&.
.RE
.PP
\fBseek\fR \fItime\fR
.RS 4
Seeks to specified
\fItime\fR
in track\&.
\fItime\fR
is specified as milliseconds from 0\&.
.RE
.PP
\fBstop\fR
.RS 4
Stop playback
.RE
.PP
\fBtrackinfo\fR [\fItrack\fR]
.RS 4
Prints trackinfo\&. If track is committee prints trackinfo for current track\&. If track is * prints trackinfo for all tracks in playlist\&.
.RE
.PP
\fBtracknum\fR
.RS 4
Prints track number in current playlist
.RE
.PP
\fBvolume\fR [\fIPERCENT\fR]
.RS 4
If percent is omitted returns current volume\&. Otherwise sets player volume to specified percentage\&.
.RE
.PP
\fBquit\fR
.RS 4
Exit player\&.
.RE
.SH "ENVIRONMENT VARIABLES"
.PP
\fBMPRIS_REMOTE_PLAYER\fR
.RS 4
If unset or set to
\fI*\fR, mpris\-remote will communicate with the first player it finds registered under "\fIorg\&.mpris\&.*\fR" 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\&.
.RE
.SH "SEE ALSO"
.sp
For more information about mpris see http://www\&.mpris\&.org/1\&.0/spec\&.html
.SH "AUTHOR"
.sp
\fBmpris\-remote\fR was written by Nick Welch <nick@incise\&.org>\&.