th-cmd(1) triggerhappy commander


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


This program is used to issue commands to a running triggerhappy daemon. It utilizes an unix domain socket bound by the daemon.


--socket socket
The socket file opened by the running triggerhappy daemon instance.
--add <devices...>
Instruct the running daemon to open the input devices specified on the command line
--remove <devices...>
Remove specified devices from the running daemon.
Remove all devices from the running daemon.
Deduce operation and device name from udev environment (for use in udev rules).
Disable the execution of triggers.
Re-enable the execution of triggers.
--mode <newmode>
Change the mode of the triggerhappy daemon to <newmode>. If no new mode is specified, the daemon switches to default mode.
Terminate the triggerhappy daemon.
Instead of instructing the daemon to open the device, open the device and pass 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.
Grab the device; the triggerhappy daemon will try to get exclusive access to the device, other applications will not receive the events emitted by it.
--tag foo
Label the added device with the tag <foo>; this can be used to limit the scope of event handlers to a subset of input devices.


Stefan Tomanek <[email protected]>