Mplay.sh

Aktuelle Version vom 13. Juli 2007, 10:08 Uhr

[Bearbeiten] Beschreibung

Autor: Thomas Hildebrandt

Das (zweifelsohne sehr gute) Script 'mplayer.sh' weist einige Beschränkungen auf, deren Beseitigung ich mit der Entwicklung dieses Scriptes anstrebte.

Konkret sind das:

• Anzeige im OSD des VDR

Die Anzeige des kompletten Dateinamens im OSD (inkl. Extension) fand ich persönlich immer nicht so schick. Ein Eintrag, nur aus z.B. dem Namen des Films gefällt mir besser.

• gemischte Playlists mit verschiedenen Dateitypen

Jede Datei kann ihre eigene Konfiguration bekommen. Das ist meines Wissens mit MPlayer's '-playlist' Option schlicht nicht zu realisieren.

[Bearbeiten] Status

Version:

• 0.5.3

getestet mit:

• MPlayer-1.0rc1-3.4.1

[Bearbeiten] Hardwareanforderungen

• irgendetwas, worauf MPlayer etwas abspielen kann

[Bearbeiten] Softwareanforderungen

• VDR
• Mplayer-plugin
• MPlayer-1.0rc1-3.4.1 (frühere Versionen mögen teilweise funktionieren)

[Bearbeiten] Installation

• kopiere die 'mplay.sh' an einen dir genehmen Ort (z.B. /usr/bin)
• kopiere die Dateien im Verzeichnis 'conf' an einen dir genehmen Ort (z.B. ins VDR Konfigurationsverzeichnis unter 'plugins/mplay'
• editiere die 'mplay.sh' und trage oben das von dir gewählte Konfigurationsverzeichnis ein (Zeile 16)
• VDR muss so aufgerufen werden, dass das MPlayer-Plugin als Parameter 'mplay.sh' bekommt
• Korrektur der Parameter in den Konfigurationsdateien im Konfigurationsverzeichnis
• evt. anpassen der Parameter in der 'mplayersources.conf'

[Bearbeiten] Konfiguration

[Bearbeiten] mplayrc (Beispiel)

$CONFDIR/mplayrc

# mplayrc
# configuration file for 'mplay'

# set this to find debug messages in syslog
#MPLAY_DEBUG=yes

# set this, if your VDR doesn't stop to play its sound, when
# invoking 'mplay.sh'
#MPLAY_FIXVDRSOUND=yes

# media root dir (the trailing slash is important)
MPLAY_MEDIA_DIR=/media

# media types to search for in MDIR
# (when no file is given in a set file)
MPLAY_TYPES="avi mpg mkv mov flv vob vdr"

# where or what is our 'mplayer'
MPLAY_MPLAYER=mplayer

# where is 'mplayer-multi' (if you need it)
#MPLAY_MULTI=mplayer-multi

# support file for playing
# (in case of problems maybe set this to an absolute path)
MPLAY_PLAY=~/mplay.play
#MPLAY_PLAY=/video/mplay.play

### default video out
MPLAY_VOUT="mpegpes"
# use this, when output card is not the first (and only)
#MPLAY_VOUT="mpegpes:card=1"

### default audio out
MPLAY_AOUT="mpegpes"
# use this, when output card is not the first (and only)
#MPLAY_AOUT="mpegpes:card=1"

# MPlayer mandatory options
# (this will always passed through to MPlayer)
MPLAY_GLOBAL="-quiet -nolirc -cache 8192 -framedrop"

# automatic identifying file types
MPLAY_IDENTIFY=yes

### target resolutions of video output
# up to 3 resolutions are supported
# (set the highest in MPLAY_RES1)
# this seems to be the most common use
MPLAY_RES1=720x576
MPLAY_RES2=352x288

# try this with a slow cpu
#MPLAY_RES1=352x288

# scale videos up instead of down
MPLAY_SCALE=up

# care for aspect
MPLAY_ASPECT=yes

# when using 'lavc' filter, use it with this argument
MPLAY_LAVC=4600

# option for MPlayer's 'pp' option (very seldom used)
#MPLAY_PP=fd

# padding
#MPLAY_PADDING=20

### global options for subtitle handling
# show subtitles, if found
MPLAY_SUB_SHOW=yes

# languages to display
MPLAY_SUB_LANGUAGES=ger,eng

# vertical position (% of screen height)
MPLAY_SUB_POS=95

# width on screen (% of screen width)
MPLAY_SUB_WIDTH=95

# fps
#MPLAY_SUB_FPS=25

# subtitle delay
#MPLAY_SUB_DELAY=5

# background transparency
#MPLAY_SUB_BG_ALPHA=0

# background 'color' (means grayscale up to now)
#MPLAY_SUB_BG_COLOR=0

# handle sound sets with 'sndctl' plugin
#MPLAY_WITH_SNDCTL=yes

# command for SVDR commands to VDR, if available
MPLAY_SVDR=svdrpsend.pl

# command for logging into syslog
MPLAY_LOGGER="logger -i -t mplay.sh"

[Bearbeiten] Parameter

Jeder der folgenden Parameter kann eigentlich und im Prinzip in jeder der Konfigurationsdateien stehen. Sie können auf diese Weise überschrieben oder ergänzt werden.

MPLAY_AF

  regulär definiert in: SET Datei
          Standardwert: <nicht gesetzt>
          Beschreibung: Parameter für MPLayer's Audiofilter (-af)

'MPLAY_AF' wird direkt in die MPlayer-Option '-af', das sind die Audiofilter.

Die Zeile konkret besteht aus mehreren hintereinander gesetzten Filtern.

sub=120:5 generiert einen Subwooferkanal mit einer Cutoff-Frequenz von 120 Hz und fügt den als Kanal 5 in den Audiostrom

channels=6:5:0:0:1:1:0:2:1:3:5:5 macht aus den (jetzt) 3 Audioströmen (links, rechts und der sub vom vorigen Filter) 6.

   * 6 Ausgabekanäle
   * 5 folgende Routings
   * 0:0 Eingangskanal 0 wird Ausgangskanal 0
   * 1:1 Eingangskanal 1 wird Ausgangskanal 1
   * 0:2 Eingangskanal 0 wird Ausgangskanal 2 (routet das Frontsignal identisch auf einen hinteren Lautsprecher)
   * 1:3 Eingangskanal 1 wird Ausgangskanal 3
   * 5:5 Eingangskanal 5 wird Ausgangskanal 5 (Subwoofer)

equalizer=0:0:0:0:0:-3:-3:0:0:0 ein 10-Band-Equalizer mit folgenden Frequenzen

   * 31.25 Hz
   * 62.50 Hz
   * 125.00 Hz
   * 250.00 Hz
   * 500.00 Hz
   * 1.00 kHz
   * 2.00 kHz
   * 4.00 kHz
   * 8.00 kHz
   * 16.00 kHz

volume=-15:1 Lautstärkeverringerung (ist auf meinem System nötig um den Unterschied zwischen Stereo und 5.1 auszugleichen), die 1 schaltet das Softclipping (Lautstärkebegrenzung) ein

Das Ganze dient dazu, normalen Stereoton (im konkreten Fall Musik) über eine 5.1-Anlage zu schicken und aus allen Lautsprechern einen Ton zu haben.

MPLAY_AOUT

  regulär definiert in: mplayrc
          Standardwert: alsa
          Beschreibung: das Audioausgabegerät für MPlayer

MPLAY_ASPECT

 regulaer definiert in: mplayrc
          Standardwert: yes
          Beschreibung: Wenn gesetzt, versucht 'mplay.sh' die korrekte
                        Auflösung des Videomaterials aus dem von MPlayer
                        ermittelten Aspekt-Ratio zu errechnen.

MPLAY_DD20

 regulaer definiert in: video-a52.conf
          Standardwert: siehe 'video-a52.conf'
          Beschreibung: spezielle Parameter, wenn zwar ein AC3 Audiostrom
                        vorliegt, dieser jedoch "nur" 2.0 ist

MPLAY_DEBUG

  regulär definiert in: mplayrc
          Standardwert: <nicht gesetzt>
          Beschreibung: wenn gesetzt (auf irgendeinen Wert) werden
                        verschiedene Meldungen ins System Log geschrieben

MPLAY_DIRECT

  regulär definiert in: SET Datei
          Standardwert: <nicht gesetzt>
          Beschreibung: ist diese Option gesetzt, wird der MPlayer kommentar-
                        los mit den hiermit gesetzten Parametern und dem
                        Dateinamen aufgerufen;
                        'mplay.sh' beendet sich danach

MPLAY_FILE

  regulär definiert in: SET Datei
          Standardwert: <nicht gesetzt>
          Beschreibung: definiert in einer SET-Datei die Datei, die
                        abgespielt werden soll

MPLAY_FIXVDRSOUND

  regulär definiert in: mplayrc
          Standardwert: <nicht gesetzt>
          Beschreibung: Wenn die Audioausgabe in 'MPLAY_AOUT' auf 'alsa'
                        gesetzt ist, kann es sein, dass der Ton des VDR
                        nebenher weiterläuft. Setz' diesen Wert auf 'yes'
                        und 'mplay.sh' macht einen Workaround für dieses
                        Problem.
                        Kleine Nebenwirkung: Nach Ende von 'mplay.sh'
                        ist der VDR auch stumm bis zur nächsten Betätigung
                        der Lautstärkeregelung.

MPLAY_GLOBAL

  regulär definiert in: mplayrc
          Standardwert: "-quiet -nolirc -cache 8192"
          Beschreibung: globale Optionen für MPlayer

MPLAY_IDENTIFY

  regulär definiert in: mplayrc
          Standardwert: yes
          Beschreibung: bewirkt, dass eine Identifizierung der abzuspielenden
                        Datei versucht wird
                        (ACHTUNG: Wenn dieser Parameter nicht auf 'yes' steht,
                        muss jede einzelne Option in den SET-Dateien manuell
                        gesetzt werden!)

MPLAY_LAVC

  regulär definiert in: mplayrc
          Standardwert: 4600:25
          Beschreibung: betrifft MPlayer's 'lavc'-Videofilter und beschreibt
                        die Datenrate, mit der MPlayer einen on-the-fly
                        MPEG1-Datenstrom erzeugt. Der Wert hängt von der
                        Leistungsfähigkeit des Systems ab und muss probiert
                        werden.
                        Als Ausgangswert mag '4000' dienen. Der Wert kann
                        erhöht werden, bis die Videoausgabe zu ruckeln anfängt.

MPLAY_LOGGER

  regulär definiert in: mplayrc
          Standardwert: "logger -i -t mplay.sh"
          Beschreibung: falls 'MPLAY_DEBUG' gesetzt ist, muss hiermit das
                        Programm definiert werden, das zum Loggen
                        benutzt wird

MPLAY_MEDIA_DIR

  regulär definiert in: mplayrc
          Standardwert: ein existierendes Verzeichnis
          Beschreibung: das Verzeichnis, in dem deine abzuspielenden Dateien
                        liegen

MPLAY_MPLAYER

  regulär definiert in: mplayrc
          Standardwert: mplayer
          Beschreibung: das Kommando, mit dem MPlayer aufgerufen wird

MPLAY_MULTI

  regulär definiert in: mplayrc
          Standardwert: <nicht gesetzt>
          Beschreibung: falls du 'mplayer-multi' benutzt, setze diesen
                        Parameter auf den Namen oder den Pfad des Programms

MPLAY_PADDING

  regulär definiert in: irgendwo
          Standardwert: <nicht gesetzt>
          Beschreibung: erzeugt einen schwarzen Rand um das Video
                        (Ausgleich des Overscans von TV-Geräten)

MPLAY_PLAY

  regulär definiert in: mplayrc
          Standardwert: ~/mplay.play
          Beschreibung: 'mplay.sh' erzeugt eine temporäre Datei, die den
                        kompletten MPlayer-Aufruf enthält. Dieser Parameter
                        kontrolliert, wo diese Datei liegen soll

MPLAY_PLAYLIST

  regulär definiert in: Dateityp-Konfigurationsdatei
          Standardwert: <nicht gesetzt>
          Beschreibung: kennzeichnet den Dateityp als Playlist

MPLAY_PP

  regulär definiert in: mplayrc
          Standardwert: <nicht gesetzt>
          Beschreibung: Optionen für MPlayer's 'pp' Videofilter

MPLAY_RES1, MPLAY_RES2, MPLAY_RES3

  regulär definiert in: mplayrc
         Standardwerte: 720x576
                        640x480
                        352x288
          Beschreibung: Bis zu 3 mögliche Ausgabe-Auflösungen können
                        hiermit definiert werden. Die höchste muss in
                        MPLAY_RES1 stehen. 'mplay.sh' skaliert ein Video
                        abhängig von MPLAY_SCALE auf die nächste, die
                        zur Verfügung steht.
                        MPLAY_RES1 muss immer definiert sein, die anderen
                        können. MPLAY_RES3 wird nicht beachtet, wenn es
                        kein MPLAY_RES2 gibt.
                        (HINWEIS: Die Auflösung 640x480 erzeugt auf
                         manchen Karten kein korrektes oder ein verschobenes
                         Bild.)

MPLAY_RESOLUTION

  regulär definiert in: SET Datei
          Standardwert: <nicht gesetzt>
          Beschreibung: erzwingt die Ausgabe in einer bestimmten Auflösung
                        (ACHTUNG: Im Regelfall wird NICHT jede beliebige
                         Auflösung unterstützt.)

MPLAY_SCALE_ALWAYS

  regulär definiert in: SET Datei
          Standardwert: <nicht gesetzt>
          Beschreibung: erzwingt den Einsatz der MPlayer Videofilter-Option
                        'scale=...', auch, wenn das von der Auflösung her
                        nicht nötig waere (hilft zuweilen gegen
                        Bildstörungen)

MPLAY_SCALE

  regulär definiert in: mplayrc
          Standardwert: up
          Beschreibung: Wenn auf 'up' gesetzt, werden Video-Ausgaben auf die
                        nächstgrössere Auflösung skaliert statt auf die
                        nächstkleinere.
                        (Beispiel: Video ist 640x272, mögliche Auflösungen
                        seien 720x576 und 352x288. Mit 'MPLAY_SCALE=up'
                        wird das Video mit 720x576 abgespielt, ohne den
                        Parameter mit 352x288.)

MPLAY_SOUNDSET

  regulär definiert in: SET Datei
          Standardwert: <nicht gesetzt>
          Beschreibung: definiert in einer SET-Datei das Soundset, mit dem
                        die Datei abgespielt werden soll
                        (siehe auch 'MPLAY_WITH_SNDCTL')

MPLAY_SUB_FILE

 regulaer definiert in: SET Datei
          Standardwert: <nicht gesetzt>
          Beschreibung: spezifiziert eine konkrete Untertitel-Datei

MPLAY_SUB_FPS

 regulaer definiert in: mplayrc
          Standardwert: <nicht gesetzt>
          Beschreibung: abweichende Geschwindigkeit für Untertitel
                        spezifizieren (in fps)

MPLAY_SUB_ID

 regulaer definiert in: SET Datei
          Standardwert: <nicht gesetzt>
          Beschreibung: benutzt statt des Standardwertes '0' eine andere SID
                        für die Untertitel (ermöglicht die Benutzung eines
                        anderen Untertitels, falls mehrere vorliegen)

MPLAY_SUB_LANGUAGES

 regulaer definiert in: mplayrc
          Standardwert: ger,eng
          Beschreibung: Sprachen(liste), die MPlayer als Untertitel anzeigen
                        soll (mehrere Sprachen durch Komma trennen)

MPLAY_SUB_SHOW

 regulaer definiert in: mplayrc
          Standardwert: yes
          Beschreibung: weist 'mplay.sh' an, Untertitel anzuzeigen, wenn diese
                        identifiziert werden

MPLAY_SUB_POS

 regulaer definiert in: mplayrc
          Standardwert: 95
          Beschreibung: die Position der Untertitel in % der Höhe des
                        Bildschirms

MPLAY_SUB_WIDTH

 regulaer definiert in: mplayrc
          Standardwert: 95
          Beschreibung: die maximale Breite der Untertitel in % der Breite des
                        Bildschirms

MPLAY_SUB_DELAY

 regulaer definiert in: mplayrc
          Standardwert: <nicht gesetzt>
          Beschreibung: Verzögerung bei der Anzeige der Untertitel in Sekunden

MPLAY_SUB_BG_ALPHA

 regulaer definiert in: mplayrc
          Standardwert: <nicht gesetzt>
          Beschreibung: Hintergrundtransparenz fuer Untertitel (und OSD)

MPLAY_SUB_BG_COLOR

 regulaer definiert in: mplayrc
          Standardwert: <nicht gesetzt>
          Beschreibung: Hintergrundfarbe für Untertitel (und OSD)

MPLAY_SVDR

  regulär definiert in: mplayrc
          Standardwert: svdrpsend.pl
          Beschreibung: Das Programm, um SVDR Kommandos an VDR abzusetzen.
                        (wird z.B. von 'MPLAY_WITH_SNDCTL' benötigt)

MPLAY_TYPE_OPTIONS

  regulär definiert in: Dateityp-Konfigurationsdatei
          Standardwert: <nicht gesetzt>
          Beschreibung: definiert Optionen speziell für diesen Dateityp

MPLAY_TYPES

  regulär definiert in: mplayrc
          Standardwert: "avi mpg mkv mov"
          Beschreibung: definiert die Dateitypen, nach denen im Medien-
                        verzeichnis gesucht wird

MPLAY_VF

  regulär definiert in: SET Datei
          Standardwert: <nicht gesetzt>
          Beschreibung: Parameter für MPLayer's Videofilter (-vf)

MPLAY_VOUT

  regulär definiert in: mplayrc
          Standardwert: mpegpes
          Beschreibung: das Videoausgabegerät für MPlayer

MPLAY_WITH_SNDCTL

  regulär definiert in: mplayrc
          Standardwert: <nicht gesetzt>
          Beschreibung: wenn auf 'yes' gesetzt wird 'mplay.sh' versuchen, ein
                        Soundset-Handling durchzuführen (per 'sndctl' Plugin)
                        ('MPLAY_SVDR' muss dazu korrekt gesetzt sein)

[Bearbeiten] Dolby Digital

Die Standardkonfiguration ist konservativ auf die Audioausgabe über die DVB-Karte eingestellt. MPlayer muß so einen evt. vorhandenen 5.1-Stream auf Stereo herunterrechnen. Falls 'echter' 5.1-Sound gewünscht ist, sollte man seine Aufmerksamkeit auf die 'mplayrc' und die 'video-52.conf' richten.

• 5.1 Ausgabe über Soundkarte (ALSA)

 in 'mplayrc'       : MPLAY_AO=alsa
 in 'video-a52.conf': MPLAY_TYPE_OPTIONS="-channels 6" und ggf. MPLAY_DD20 aktivieren

• AC3-Datenstrom auf externen Decoder/Receiver streamen

 in 'video-a52.conf': MPLAY_TYPE_OPTIONS="-ac hwac3," aktivieren
                      (ungetestet, evt. ein bisschen experimentieren)

Hinweis: Wenn die Ausgabe über die Soundkarte erfolgt, muß ggf. für eine entsprechende Lautstärkeregelung gesorgt werden.

[Bearbeiten] Untertitel

Untertitel werden gemäß dem normalen Handling von MPlayer erkannt und verarbeitet (Dateiname der Untertitel-Datei bis auf die Dateierweiterung identisch zum Filmnamen). Um Untertitel ähnlich flexibel wie alle anderen Dateitypen verarbeiten zu können, wird von 'mplay.sh' nach der Erkennung des Untertiteltyps nach einer entsprechenden Konfigurationsdatei gesucht und diese geladen. Damit können sowohl globale Optionen in der 'mplayrc' gesetzt als auch spezielle für bestimmte Untertiteltypen bestimmt werden.

Beispiel: Wenn zu einer 'Film.avi' eine 'Film.srt' existiert, wird das erkannt und eine evt. vorhandene 'srt.conf' geladen.

[Bearbeiten] Sonstiges

[Bearbeiten] Tipps

• WICHTIG: Die Dateien/Sets im Anzeigeverzeichnis müssen tatsächlich Dateien sein, KEINE Links
• Die Dateitypenkonfigurationsdateien für Audiodaten gibt es getrennt für reines Audio und für Audio in Video. So mag manch einer eine reine MP3-Datei anders gespielt haben als wenn der MP3-Ton aus einem Film stammt. Hierzu läßt sich eine spezielle Konfigurationsdatei für jeden Dateityp erstellen.

Im Beispiel: video-mp3.conf - 'mplay.sh' liest die 'video-mp3.conf' statt der 'mp3.conf', wenn ein Videostream identifiziert werden kann.

• Es gibt keinen Parameter der Art 'SLOWCPU' oder so. Wenn dein Rechner mit 720x576 nicht klarkommt (ruckeln usw.), dann setze 'MPLAY_RES1=352x288' und lass MPLAY_RES2 und MPLAY_RES3 weg oder experimentiere ein wenig mit MPLAY_LAVC.

[Bearbeiten] Probleme

• Unter bestimmten Bedingungen wird 'mplay.sh' vom VDR mit keinem konkreten Usernamen aufgerufen. In diesem Fall funktioniert die Auflösung von 'MPLAY_PLAY=~/mplay.play' nicht. (Sieht man im Log "~/mplay.play: No such file or directory") Der Pfad ist dann durch einen konkreten Pfad zu ersetzen (z.B. 'MPLAY_PLAY=/tmp/mplay.play')

[Bearbeiten] Links

1. Download
2. Mplayer-plugin
3. MPlayer