irsend(1)

1IRSEND(1)                        User Commands                       IRSEND(1)
2
3
4

NAME

6       irsend - basic LIRC program to send infra-red commands
7

SYNOPSIS

9       irsend [options] send_once <remote> <code> [code...]
10       irsend [options] send_start <remote> <code>
11       irsend [options] send_stop <remote> <code>
12       irsend [options] list <remote> <code>
13       irsend [options] set_transmitters <num> [num...]
14       irsend [options] simulate <button press packet>
15

DESCRIPTION

17       Asks the lircd daemon to send one or more CIR (Consumer Infra-Red) com‐
18       mands.  This is intended for remote control of electronic devices  such
19       as TV boxes, HiFi sets, etc.
20
21       irsend supports six sub-commands:
22       send_once         - send one or more code(s) once
23       send_start        - start repeating a code.
24       send_stop         - stop repeating code.
25       list              - list configured remote items
26       set_transmitters  - set active transmitters
27       simulate          - simulate IR event
28
29       remote is the name of a remote, as described in the lircd configuration
30       file.
31
32       code is the name of a remote control key of remote, as  it  appears  in
33       the lircd.conf configuration file.
34
35       num is the transmitter number of the hardware device.
36
37       For the list command, remote and/or code can be empty:
38
39              list   ""    ""   - list all configured remote names
40              list remote  ""   - list all codes of remote
41              list remote code  - list only code of remote
42
43       The  simulate  command  only works if it has been explicitly enabled in
44       lircd using the --allow-simulate option.   The  required  button  press
45       packet  should  formatted  as  a socket broadcast message documented in
46       lircd(8).
47

OPTIONS

49       -h --help
50              Display usage summary.
51
52       -v --version
53              Display version.
54
55       -d --device=device
56              Use given lircd socket [/var/run/lirc/lircd].
57
58       -a --address=host[:port]
59              Connect to lircd at this address.
60
61       -# --count=n
62              Send command n times.
63
64

ENVIRONMENT

66       LIRC_SOCKET_PATH
67           The lircd socket to connect to, defaults  to  a  hardcoded  default
68           value /var/run/lirc/lircd
69

FILES

71       /etc/lirc/lircd.conf
72              Default  lircd  configuration  file.   It should contain all the
73              remotes, their infra-red codes and the corresponding timing  and
74              waveform details.
75
76

DIAGNOSTICS

78       If  lircd  is  not  running (or /var/run/lirc/lircd lacks write permis‐
79       sions) irsend aborts with the following diagnostics:
80       "irsend: could not connect to socket"
81       "irsend: Connection refused" (or "Permission denied").
82

EXAMPLES

84       irsend LIST DenonTuner ""
85       irsend SEND_ONCE  DenonTuner PROG-SCAN
86       irsend SEND_ONCE  OnkyoAmpli VOL-UP VOL-UP VOL-UP VOL-UP
87       irsend SEND_START OnkyoAmpli VOL-DOWN ; sleep 3
88       irsend SEND_STOP  OnkyoAmpli VOL-DOWN
89       irsend SET_TRANSMITTERS 1
90       irsend SET_TRANSMITTERS 1 3 4
91       irsend SIMULATE "0000000000000476 00 OK TECHNISAT_ST3004S"
92

DRIVER LOADING

94       Drivers are loaded dynamically. The directory used for this  is  deter‐
95       mined by (falling priority):
96
97       - The environment variable LIRC_PLUGINDIR.
98
99       - The    'plugindir'   entry   in    the   [lircd]   section   of   the
100         lirc_options.conf file.
101
102       - A hardcoded default (/usr/lib64/lirc/plugins).
103