LIRC Binding

This binding integrates infrared transceivers through LIRC or WinLIRC.

A list of remote configuration files for LIRC is available here.

Supported Things

This binding supports LIRC and WinLIRC as bridges for accessing the configured remotes.

LIRC must be started with TCP enabled. On systemd based systems, TCP can be enabled by editing the file /usr/lib/systemd/system/lirc.service and adding --listen to the end of the ExecStart line. An example systemd service file for LIRC is shown below.

Description=Linux Infrared Remote Control

ExecStart=/usr/sbin/lircd --nodaemon --driver=default --device=/dev/lirc0 --listen


By default, LIRC will listen on IP address (any available IP address) and port 8765. If you would rather run LIRC on a specific port or IP address, you can use --listen= instead.


Discovery of the LIRC bridge is not supported. However, remotes will be automatically discovered once a bridge is configured.

Example Configuration


Bridge lirc:bridge:local [ host="", port="9001" ] {
    Thing remote Onkyo_RC_799M [ remote="Onkyo_RC-799M" ]
    Thing remote Samsung [ remote="Samsung" ]


  • host: IP address or hostname of the LIRC server. Defaults to localhost
  • port: The port number the LIRC server is listening on. Defaults to 8765


  • remote: The name of the remote as known by LIRC


String Remote_AVReceiver { channel="lirc:remote:local:Onkyo_RC_799M:transmit" }
String Remote_TV { channel="lirc:remote:local:Samsung:transmit" }


rule "LIRC Test"
    Channel 'lirc:remote:local:Samsung:event' triggered KEY_DVD
    // Toggle base boost on the AV Receiver
    sendCommand(Remote_AVReceiver, "KEY_BASEBOOST")
    // Increase the volume by 5.
    sendCommand(Remote_AVReceiver, "KEY_VOLUMEUP 5")


This binding currently supports following channels:

Channel Type ID Item Type Description
event Trigger Triggers when a button is pressed.
transmit String Used to transmit IR commands to LIRC.