TH-CMD(1)

💖 TH-CMD(1) 💖

okay so this is the manual page for th-cmd, aka the triggerhappy commander. She's the one who talks to a running triggerhappy daemon, and honestly? main character energy. 💅

🎀 NAME 🎀

th-cmd — triggerhappy commander ✨

🦋 SYNOPSIS 🦋

th-cmd --socket <socket> [--passfd] [--tag <foo>]
[--clear|--enable|--disable|--mode <mode>|--quit|--udev|--add
<devices...>|--remove <devices...>]

🌸 DESCRIPTION 🌸

okay so th-cmd is literally used to issue commands to a running triggerhappy daemon. It utilizes a unix domain socket bound by the daemon. that's the whole vibe — little command messenger over the daemon's socket, bestie. 🫶

🔥 OPTIONS 🔥

• --socket socket — the socket file opened by the running triggerhappy daemon instance. that's your connection, ngl. 🔌
• --add <devices...> — instructs the running daemon to open the input devices specified on the command line. new devices, slay. ⌨️
• --remove <devices...> — removes specified devices from the running daemon. bye devices 👋
• --clear — removes all devices from the running daemon. all of them. periodt. 💀
• --udev — deduces operation and device name from the udev environment (for use in udev rules). iykyk. 🧚
• --disable — disables the execution of triggers. putting them on pause, fr fr. ⏸️
• --enable — re-enables the execution of triggers. we're so back. ▶️
• --mode <newmode> — changes the mode of the triggerhappy daemon to <newmode>. If no new mode is specified, the daemon switches to default mode. iconic default behavior. 🔄
• --quit — terminates the triggerhappy daemon. it's giving goodbye. 💀👋
• --passfd — instead of instructing the daemon to open the device, opens the device and passes the file descriptor to the daemon. this allows the adding of new devices to a daemon having dropped its privileges, however the th-cmd process must have access to the device file. caveat, bestie: that access part is not optional. 🔑
• --grab — grabs the device; the triggerhappy daemon will try to get exclusive access to the device, other applications will not receive the events emitted by it. exclusive access, no sharing. 🙅‍♀️
• --tag foo — labels the added device with the tag <foo>; this can be used to limit the scope of event handlers to a subset of input devices. tagged and fabulous. 🏷️

👑 AUTHOR 👑

Stefan Tomanek <stefan.tomanek+th@wertarbyte.de> 💌

---

that's the whole manual, bestie! 🫶 this page is from 0.5.0, dated 2022-07-21, and it's the TH-CMD(1) manual — she ate, no cap. 💅✨