IRSEND(1)

💖 IRSEND(1) — the lirc bestie that yeets infra-red commands 💖

okay so real talk, this is irsend from the User Commands corner of the manual world, and she's here to make your TV box, your HiFi, and honestly any lil electronic diva actually do things. 🫶

---

✨ NAME ✨

irsend — the basic LIRC program that sends infra-red commands, no cap 🔥

---

🎀 SYNOPSIS 🎀

irsend [options] send_once <remote> <code> [code...]
irsend [options] send_start <remote> <code>
irsend [options] send_stop <remote> <code>
irsend [options] list <remote> <code>
irsend [options] set_transmitters <num> [num...]
irsend [options] simulate <button press packet>

---

🌸 DESCRIPTION 🌸

So basically, irsend slides into the lircd daemon's DMs and asks her to send one or more CIR (Consumer Infra-Red) commands. It's giving remote control of electronic devices, like TV boxes, HiFi sets, all of that. ✨

irsend has six sub-commands and bestie, we're listing all of them, periodt:

• send_once — send one or more code(s) once
• send_start — start repeating a code.
• send_stop — stop repeating code.
• list — list configured remote items
• set_transmitters — set active transmitters
• simulate — simulate IR event

---

remote is the name of a remote, exactly as it's described in the lircd configuration file. iykyk. 💅

code is the name of a remote control key of remote, as it appears in the lircd.conf configuration file.

num is the transmitter number of the hardware device. 🔢

---

🦋 the list command tea 🦋

For the list command, remote and/or code can be empty:

list   ""    ""   - list all configured remote names
list remote  ""   - list all codes of remote
list remote code  - list only code of remote

---

🙈 the simulate command tea 🙈

The simulate command only works if it has been explicitly enabled in lircd using the --allow-simulate option. No enabling, no simulating, bestie. 😭

The required button press packet should be formatted as a socket broadcast message documented in lircd(8).

---

💅 OPTIONS 💅

• -h, --help — Display usage summary. (the "what do I even do" button 🫶)
• -v, --version — Display version.
• -d, --device=device — Use given lircd socket [/var/run/lirc/lircd].
• -a, --address=host[:port] — Connect to lircd at this address.
• -#, --count=n — Send command n times. (yes, the option literally starts with a #, iconic behaviour ⭐)

---

🌈 ENVIRONMENT 🌈

• LIRC_SOCKET_PATH — The lircd socket to connect to, defaults to a hardcoded default value /var/run/lirc/lircd

---

🍓 FILES 🍓

• /etc/lirc/lircd.conf — Default lircd configuration file. It should contain all the remotes, their infra-red codes and the corresponding timing and waveform details. 💖

---

💀 DIAGNOSTICS 💀

If lircd is not running (or /var/run/lirc/lircd lacks write permissions), irsend aborts with the following diagnostics — and it's giving tragic, fr fr:

"irsend: could not connect to socket"
"irsend: Connection refused" (or "Permission denied").

no socket, no service. the vibe check failed. 😭

---

🔥 EXAMPLES 🔥

irsend LIST DenonTuner ""
irsend SEND_ONCE  DenonTuner PROG-SCAN
irsend SEND_ONCE  OnkyoAmpli VOL-UP VOL-UP VOL-UP VOL-UP
irsend SEND_START OnkyoAmpli VOL-DOWN ; sleep 3
irsend SEND_STOP  OnkyoAmpli VOL-DOWN
irsend SET_TRANSMITTERS 1
irsend SET_TRANSMITTERS 1 3 4
irsend SIMULATE "0000000000000476 00 OK TECHNISAT_ST3004S"

ate. 💅

---

👑 DRIVER LOADING 👑

Drivers are loaded dynamically. The directory used for this is determined by (falling priority):

1. The environment variable LIRC_PLUGINDIR.
2. The 'plugindir' entry in the [lircd] section of the lirc_options.conf file.
3. A hardcoded default (/usr/lib/x86_64-linux-gnu/lirc/plugins).

---

🌟 SEE ALSO 🌟

• lircd(8)
• mode2(1)
• xmode2(1)
• irrecord(1)
• irw(1)

---

and that's the whole page, bestie!! 🧚 this lil masterpiece is irsend 0.10.2, and the last change was Mar 2017 — so yeah, she's been serving infra-red realness for a minute and she's still that girl. go send some codes, you got this 💜🎀🦋