How to configure IR remote control

IR remote controls can be configured in 1 of 2 ways in CoreELEC, both are detailed in this guide below.

meson-ir allows you to use almost any IR remote controller to control your device.

CoreELEC uses meson-ir by default and our builds come with a limited selection of IR remote configurations for devices built in.

If your remote does not work then you will need to follow the below instructions to create a config and get it working.

Firstly you must SSH into your device and then Kodi and eventlircd services must be stopped.

systemctl stop kodi
systemctl stop eventlircd

Next you need to run ir-keytable to scan for remote codes.

ir-keytable -p NEC,RC-5,RC-6,JVC,SONY -t

Start to press all of the buttons on your remote and make a note of each scan code in notepad on your computer.

Now you need to create your configuration, an example can be seen here. Don’t delete 1st line, only name and protocol could be modified in it. A list of functions can be found here.

When you have created your map file it needs to be saved in the following location.


You must also create the following file /storage/.config/rc_maps.cfg with the following contents.

meson-ir * YOURMAPNAME

Now you must load your config and start Kodi and eventlircd back up to test your changes.

ir-keytable -a /storage/.config/rc_maps.cfg -s rc0
systemctl start eventlircd
systemctl start kodi

If your config works and you are happy with it then you are not required to do anything further and it will be loaded automatically when rebooting/powering on your device.

Pre-made remote control configurations can be found here.

Many of you will be most familiar with this method, amremote typically gives a much better user experience with the bundled remotes with generic devices.

To use an amremote configuration simply copy your remote.conf file to either the root folder of your SD card / USB flash drive or to /storage/.config/remote.conf.

NOTE: after the first time you boot your device with an amremote configuration it will automatically reboot whilst modifications are made to your dtb to enable amremote.

You can change back to meson-ir at any time by simply removing the remote.conf file and rebooting.

Help with the remote.conf
Whats the scheme for remotes on 8.90.2
Update to 8.90.2 Tanix TX3 Mini
OTT TV-BOX T95M -> Which DTB for VFD Use / Remote Control
Tvheadend htsp client no signal message
CoreELEC 9.0.x Remote files
What remote is enabled by default in rc_maps.cfg
Change remote keymap
8.90.5 - Mini M8S II - remote controller doesn't work
A95X -R1 / S905W issue
Remote control X96 mini
Is the MCE usb receiver supported?
Problem delay remote controller KIpro s905x
Power on/off with minix neo a2 remote with odroid N2
Nightly builds
Help to power on with Odroid-N2
T95x2 remote config trouble (s905x2)
Support added for S905X2, S922X and A311D!
Denon and Panasonic Non-supported remotes
Minix Neo U1 device tree - remote control
Notice on updating from LibreELEC builds
CoreELEC 8.95.0 release
(S912) H96 Pro+ Black Board - Trouble Remote Power ON
Minix U1 supplied remote stopped working in 8.95.5
IR controller doesn't work after configuration
Sunvell T95X: Stuck at Setup Wizard
Wetek Pro remote
CoreElec freezes on welcome screen
Nexbox A95X (1gb) power-on from IR remote?
CoreELEC 8.99.2
CoreElec freezes on welcome screen
TX5 PRO remote configuration differences between Coreelec releases
Trivial Button Issue Mapping
(solved) After update to 8.95.6 Media Center Extention (Logitech Harmony) don't work
Updating M8S PRO+ S905X or not - beginner questions
CoreELEC 9.0.x Remote files
Support added for S905X2, S922X and A311D!
How to execute a linux command by pressing a remote key?
Ir_keytable only working for button working
How to manipulate remote files?
CEC stop working correctly After .3 update
CoreELEC 9.0.0
Remote controller not working with crazycat drivers
Android box h96 pro plus does not work on the remote control
Sunvell T95X: Stuck at Setup Wizard
Xbox Media Remote
Device tree gxbb_p200_2G_1Gbit failure on Leia Final