Return to Main Contents
lircmd - LIRC mouse daemon translates infrared signals into mouse events
lircmd [options] [config-file]
This daemon can simulate a MouseSystems, IntelliMouse or IMPS/2 type mouse. It
gets the received buttons from lircd and converts them to mouse events. To
make this possible, lircmd needs a config file located
in /etc/lircmd.conf. In this file you have to determine which
button from which remote causes a mouse move or a mouse button click.
You can also specify a special button which activates or deactivates the mouse
- -h --help
display this message
- -v --version
- -n --nodaemon
don't fork to background
-O --options-file=file alternative default options file
- -u --uinput
- generate Linux input events
If you provide the --nodaemon option lircmd won't fork to background.
On Linux systems the --uinput option will enable automatic generation
of Linux input events. lircmd will open /dev/input/uinput and inject
the simulated mouse events into the Linux kernel rather than creating
the /dev/lircm device.
lircmd will use syslogd to output error messages. It depends on your
system configuration where they will show up.
The options file is by default /etc/lirc/lirc_options.conf; lircmd handles
the values under the [lircd] section in this file. The location can
be changed using the -O/--options-file command-line option or using the
environment variable LIRC_OPTIONS_PATH. The values here are used as
defaults for any option not present on command line.
lircmd is a daemon. You should start it in some init script
depending on your system. Besides the preferred systemd setup which is
installed by default there are also example scripts for other distros
and init systems in the contrib directory. lircmd has to be started after
lircd as it connects to the socket lircd provides.
If you start lircd or lircmd from your shell prompt you will usually get
back immediately to the prompt. This is not an error, daemons always run
The LIRC Manual, last update: 10-June-2014