Menuorg-plugin

Beschreibung

Autor: Thomas Creutz & Tobias Grimm

Organisieren des OSD-Menüs mit Submenüs

Status

Letztes Update 03/2013

Plugins mit ähnlicher Funktion:

• submenu-plugin
• Proxy-plugin

Softwareanforderungen

• libxml++2.6

Installation

Patches

Das Plugin benötigt einen Patch der auf den VDR angewendet werden muss. Dieser Patch ist so konzipiert, dass er die API des VDR nicht ändert. Dies bedeutet, dass ein Neukompilieren der Plugins entfällt.

Konfiguration

Das Plugin verfügt im Moment noch nicht über eine OSD-Schnittstelle zum Organisieren der Menüs. Deswegen muss noch die Datei menuorg.xml per Hand angepasst werden. Diese basiert im Wesentlichem auf dem Format des Setup-plugins.

Es gibt 5 verschiedene Menu-Items:

• <system>  : System-Menu-Items, wie die Kanalliste oder die Timer
• <plugin>  : Plug-in Menu-Items
• <menu>  : Ein Untermenu
• <command>  : Um einen externen Befehlt auszuführen
• <separator> : Erzeugt eine Linie

Für die System-Items sind folgende Werte zulässig:

• Schedule
• Channels
• Timers
• Recordings
• Commands
• Setup

Parameter

Parameter	Beschreibung
-c FILE --config=FILE	alternativer Pfad zur Konfigurationsdatei (Menüdefiniton)

Probleme

Wer in seinen Menu-Namen spezielle Zeichen wie: &, <, >, ', " verwenden möchte, muss diese durch spezielle Platzhalter ersetzten.

Umlaute ersetzt man z.B. durch den hexadezimalen Code des Zeichens. Ein ä wäre dann &#xE4; (&#x wird immer vorangestellt, ; wird immer nachgestellt).

Hier einige deutsche Umlaute und Sonderzeichen:

Zeichen	Code
ä	ä
ö	ö
ü	ü
Ä	Ä
Ö	Ö
Ü	Ü
ß	ß
<	&#x3C;
>	&#x3E;

Weitere Infos zu XML-Dateien s. hier.

Noch ein Tipp, um den Code eines Zeichens herauszubekommen:

Vim aufrufen, mit i in den Einfügemodus wechseln, das Zeichen eingeben, den Einfügemodus mit ESC verlassen, den Cursor über dem Zeichen positionieren und ga eingeben. Der Code wird dann unten in der Statuszeile angezeigt.

Tipps

Wer vorher das submenu-plugin verwendet hat, kann das dem Menuorg-Plugin beigelegte "vdr-submenu2menuorg"-Skript zum Konvertieren verwenden.

Beispiel zur Benutzung:

vdr-submenu2menuorg /var/lib/vdr/plugins/MainMenu.conf /var/lib/vdr/plugins/menuorg.xml

Weitere Tipps:

Aktuelle VDRs benötigen den Patch nicht mehr. z.B. wenn die eTobi Packete
mit Multipatch eingesetzt werden. 
Der oben erwähnte Patch wird nur bei selbst kompilierten VDRs benötigt.

Wenn Probleme auftreten, kann man auf der Konsole den VDR starten und nur
das menuorg Plugin angeben. Das führt zu einer Ausgabe mit klarer Angabe des
Fehlers mit der genauen Linie der menuorg.xml, welche Schwierigkeiten macht.
D.h. zum Testen sieht der direkte Aufruf am Beispiel CTVDR (Debian) so aus "/usr/bin/vdr -Pmenuorg"

Versions-Historie

Version	Datum	Beschreibung	Link
0.5.1	17.03.2013	Fixed some stupid bugs from the last release	0.5.1
0.4.4		Fixed GCC4.3 FTBFS	0.4.4
0.3	25.08.2007	Fixed charset conversion for menu titles. They will now explicitly be converted to VDR's locale charset falling back to ISO8859-2 on conversion errors.	0.3
0.2	25.08.2007	Fixed bug with burn plug-in - cPlugin::MainMenuEntry() should not be called before all plug-ins Intialize() and Start() were called.	0.2
0.1	24.08.2007	Initial revision.	0.1

Aktuelle Version

0.5.1

Links

1. Homepage des Plugins