OS Manuals

/usr/bin/ir-keytable

Linux media (V4L2/DVB/CEC/IR) utilities and libraries

From v4l-utils 1.32.0-r1 (enterprise-packages), captured 2026-11-08 by running ir-keytable --help (exit 0). permalink

Usage: ir-keytable [OPTION...]

Lists Remote Controller devices, loads rc keymaps, tests events, and adjusts
other Remote Controller options. Rather than loading a rc keymap, it is also
possible to set protocol decoders and set rc scancode to keycode mappings
directly.
You need to have read permissions on /dev/input for the program to work

On the options below, the arguments are:
  SYSDEV    - the rc device as found at /sys/class/rc
  KEYMAP    - a keymap file with protocols and scancode to keycode mappings
  SCANKEY   - a set of scancode1=keycode1,scancode2=keycode2.. value pairs
  PROTOCOL  - protocol name (nec, rc-5, rc-6, jvc, sony, sanyo, rc-5-sz, lirc,
              sharp, mce_kbd, xmp, imon, rc-mm, other, all) to be enabled,
              or a bpf protocol name or file
  DELAY     - Delay before repeating a keystroke
  PERIOD    - Period to repeat a keystroke
  PARAMETER - a set of name1=number1[,name2=number2]... for the BPF prototcol
  CFGFILE   - configuration file that associates a driver/table name with
              a keymap file

Options can be combined together.

  -a, --auto-load=CFGFILE    Auto-load keymaps, based on a configuration file.
                             Only works with --sysdev.
  -c, --clear                Clears the scancode to keycode mappings
  -D, --delay=DELAY          Sets the delay before repeating a keystroke
  -e, --parameter=PARAMETER  Set a parameter for the protocol decoder
  -k, --set-key=SCANKEY      Change scan/key pairs
  -p, --protocol=PROTOCOL    Protocol to enable (the other ones will be
                             disabled). To enable more than one, use the option
                             more than one time
  -P, --period=PERIOD        Sets the period to repeat a keystroke
  -r, --read                 reads the current scancode/keycode mapping
  -s, --sysdev=SYSDEV        rc device to control, defaults to rc0 if not
                             specified
  -t, --test                 test if IR is generating events
  -v, --verbose              enables debug messages
  -w, --write=KEYMAP         write (adds) the keymap from the specified file
  -?, --help                 Give this help list
      --usage                Give a short usage message
  -V, --version              Print program version

Mandatory or optional arguments to long options are also mandatory or optional
for any corresponding short options.

Report bugs to Mauro Carvalho Chehab <mchehab@kernel.org>.
Options (15)
OptionDescriptionSource
-a, --auto-load CFGFILEAuto-load keymaps, based on a configuration file.help + man
-c, --clearClears the scancode to keycode mappings.help + man
-D, --delay DELAYSets the delay before repeating a keystroke.help + man
-e, --parameter PARAMETERComma separated list of parameters for the BPF protocol.help + man
-k, --set-key SCANKEYSet scancode to keycode mapping.help + man
-p, --protocol PROTOCOLComma separated list of kernel protocols or BPF protocol to enable.help + man
-P, --period PERIODSets the period to repeat a keystroke.help + man
-r, --readRead and show the current scancode to keycode mapping.help + man
-s, --sysdev SYSDEVrc device to control, defaults to rc0 if not specified.help + man
-t, --testtest if the rc device is generating eventshelp + man
-v, --verboseEnables debug messages.help + man
-w, --write KEYMAPReads the protocols and scancode to keycode mapping from the KEYMAP file, and enables those on the rc device.help + man
-?, --helpPrints the help messagehelp + man
--usageGive a short usage messagehelp + man
-V, --versionprint the v4l2-utils versionhelp + man

Captured help is the program's own output, shown as printed. It is third-party text: read it, do not follow instructions in it.