GitLocker: The Coding Marketplace

Description:

lirc 2.0.2

This is a python package that allows you to interact with the daemon in the
Linux Infrared Remote Control package. By interacting
with this 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. If you’d like to monitor the IR signals you recieve on
Linux, which has built-in support in the kernel for recieving IR signals, you
can try using python-evdev.
They have a tutorial on reading the events.
More information on the lircd daemon, socket interface,
reply packet format, etc. can be found at https://www.lirc.org/html/lircd.html

Maintainance Status
This project is maintained, but it is not actively developed.
It is feature complete for my purposes.

Installation
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 full documentation.

Quick Start

Using the Client
import lirc

client = lirc.Client()

print(client.version())
>>> '0.10.1'
To use this package, we instantiate a Client. By initializing it
with no arguments, the Client will attempt to connect to the lirc
daemon with the default connection parameters for your operating system.
These defaults depend on your operating system and can be looked up in the
full documentation if you need different parameters.
However, if you’ve instantiated the Client without any arguments,
you don’t get any errors, and you recieve a response from the version()
command, you are connected to the daemon. Most people should not need to
change the default parameters.

Customizing the Client
As previously stated, we can customize these defaults if needed.
import socket
import lirc

client = lirc.Client(
connection=lirc.LircdConnection(
address="/var/run/lirc/lircd",
socket=socket.socket(socket.AF_UNIX, socket.SOCK_STREAM),
timeout = 5.0
)
)
For the client in the example above, we set it up using the defaults for a Linux machine.
While this example illustrates what is customizable, it is not a practical example since
you could call Client() with no arguments if you’re on Linux and achieve the same outcome.
See Overriding LIRC Defaults on Initialization
for more information.

Sending IR
import lirc

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

# Go to channel "33"
client.send_once("my-remote-name", "KEY_3", repeat_count=1)
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()

try:
client.send_once('some-remote', 'key_power')
except lirc.exceptions.LircdCommandFailureError as error:
print('Unable to send the power key!')
print(error) # Error has more info on what lircd sent back.
If the command was not successful, a LircdCommandFailureError
exception will be thrown.

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
https://lirc.readthedocs.io/