Keymacros.conf

Aus VDR Wiki
(Unterschied zwischen Versionen)
Wechseln zu: Navigation, Suche
 
(3 dazwischenliegende Versionen von 2 Benutzern werden nicht angezeigt)
Zeile 1: Zeile 1:
Konfigurationsdatei von VDR.
+
Konfigurationsdatei des VDR
  
Die Konfigurationsdatei '''''keymacros.conf''''' enthält definierbare Makros, die ausgeführt werden, wenn die zugehörige Taste gedrückt wurde. (Die zughö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.)         
+
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
 
Das Format einer solchen Makrodefinition ist
Zeile 15: Zeile 15:
  
 
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.  
 
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 Pluginzu aktivieren. Die verbleibenden Einträge der Zeile definieren dann die weiteren Tasten, die bei Makro-Ausführung an das VDR gesendet werden.
+
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] ein bereits in VDR defnierter key aufgerufen werden. So etwa mit 'Menu' das Hauptmenü. Folgen dannach noch weitere keys, wird dieses Menü aufgerufen. Die möglichen vordefinierten keys sind etwa unter [[remote.conf]] zu finden. Dieses Vorgehen ist dann hilfreich, wenn etwa den genauen Namen in der obrigen '-P Option' nicht kennt.
+
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 evtl. auf den falschen Eintrag.
+
 
 +
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.
  
  
Zeile 34: Zeile 35:
 
2.) User1 Menu 1
 
2.) User1 Menu 1
  
wählt das Hauptmenü aus, mit der 1 wird dann der erste Eintrag im Hauptmenu, meist die Programmliste, aufgerufen.
+
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
 
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),
 
Ansicht-Modus angesprochen werden (d.h. wenn kein anderes Menü oder kein anderer Player aktiv ist),
die benutzdefinierten Tasten ('''''User1''''', '''''User2''''', ..., '''''User9''''') können überall angesprochen werden.
+
die benutzerdefinierten Tasten ('''''User1''''', '''''User2''''', ..., '''''User9''''') können überall angesprochen werden.
  
  

Aktuelle Version vom 6. Februar 2010, 13:14 Uhr

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