.\" Erstellt von Roman Mllenschlder <mms@prodeia.de>
.\"
.\" Translation to english by Roman Mllenschlder <mms@prodeia.de>
.\"
.
.\" --------------------------------------------------------------------------
.\" Makrodefinitionen
.\" --------------------------------------------------------------------------
.
.\" Einrckung fr Suboptionen
.nr SS 5
.\" neue Suboption hinzufgen
.de IPs
.IP "\\$1" \n(SS
..
.\" Beginn des ersten Suboptionen-Levels, endet mit .RE
.de RSs
.RS 10
..
.\" Beginn des zweiten Suboptionen-Levels
.de RSss
.PD 0
.RS \n(SS+3
..
.\" Ende des zweiten Levels von Suboptionen
.de REss
.RE
.PD 1
..
.
.TH MMS 1 "12.2.2007" "My Media System" "version 1.0.8.5" "user commands"
.SH NAME
mms \- a complete multimedia suite
.SH SYNOPSIS
\fBmms\fP [ \-\-help ] [ \-c \fIfile\fP ] [ \-d ] [ \-b ] [ \-r \fIfile\fP ] [ \-w \fIfile\fP ] [ \-i \fItype\fP ] [ \-o \fItype\fP ]
.SH DESCRIPTION
\fBMMS\fP offers a complete media-suite for having easy access to music,
radio, video, pictures and games from harddisk or cd/dvd.
Various input- and outputdevices makes it even versatile.
.PP
For output you have the choice between \fIsdl\fP, \fIdvb\fP, \fIdxr3\fP and
\fIfbdev\fP.
The input may be realised with \fIkeyboard\fP, \fIlirc\fP oder \fIevdev\fP.
.SH OPTIONS
.TP
\fB\-\-help\fP
Offers a short help and description of the commandline options and gives
an overview of compiled-in input- and outputdevices.
.TP
\fB\-c <configfile>\fP (absolute path)
Sets an alternate config-file
.TP
\fB\-d\fP
Starts \fRMMS\fP as daemon for background usage.
.TP
\fB\-b\fP
Fastest possible playback of given commands for benchmarking purposes.
Needs \fB\-i replay\fP and \fB\-r <replayfile>\fP to work.
.TP
\fB\-r <replayfile>\fP (relative path)
Uses a given replayfile as input. Recorded commands are played back.
Use this for automation or benchmarking. Needs \fB\-i replay\fP to be set.
.TP
\fB\-w <replayfile>\fP (relative path)
Records input-commands to the given replayfile.
.TP
\fB\-i <input>\fP 
Sets the input device apart from the default given in the config file.
Possible devices are \fIkeyboard\fP, \fIlirc\fP or \fIevdev\fP, depending
on how
.B MMS
was compiled.
.TP
\fB\-o <outputdevice>\fP
Sets the output device apart from the default given in the config file.
Possible devices are \fIsdl\fP, \fIdvb\fP, \fIdxr3\fP and \fIfbdev\fP,
depending on how
.B MMS
was compiled.
.SH "INTERACTIVE CONTROL"
.B MMS
is controlable with a few simple keys (if set to keyboard as input).
Possible controls are keyboard, joystick (evdev) or remote control
(working LIRC-configuration needed).
The relevant keys for rudimentary keyboard-control as starting point
are decribed here.

.TP
.B keyboard control
.PD 0
.RSs
.IPs "<\- and \->"
.IPs "UP and DOWN"
Navigation.

.IPs "Enter"
Choose an item or enter a folder.

.IPs "End"
Goes back or leaves a menu/function.

.IPs "Home"
Switches to playlist and back.

.IPs "Backspace"
Clears the current playlist.

.IPs "Del"
Removes highlighted title from playlist.

.IPs "PGUP and PGDOWN"
Jumps pagewise up or down.

.IPs "Space"
Opens the 'Second Action' menu. This menu gives you the opportunity
to control all functions within
.B MMS
and see assigned controls.

.SH FILES
The config files for
.B MMS
are placed in
.I "/etc/mms"
and
.I "/var/lib/mms"
.

.TP
.B \ config
Here you setup all relevant parameters for the usage of
.B MMS
. This file is well documented and should be self instructive.
.
.TP
.B \ input-*
Depending on what you choose as input (ex. \fBinput-keyboard\fP)you can
configure the used keys as you like.

.TP
.B \ /var/lib/mms
.B MMS
stores some more relevant file here, which may take a long time to rebuild at runtime.
These are playlists, movie-infos and mp3-tags.

.SH "SEE ALSO"
For further documentation or information (wiki, forum) see \fBmms.kicks-ass.org\fP

.SH AUTHOR
.TP
Anders Rune Jensen anders@gnulinux.dk
