Keymacros.conf

Aus VDR Wiki
(Unterschied zwischen Versionen)
Wechseln zu: Navigation, Suche
(M)
 
(22 dazwischenliegende Versionen von 8 Benutzern werden nicht angezeigt)
Zeile 1: Zeile 1:
<pre># Remote control key macros for VDR
+
Konfigurationsdatei des VDR
#
+
# Format:
+
#
+
# macrokey  key1 key2 key3...
+
# macrokey  @plugin key1 key2 key3...
+
#
+
# See man vdr(5)
+
  
Red      Recordings
+
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.)       
Green    Schedule
+
 
Blue      Timers</pre>
+
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.
 +
 
 +
 
 +
----
 +
 
 +
 
 +
{{Box Datei | [[Struktur|$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-plugin|prefermenu]]
 +
}}
 +
 
 +
[[Kategorie:Konfigurationsdateien]]

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