prog¶

Hierüber wird das Programm angesteuert, das per Fernbedienung Anweisungen erhalten soll. Dabei ist irexec das LIRC-eigene Programm, über das sich alle Befehle, die auch in einem Terminal verwendet werden können, ausführen lassen. Außerdem lassen sich alle Programme mit eigener LIRC-Unterstützung angeben. Sonderfall sind etliche KDE-Programme, die über irexec und D-Bus-Befehle gesteuert werden (z.B. Kaffeine, Amarok).

remote¶

Diese Angabe ist nur nötig, wenn mehrere Fernbedienungen verwendet werden sollen; der Standardwert ist der Platzhalter "*", der aber nicht explizit angegeben werden muss. Der Name der Fernbedienung findet sich im Normalfall in der verwendeten lircd.conf. Mehr zum Sonderfall mit mehreren Fernbedienungen auf lirc.org .

button¶

Der Name der Taste, die verwendet werden soll. Dabei muss der Name so geschrieben werden, wie er in der lircd.conf-Datei verzeichnet ist, allerdings unterscheidet lircd nicht zwischen Groß- und Kleinschreibung. Im Zweifelsfall kann über das Programm irw der jeweils verwendete Tastenname aufgerufen werden. Es lassen sich auch Tastensequenzen festlegen, in dem mehrere button-Zeilen hintereinander verwendet werden (sinnvoll, wenn z.B. ein versehentliches Ausführen eines potentiell "gefährlichen" Befehls - shutdown o.ä. - verhindert werden soll). Tastensequenzen verwenden so lange die zu Anfang genutzte Fernbedienung bis explizit eine andere angegeben wird; die remote-Anweisung muss daher immer vor den button-Anweisungen stehen. Tastensequenzen funktionieren ggf. auch dann, wenn den Tasten noch anderen Funktionen zugeordnet sind; es werden allerdings sofort auch diese Funktionen ausgeführt; die zweite/letzte Taste sollte dann aber auch (wenn nicht z.B. der Modus gewechselt wurde) zum Ausführen der "gesicherten" Anweisung führen. Eine flags = quit-Anweisung zwischen zwei button-Zeilen bleibt dabei interessanterweise wirkungslos; nach dem letzten button gesetzt funktioniert sie aber normal. In Sequenzen kann auch die selbe Taste mehrfach verwendet werden.

repeat¶

Diese Anweisung legt fest, was bei anhaltendem Druck auf eine Taste geschieht. Der Standard-Wert (der auch ohne Angabe verwendet wird) ist 0; er führt dazu, dass wiederholte Impulse ignoriert werden. Andere Werte (positve Ganzzahl n) führen dazu, dass die Anweisung in config jedes n-te Mal des Tastendruckes ausgeführt wird, nicht aber wie oft; das ist abhängig von der Länge des Tastendrucks! Wenn eine Dauerfunktion (wie z.B. für die Lautstärkeregelung) gewünscht wird, kann mit einer repeat-Anweisung festgelegt werden, wie schnell die Änderung vonstatten gehen soll. Ein Dauerdruck erzeugt im Normalfall eine ständige Wiederholung des Impulses, diese wird dann jedes festgelegt Mal ausgeführt. Falls trotz einer solchen Angabe keine Wiederholung des Befehls ausgeführt wird, liegt eventuell ein Problem in der Konfiguration der verwendeten lircd.conf und dem verwendeten toggle_bit_mask bzw. pre_data-Wert vor.

delay¶

Hier lässt sich, ebenfalls durch eine positive Ganzzahl n, festlegen, wie viele Impulse ignoriert werden, bis die in der repeat-Anweisung festgelegte Konfiguration ausgeführt wird. Standard ist ebenfalls 0, damit ist diese Funktion zunächst ausgeschaltet. Sinnvoll ist die Verwendung z.B. dann, wenn bei schneller Wiederhol-Rate der Fernbedienung (der gap-Wert in der lircd.conf steht für die Zeitspanne zwischen den Impulsen in msec) mehrfaches Senden und Ausführen von Befehlen verhindert werden soll. Die Verwendung ohne einen repeat-Wert führt dazu, dass der Befehl erst verzögert, aber dann auch nur einmal, ausgeführt wird (repeat = 0 und delay = 0-Angaben sind allerdings überflüssig, weil Standard...).

config¶

Hier steht der eigentliche Befehl, der von dem mit prog angesteuerten Programm ausgeführt werden soll. Es lassen sich (für irexec) in einer Zeile beliebig viele Befehle hintereinander aufreihen (getrennt durch die Zeichenfolge &&), die auf den einen Tastendruck hin ausgeführt werden sollen. Programme mit LIRC-Support lassen das allerdings nicht unbedingt zu (so z.B. VLC). Zwei (oder mehrere) hintereinander folgende config-Zeilen werden im Wechsel ausgeführt, sodass beim ersten Druck die erste, beim erneutem Druck dann die zweite config-Zeile (etc.) abgearbeitet wird; so lassen sich z.B. Play/Plause-Wechsel-Funktionen erstellen, falls sie in einem Programm nicht vorgesehen sind.

irexec kann jeden Befehl ausführen, der auch im Terminal verwendbar ist; damit lassen sich alle Programme, Skripte, oder Befehle - auch mit ggf. gewünschten Parametern - starten; z.B. kann so einem Musik-Player gleich die abzuspielende Playlist mit auf den Weg gegeben werden.

Um Zeichenfolgen zu übergeben, die nicht ohne weiteres darstellbar sind, lassen sich alle in C üblichen "escape"-Sequenzen ( wie \n = line-feed, \r = ⏎ , \t = Tab ⇆ , \e = Esc , \<n> = ASCII-Code in oktaler Darstellung, \x<n> = ASCII-code in hexadezimaler Darstellung, \\ = backslash) verwenden. Auch die Strg -Taste lässt sich so darstellen : \C steht z.B. für Strg + C .

Welche Befehle für Programme mit LIRC-Support verwendet werden können, lässt sich meist in der Programmdokumentation in Erfahrung bringen oder wird in den FAQs der jeweiligen Web-Seite der Programme erklärt. Hilfreich kann auch eine Websuche nach dem gewünschten Programm und lircrc sein.

Damit Programme mit integrierter LIRC-Unterstützung, die mit einem irexec-Befehl gestartet werden, die Verwendung der Fernbedienung für andere Anwendungen nicht blockieren, sollte ans Ende der programmaufrufenden config-Zeile ein &-Zeichen gestellt werden (z.B. config = rhythmbox &). Wenn es fehlt, werden die Befehle für weitere Anwendungen solange nicht ausgeführt, wie das aktuell gesteuerte Programm läuft; diese Anweisungen werden zunächst gespeichert und dann erst nach Abschluss des laufenden Programms ausgeführt - was zu unbeabsichtigten Folgen führen kann. Wer z.B. wiederholt die Taste zum Starten eines Programms gedrückt hatte, sieht sich später mit immer neuem Starten dieses Programms konfrontiert, so oft, wie die Taste zuvor - vermeintlich wirkungslos - gedrückt worden war...

mode¶

Hiermit lassen sich Befehle für ein Programm oder eine Funktion zusammenfassen. Ein "Modus" wird zunächst mit einer Taste gestartet (z.B. zusammen mit dem Startaufruf eines Programms; der Wechsel in den Modus erfolgt sofort); die Konfigurationsblöcke für diesen Modus werden mit begin <Modename> und end <Modename> eingeschlossen. Damit lassen sich die Steuerbefehle für verschiedene Programme trennen und die selben Tasten in verschiedenen Programmen für unterschiedliche Funktionen verwenden, ohne dass sie sich "ins Gehege kommen". Innerhalb eines mode-Blocks lassen sich keine weiteren mode-Blöcke verschachteln; diese müssen immer außerhalb definiert werden.

Da LIRC die .lircrc grundsätzlich bei jedem Tastendruck von oben nach unten ausliest, kann es mit Modi u.U. zu ungewolltem Ausführen von Befehlen kommen. Die mode-Anweisungsblöcke werden zusätzlich dann verwendet, wenn der entsprechende Modus gestartet wurde; allerdings schließt die Verwendung einer Taste in einem Modus nicht aus, dass auch ein Befehl dieser Taste außerhalb eines Modus ausgeführt wird. Wer also z.B. die OK-Taste mit einer Funktion (ohne Modus) belegt hat, und die OK-Taste auch in einem Modus verwendet, wird feststellen, dass beide Funktionen ausgeführt werden, wenn die Taste innerhalb des Modus gedrückt wird. Die Reihenfolge ist dabei abhängig von der Position der Konfigurationsblöcke in der .lircrc. Abhilfe kann das quit-Flag schaffen; außerdem sollte man ggf. die mode-Blöcke an den Anfang der .lircrc stellen, vor die "allgemeinen" Anweisungen und vor jene, die den jeweiligen Modus aufrufen (mehr dazu siehe Die Relevanz der Reihenfolge).

Programme mit integriertem LIRC-Support lassen sich, wenn sie innerhalb einer mode-Funktion gesteuert werden sollen, anscheinend nur mit einem Modus verwenden, der den Namen des betreffenden Programms hat; sie lassen sich in anderen Modi nicht aufrufen, sondern suchen "ihren" Modus. (Wer z.B. einen mode = music erstellt und darin versucht, prog = rhythmbox-Befehle aufzurufen, dürfte keinen Erfolg haben, der Modus muss anscheinend mode = rhythmbox heißen).

Außerdem lesen Programme mit LIRC-Support beim Start die .lircrc aus und starten dann automatisch in dem Modus mit dem Namen der Anwendung, wenn dieser vorhanden ist. Ein explizites Starten des Modus ist nicht nötig, die Programme können so mit der Fernbedienung gesteuert werden wie es im Modus festgelegt ist. Das kann allerdings bei Start mehrerer Programme dazu führen, dass die Modi nicht mehr sauber getrennt werden und alle Programme gleichzeitig auf denselben Tastendruck reagieren. Eigentlich soll lircrcd das wohl verhindern; falls das nicht funktioniert, kann das Problem umgangen werden, in dem die Programme immer nur per Fernbedienung mit dem entsprechenden Modus-Eintrag gestartet werden.

Die mode-Funktion lässt sich auch ohne andere Anweisungen verwenden; so kann z.B. innerhalb eines Modus mit einem Tastendruck direkt in einen anderen Modus umgeschaltet werden; das kann sinnvoll sein, wenn zwischen zwei laufenden Anwendungen direkt umgeschaltet, oder eine Anwendung gesteuert werden soll, die zunächst nicht über die Fernbedienung gestartet wurde, deren Modus aber an den Startaufruf gekoppelt war.

Aus der offiziellen LIRC-Dokumentation noch folgendes Zitat:

Caveat: In order to avoid many identical entries all actions that modify the mode a program currently is in are independent of the prog token.

Übersetzung: "Achtung: Um eine Vielzahl gleichlautender Einträge zu vermeiden, sind alle Aktionen, die den Modus eines Programmes, in dem es sich gerade befindet, modifizieren, unabhängig von der "prog"-Anweisung."

Theoretisch soll das wohl bedeuten, dass, wenn für ein Programm der Modus geändert wird, im neuen mode-Block auf die prog-Anweisung verzichtet werden kann. In der Praxis aber lassen sich ggf. Programme mit LIRC-Support sowieso nur in dem Modus mit dem eigenen Namen steuern... Im Zweifelsfall daher weiterhin eine prog-Anweisung verwenden.

flags¶

Unter "flags" werden spezielle Steueranweisungen verstanden, die sich im Zusammenhang mit bestimmten anderen Anweisungen verwenden lassen. Sie werden mit "flags = <Name des flags>" aufgerufen.

include¶

Die .lircrc-Datei kann, um bei umfangreicheren Vorhaben mit mehreren zu steuernden Programmen/Funktionen die Übersicht zu behalten, unterteilt werden; die einzelnen Dateien können dann mit include /Pfad/zur/Datei aufgerufen werden. includes werden dabei in der Reihenfolge genauso verarbeitet, wie andere Anweisungen: Trifft LIRC auf einen include-Befehl, wird zunächst die angegebene Datei (von oben nach unten) ausgelesen, um dann in der eigentlichen .lircrc weiter fortzufahren. So lassen sich Funktionen, die in allen Programmen zur Verfügung stehen sollen (z.B. Lautstärkeregelung), in einer Datei zusammenfassen, und die Steuerbefehle für die einzelnen Programme jeweils in einer entsprechend benannten Datei ablegen. Sie können dann gemeinsam, z.B. in einem Modus-Eintrag, aufgerufen werden:

 1
 2
 3
 4
 5
 6
 7
 8
 9
10

...
begin rhythmbox
include ~.lirc/volume
include ~.lirc/rhythmbox
end rhythmbox

begin vlc
include ~.lirc/volume
include ~.lirc/vlc
end vlc

lircrcd¶

Weiteres Zitat aus der offiziellen Dokumentation:

If you start a LIRC client program, it reads your ~/.lircrc and reacts only on prog= entries which point to itself. All programs should give you the possibility to use an alternative config file. If you have included more than one program in your .lircrc, then start all these programs, they react only to their according entries in .lircrc. This also leads to a disadvantage of the mode concept. If you don't start all client programs at a time the mode they have to maintain may differ between applications. Also key sequences might not be recognized equally because all programs then don't have the same starting point. In order to solve this problem there is the new lircrcd program since version 0.8.0. lircrcd's purpose is to synchronise all clients and maintain the current mode. In order to use the lircrcd feature you have to explicitly enable it by adding the following line at the beginning of the file:

#! lircrcd

Übersetzt:
"Wenn ein Programm mit LIRC-Support gestartet wird, liest es die ~/.lircrc-Datei aus und reagiert nur auf prog =-Einträge, die auf eben dieses verweisen. Alle Programme sollten die Möglichkeit bieten, eine alternative Konfigurations-Datei zu verwenden. Wenn in eine .lircrc-Datei mehr als ein Programm aufgenommen wurde, und dann all diese Programme starten, reagieren sie nur auf ihre entsprechenden .lircrc-Einträge. Das zeigt auch einen Nachteil des Modus-Konzeptes auf. Wenn nicht alle Programme mit LIRC-Unterstützung gleichzeitig starten, kann der Modus, den sie verwalten müssen, zwischen Anwendungen differieren. Auch könnten Tasten-Sequenzen nicht als gleiche/entsprechend erkannt werden, denn dann haben nicht alle Programme den selben Startzeitpunkt. Um dieses Problem zu lösen, existiert seit Version 0.8.0 das neue Programm lircrcd. Aufgabe von lircrcd ist es, alle Programme mit LIRC-Support zu synchronisieren, und den derzeitigen Modus zu verwalten. Um diese Funktion nutzen zu können, muss sie explizit durch Aufnahme der Zeile #! lircrcd am Anfang der .lircrc ermöglicht werden."

Christoph Bartelmus (der LIRC-Entwickler) erläutert diesen Passus folgendermaßen:

[Verwendung der .lircrc] ohne lircrcd:
Jedes Programm hat jeweils eine Variable, die heißt: mode

Da die Programme in der Regel nicht gleichzeitig gestartet werden, kann es leicht vorkommen, dass sich mode von Programm A und mode von Programm B voneinander unterscheiden. Das Verhalten ist dann nicht leicht nachvollziehbar.

Mit lircrcd:
Es gibt nur noch eine Variable mode, die von lircrcd verwaltet wird und alle Programme fragen bei lircrcd nach, wie der Inhalt von mode ist. Also sind alle im gleichen Modus, unabhängig davon wann sie gestartet wurden.

Bei der Verwendung ohne lircrcd "suchen" die Programme mit LIRC-Support ohne explizite Modus-Angabe (also wenn sie von "außerhalb" gestartet wurden) nach Einträgen in der .lircrc, aber auch in den Modus-Blöcken! Das kann dazu führen, dass bei mehreren so gestarteten Programmen ohne mode-Angabe nicht eindeutig ist, welcher Befehl ausgeführt werden soll. Ggf. werden bei Tastenbelegung für mehrere Programme die Anweisungen gleichzeitig ausgeführt, z.T. aber wird nicht unbedingt nach Reihenfolge abgearbeitet; das Verhalten wird damit unberechenbar. lircrcd soll diese "Modi" der Programme synchronisieren. Mit der Verwendung von lircrcd scheinen "außerhalb" gestartete Programme ohne Modusangabe allerdings nur auf der "Grundebene" der .lircrc nach entsprechenden prog-Anweisungen zu suchen. Wenn sich dort aber keine finden lassen, weil sie alle im entsprechenden mode-Block stehen, funktionieren die Tasten ohne einen expliziten Wechsel in den entsprechenden Modus nicht. Ggf. kann dann eine prog-Anweisung außerhalb des mode-Blocks mit einem entsprechendem Moduswechsel das Programm "auf die richtige Spur" setzen.

Die Verwendung dieser Funktion mit Rhythmbox (und auch Totem) ist dabei anscheinend fehlerhaft; prog-Anweisungen werden mit der Verwendung von #! lircrcd ggf. nicht ausgelesen/ausgeführt (siehe auch hier im Forum). Abhilfe schafft es wohl nur, auf lircrcd zu verzichten, und alle Programme immer mit einer entsprechenden mode-Anweisung mit der Fernbedienung zu starten. Dann kommt es nicht zu Problemen mit unklaren Modi (siehe Beispiele).

irexec¶

irexec ist im lirc-Paket enthalten. irexec sendet beliebige Befehle auf der Kommandozeilen-Ebene und ermöglicht es so, alle Programme oder Befehle zu starten und zu steuern, soweit diese auch in einem Terminal bedienbar sind. Dabei greift es auf .lircrc im Homeverzeichnis zurück. Damit die Befehle umgesetzt werden, muss irexec (zunächst im Terminal) als normaler Benutzer gestartet werden:

irexec -d 

Um den Befehl nicht nach jedem Systemstart manuell aufrufen zu müssen sollte die ~/.profile die folgende Zeile enthalten:

/usr/bin/irexec -d

Möchte man das zentral für jedem Systembenutzer konfigurieren, so kann der Aufruf auch in /etc/profile hinzugefügt werden.

irxevent¶

irxevent befindet sich im Paket

• lirc-x (universe)

mit apturl

sudo apt-get install lirc-x 

sudo aptitude install lirc-x 

irxevent ist in der Lage, einzelne Tasten oder Tastenkombinationen auf dem Keyboard an bestimmte Anwendungen zu schicken. Zappte man bisher z.B. mit den Pfeiltasten auf der Tastatur durch seine Senderliste, kann das nun auch per Fernbedienung erledigt werden. Die Syntax in .lircrc unter config ist dabei: Key (d.h. es folgt eine Taste) <Name der Taste> (beschrieben unter /usr/share/doc/lirc/irxevent.keys) <Name des Programms>, als Beispiel config = Key alt-ctrl-t x-session-manager. Bei entsprechender Tastenkombination lässt sich so zum Beispiel der Zoom von Compiz ausführen. Genauere Informationen finden sich in der manpage des Programms. Damit die Befehle umgesetzt werden können, muss irxevent (zunächst im Terminal) als normaler Benutzer gestartet werden:

irxevent -d 

Auch hier gilt: Um es dann dauerhaft nutzen zu können, empfiehlt es sich, es schon beim Systemstart, z.B. durch Eintrag in die rc.local, aufzurufen.

xte¶

Manchmal kennt man den genauen Namen eines Programms, das aufgerufen wird, wenn man die Tastenkombination XY drückt, gar nicht. Oder man möchte die Zifferntasten in allen Anwendungen so nutzen wie den Numblock der Tastatur. Abhilfe schafft dabei das Programm xte. Mit ihm lassen sich vom Terminal aus alle Tasten des Keyboards simulieren, sodass für den Rechner kein Unterschied zwischen einem "echten" Tastendruck und dem Befehl von xte erkennbar ist. xte befindet sich im Paket

• xautomation (universe)

mit apturl

sudo apt-get install xautomation 

sudo aptitude install xautomation 

Um das Programm in Verbindung mit LIRC nutzen zu können, wird es in .lircrc mittels irexec gestartet. Die relevante Zeile sieht dabei folgendermaßen aus: config = xte 'key 1', oder für eine Tastenkombination: config = xte 'keydown Alt_L' 'keydown 2' 'keyup Alt_L' 'keyup 2'. Die Namen der Tasten sind in der manpage des Programms beschrieben.

Basisdateien¶

.lircrc

 1
 2
 3
 4
 5
 6
 7
 8
 9
10

#Custom lircrc generated via mythbuntu-lirc-generator
#All application specific lircrc files are within ~/.lirc
include ~/.lirc/mythtv 
include ~/.lirc/mplayer 
include ~/.lirc/xine 
include ~/.lirc/vlc 
include ~/.lirc/xmame 
include ~/.lirc/xmess 
include ~/.lirc/totem 
include ~/.lirc/elisa 

~/.lirc/totem

  1
  2
  3
  4
  5
  6
  7
  8
  9
 10
 11
 12
 13
 14
 15
 16
 17
 18
 19
 20
 21
 22
 23
 24
 25
 26
 27
 28
 29
 30
 31
 32
 33
 34
 35
 36
 37
 38
 39
 40
 41
 42
 43
 44
 45
 46
 47
 48
 49
 50
 51
 52
 53
 54
 55
 56
 57
 58
 59
 60
 61
 62
 63
 64
 65
 66
 67
 68
 69
 70
 71
 72
 73
 74
 75
 76
 77
 78
 79
 80
 81
 82
 83
 84
 85
 86
 87
 88
 89
 90
 91
 92
 93
 94
 95
 96
 97
 98
 99
100
101
102
103
104
105
106
107
108
109
110

# LIRCRC Auto Generated by Mythbuntu Lirc Generator
# Author(s): Mario Limonciello, Nick Fox
# Created for use with Mythbuntu
begin
    remote = Terratec_Cinergy_HT_PCI_
    prog = totem
    button = INFO
    config = show_playing
    repeat = 0
    delay = 0
end

begin
    remote = Terratec_Cinergy_HT_PCI_
    prog = totem
    button = Play
    config = play_pause
    repeat = 0
    delay = 0
end

begin
    remote = Terratec_Cinergy_HT_PCI_
    prog = totem
    button = PAUSE
    config = pause
    repeat = 0
    delay = 0
end

begin
    remote = Terratec_Cinergy_HT_PCI_
    prog = totem
    button = Mute
    config = mute
    repeat = 0
    delay = 0
end

begin
    remote = Terratec_Cinergy_HT_PCI_
    prog = totem
    button = Vol-
    config = volume_down
    repeat = 0
    delay = 0
end

begin
    remote = Terratec_Cinergy_HT_PCI_
    prog = totem
    button = Up
    config = up
    repeat = 0
    delay = 0
end

begin
    remote = Terratec_Cinergy_HT_PCI_
    prog = totem
    button = Vol+
    config = volume_up
    repeat = 0
    delay = 0
end

begin
    remote = Terratec_Cinergy_HT_PCI_
    prog = totem
    button = Down
    config = down
    repeat = 0
    delay = 0
end

begin
    remote = Terratec_Cinergy_HT_PCI_
    prog = totem
    button = Right
    config = right
    repeat = 0
    delay = 0
end

begin
    remote = Terratec_Cinergy_HT_PCI_
    prog = totem
    button = FF
    config = seek_forward
    repeat = 0
    delay = 0
end

begin
    remote = Terratec_Cinergy_HT_PCI_
    prog = totem
    button = DVD
    config = play_dvd
    repeat = 0
    delay = 0
end

begin
    remote = Terratec_Cinergy_HT_PCI_
    prog = totem
    button = Left
    config = left
    repeat = 0
    delay = 0
end