.\" Erstellt von 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 "17.10.2009" "My Media System" "Version 1.1.2" "Dienstprogramme fr Benutzer"
.SH BEZEICHNUNG
mms \- Eine vollstndige Medien-Oberflche
.SH "BERSICHT"
\fBmms\fP [ \-\-help|\-h ] [ \-d ] [ \-c \fIPfad\fP ] [ \-p \fIPfad\fP ]
[ \-f ] [ \-u \fIBenutzername\fP ] [ \-U \fIBenutzername\fP ] [ \-e ] [ \-v|V ]
[ \-r \fIDateiname\fP ] [ \-b ] [ \-w \fIDateiname\fP ] [ \-i \fITyp\fP ]
[ \-o \fITyp\fP ]
.SH BESCHREIBUNG
\fBMMS\fP stellt eine Medienoberflche bereit, mit der sich Musik,
Radio, Video, Bilder und Spiele sowohl von Festplatte, als auch
von CD/DVD wiedergeben lassen.
Mehrere Eingabe- ud Ausgabedevices stehen dabei zur Verfgung.
.PP
Fr die Ausgabe stehen \fIsdl\fP, \fIopengl\fP, \fIlcd\fP, \fImpeg\fP,
\fIdvb\fP und \fIdxr3\fP zur Verfgung.
Die Eingabe kann mittels \fIkeyboard\fP, \fImaus\fP, \fIlirc\fP, \fIreplay\fP
oder \fIevdev\fP
erfolgen.
.SH OPTIONEN
.TP
\fB\-\-help|\-h\fP
Gibt eine Hilfe aus, in der die Funktionen kurz erlutert sind. Weiter werden
hier die zur Verfgung stehenden (mitcompilierten) \fBEingabe-\fP und
\fBAusgabegerte\fP angezeigt.
.TP
\fB\-d\fP
Startet \fRMMS\fP als Daemon im Hintergrund
.TP
\fB\-c <absoluter Pfad>\fP
Eine alternatives Konfigurationsverzeichnis verwenden. Die Angabe muss mit
vollstndigem Pfad erfolgen.
.TP
\fB\-p <absoluter Pfad>\fP
Ein alternatives persnliches Verzeichnis (Datenbanken, PLaylisten) verwenden.
Die Angabe mu mit vollstndigem Pfad erfolgen.
.TP
\fB\-f\fP
Startet im Vollbild.
.TP
\fB\-u <Benutzername>\fP
Startet MMS als Benutzer: \fIBenutzername\fP. Um MMS als Benutzer \fIroot\fP
zu starten (\fBnicht empfohlen\fP): mms \-u root
.TP
\fB\-U <Benutzername>\fP
Startet MMS als Benutzer: \fIBenutzername\fP und setzt die Umgebungsvariablen
zurck.
.TP
\fB\-e\fP
Gibt eine Liste der Umgebungsvariablen aus. Ntzlich zum Einrichten und/oder
der Fehlersuche.
.TP
\fB\-v|V\fP
Zeigt die installierte Version und die Optionen mit denen MMS bersetzt wurde.
.TP
\fB\-r <Nachspieldatei>\fP (relativer Pfad)
Nutzt eine Nachspieldatei als Eingabe. Hier gespeicherte Befehlsfolgen
werden nacheinander abgespielt.
Bentigt gleichzeitig die Parameter \fB\-i replay\fP
.TP
\fB\-b\fP
Erstellt ein Benchmark. Bentigt gleichzeitig den Parameter \fB\-i replay\fP
und \fB\-r <Nachspieldatei>\fP
.TP
\fB\-w <Nachspieldatei>\fP (relativer Pfad)
Erstellt eine Nachspieldatei anhand aufgezeichneter Eingaben.
.TP
\fB\-i Eingabegert[,Eingabegert]\fP
Gibt das oder die zu nutzenden Eingabegerte unabhngig von den Einstellungen in
der Config vor. Mgliche Gerte sind \fIkeyboard\fP, \fIlirc\fP, \fIreplay\fP
oder \fIevdev\fP.
Mehrere Eingabegerte lassen sich gleichzeitig nutzen: mms \-i lirc,keyboard
.TP
\fB\-o <Ausgabegert>\fP
Gibt das zu nutzende Ausgabegert vor und. Mgliche Gerte sind
\fIsdl\fP, \fIopengl\fP, \fIlcd\fP, \fImpeg\fP, \fIdvb\fP und \fIdxr3\fP.
.SH "TASTATURSTEUERUNG"
.B MMS
lt sich komplett mit wenigen Tasten steuern.
Die Steuerung geschieht mittels \fIkeyboard\fP (Tastatur),
\fIevdev\fP (Joystick), Maus oder \fIlirc\fP (Fernbedienung - funktionierende
LIRC-Untersttzung vorausgesetzt).
Die relevanten Tasten fr die grundlegende Tastatur-Bedienung werden hier
vorgestellt (
.I "\-i keyboard"
):
.TP
.B Tastatursteuerung
.PD 0
.RSs
.IPs "<\- und \->"
.IPs "HOCH und RUNTER"
Navigation innerhalb der Oberflche.

.IPs "Eingabetaste (Enter)"
Ein Element auswhlen bzw. einen Ordner betreten.

.IPs "Ende (End)"
Eine Ebene zurck bzw. eine Funktion verlassen.

.IPs "Pos1 (Home)"
Wechselt jederzeit in die aktuelle Playliste.

.IPs "Leertaste (Space)"
ffnet das 'Second Action' Menu. Hierber lassen sich alle weiteren Funktionen
aufrufen, sowie deren Tastenbelegung einsehen.

.IPs "Lchen (Backspace)"
Leert die aktuelle Playliste.

.IPs "Entf (Del)"
Lscht einen Titel aus der Playliste.

.IPs "BildHoch und BildRunter (bzw.\& PGUP/\:PGDOWN)"
Blttert seitenweise innerhalb der Navigation.

.SH DATEIEN
Die Konfigurationsdateien fr
.B MMS
liegen in
.I "/etc/mms"
oder
.I "~/.mms"
oder
.I "-c <Pfad>"

.TP
.B \ CONFIGDIR/*Config
Hier werden alle relevanten Einstellungen fr
.B MMS
vorgenommen. Die Dateien sind in sich gut dokumentiert und selbsterklrend.
.
.TP
.B \ CONFIGDIR/input/keyboard/* oder CONFIGDIR/input/lirc/*
Je nach gewhltem Eingabegert (z.B. \fBkeyboard\fP) kann hier die
Belegung der einzelnen Funktionen fr das jeweilige Eingabegert
festgelegt werden.

.TP
.B \ /var/lib/mms
Hier legt
.B MMS
relevante Dateien ab, welche zur Laufzeit nicht so ohne weiteres wieder-
hergestellt werden knnen.

.SH "SIEHE AUCH"
Fr weitere Informationen (Wiki, Forum) siehe auch \fBwww.mymediasystem.org\fP

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