Keymacros.conf

Aus VDR Wiki
Wechseln zu: Navigation, Suche

Konfigurationsdatei des VDR

Die Konfigurationsdatei keymacros.conf enthält definierbare Makros, die ausgeführt werden, wenn die zugehörige Taste gedrückt wurde. (Die zugehörige Taste wird durch einen Eintrag in der remote.conf festgelegt. Ohne diese Zuweisung können neue Einträge in der keymacros.conf keiner Taste auf dem Eingabegerät (z.B. Fernbedienung) zugeordnet werden.)

Das Format einer solchen Makrodefinition ist

 macrokey  [@plugin] key1 key2 key3...
 oder auch:
 macrokey  [vordefinierter vdr-key] key1 key2 key3              

"Macrokey" ist eine der Tasten Red, Green, Yellow, Blue oder User1, User2, ..., User9.

Die übrigen Einträge der Zeile definieren die Abfolge, die beim Drücken der Taste erfolgen soll.

So kann (1.) mit der "@plugin" das Menü eines optionalen Plugins aufgerufen werden. Dazu muss ein Menüeintrag des optionalen Plugins im Hauptmenü erscheinen. Damit VDR damit etwas anfangen kann, muss der Name des Plugins genauso geschrieben werden, wie er als -P Option beim Start des VDRs angegeben wird. Pro Keymacro-Definition kann nur eine Plugin-Auswahl ("@plugin") angegeben werden, die OK-Taste wird implizit bei Ausführung des Makros angehängt, um das ausgewählte Plugin zu aktivieren. Die verbleibenden Einträge der Zeile definieren dann die weiteren Tasten, die bei Makro-Ausführung an das VDR gesendet werden.

Es kann aber (2.) statt des [@plugin] eine bereits in VDR vordefinierte Taste aufgerufen werden. So etwa mit 'Menu' (ohne Anführungszeichen) das Hauptmenü. Folgen danach noch weitere Tasten, wird das jeweilige Untermenü aufgerufen. Die möglichen vordefinierten Tasten sind etwa unter remote.conf zu finden. Dieses Vorgehen ist dann hilfreich, wenn etwa den genauen Namen in der obigen '-P Option' nicht bekannt ist.

Nachteile an diesem Vorgehen ergeben sich jedoch, wenn sich die Nummerierung im vdr-Hauptmenü ändert, weil etwa ein Plugin aktiviert oder deaktiviert wird. Das Makro funktioniert weiterhin, verweist jedoch dann eventuell auf den falschen Eintrag.


Es können maximal 15 Tasten in einer Makrodefinition verwendet werden.


Beispielsweise ruft das Makro

1.) User1 @abc Down Down Ok

den Menüeintrag des Plugins "abc" auf, betätigt zwei Mal die "Cursor down" Taste und bestätigt die Auswahl anschließend mit der Ok-Taste.

2.) User1 Menu 1

wählt das Hauptmenü aus, mit der 1 wird dann der erste Eintrag im Hauptmenü, meist die Programmliste, aufgerufen.


Die Makros für die Farbtasten (Red, Green, Yellow oder Blue) können nur im Standard Ansicht-Modus angesprochen werden (d.h. wenn kein anderes Menü oder kein anderer Player aktiv ist), die benutzerdefinierten Tasten (User1, User2, ..., User9) können überall angesprochen werden.




Datei
$VDRCONFIG/keymacros.conf
# Remote control key macros for VDR
#
# Format:
#
# macrokey  key1 key2 key3...
# macrokey  @plugin key1 key2 key3...
#
# See man vdr(5)

Red       Recordings
Green     Schedule
Blue      Timers
Yellow    @prefermenu