LIRC Python Package

Python Version Project Version Documentation Status Build Status Code Coverage Maintainability Code Formatter Contributing License Platform Support

This is a python package that allows you to interact with the daemon in the Linux Infrared Remote Control package. By interacting with the daemon, it allows you to programmatically send IR signals from a computer. This package is for emitting IR signals, but it does not support listening to IR codes.

More information on the lircd daemon, socket interface, reply packet format, etc. can be found at


This package is hosted on PyPI and can be installed through pip.

$ pip install lirc

However since this is a wrapper around the LIRC daemon, it is expected that LIRC is installed and setup on the given system as well.

More information on that can be found in the installation portion of the documentation.

Usage Quick Start

Customizing the Client

import lirc

client = lirc.Client()

>>> '0.10.1'

To use this package, we instantiate a Client. When we initialize the Client in the example above, we use the defaults by passing it no arguments.

The defaults use the LircdConnection class. These defaults depend on your operating system and can be looked up in the full documentation. However, we can customize these defaults if desired.

import socket
import lirc

client = lirc.Client(
    socket=socket.socket(socket.AF_UNIX, socket.SOCK_STREAM),
    timeout = 5.0

The address specifies how to reach the lircd daemon. On Windows, we pass a (hostname, port) tuple since we connect over TCP. However on Linux and macOS, we pass in the socket path as a string. For the client in the example above, we set it up using the defaults for a Linux machine. While it illustrates what is customizable, it is not a practical example since you could just call Client() if you’re on Linux and achieve the same outcome.

Sending IR

import lirc

client = lirc.Client()
client.send_once("my-remote-name", "KEY_POWER")
client.send_once("my-remote-name", "KEY_3", repeat_count=2)

With sending IR, we can use the send_once method and optionally, send multiple by using the repeat_count keyword argument.

Handling Errors

import lirc

client = lirc.Client()

    client.send_once('some-remote', 'key_power')
except lirc.LircdCommandFailureError as error:
    print('The command we sent failed! Check the error message')

If the command was not successful, a LircdCommandFailureError exception will be thrown. There are other errors that may be raised, which can be looked up in the full documentation, but this is the most likely when sending commands.

Further Documentation

More information on how to setup the system installed LIRC, how to use this python library, and a full API specification can be found at

Indices and tables