From Official Kodi Wiki
Jump to navigation Jump to search
The Pulse-Eight USB to CEC adapter, for devices that don't have CEC connected to their internal HDMI pins.
Home icon grey.png   ▶ Remote controls ▶ CEC

CEC (Consumer Electronics Control) allows for control of devices over the HDMI port.

All modern televisions and AV-receivers support HDMI-CEC, which is a technology that allows devices to talk with each other over the HDMI cable. Kodi comes with libCEC (CEC abstraction and interface library from Pulse-Eight) which allows control of the Kodi input over the standard TV remote that comes with your TV. As buttons are pressed the remote command is sent via the HDMI cable to your Kodi device.

Using this feature a Kodi compatible CEC controller/adapter will send and receive remote key presses to and from your television and AV-receiver via libCEC.

CEC allows you to do things such as:

  • Controlling Kodi from the TV's remote control
  • Automatically switch to the right TV input device
  • Letting the HTPC control what mode your audio receiver is on when the TV switches on
  • Turning all devices off with one remote
  • Set volume/mute of the receiver
  • And a lot more!


Consumer Electronics Control (CEC) is an HDMI feature designed to allow the user to command and control up-to 15 CEC-enabled devices, that are connected through HDMI,[63][64] by using only one of their remote controls (for example by controlling a television set, set-top box, and DVD player using only the remote control of the TV).[65] CEC also allows for individual CEC-enabled devices to command and control each other without user intervention.

It is a one-wire bidirectional serial bus that is based on the CENELEC standard AV.link protocol to perform remote control functions. CEC wiring is mandatory, although implementation of CEC in a product is optional. It was defined in HDMI Specification 1.0 and updated in HDMI 1.2, HDMI 1.2a and HDMI 1.3a (which added timer and audio commands to the bus). USB to CEC adapters exist that allow a computer to control CEC-enabled devices.

Kodi uses libCEC (CEC library) from Pulse-Eight for send and receive CEC commands over the HDMI bus, this is because libCEC acts an abstraction layer and translate the commands to match each vendor and devices compatibility issues.

libCEC is aimed at being a reference implementation of the HDMI 1.4b Specification, however what each adopter supports is not always what they should support. Equally some mandatory features of HDMI-CEC are not implemented by some vendors.

The following is a list of the most commonly used HDMI-CEC commands:

  • One Touch Play allows devices to switch the TV to use it as the active source when playback starts
  • System Standby enables users to switch multiple devices to standby mode with the press of one button
  • Preset Transfer transfers the tuner channel setup to another TV set
  • One Touch Record allows users to record whatever is currently being shown on the HDTV screen on a selected recording device
  • Timer Programming allows users to use the EPG (Electronic Program Guides) that are built into many HDTVs and set-top-boxes to program the timer in recording devices like PVRs and DVRs
  • System Information checks all components for bus addresses and configuration
  • Deck Control allows a component to interrogate and control the operation (play, pause, rewind etc.), of a playback component (Blu-ray or HD DVD player or a Camcorder, etc.)
  • Tuner Control allows a component to control the tuner of another component
  • OSD Display uses the OSD of the TV set to display text
  • Device Menu Control allows a component to control the menu system of another component by passing through the user interface (UI) commands
  • Routing Control controls the switching of signal sources
  • Remote Control Pass Through allows remote control commands to be passed through to other devices within the system
  • Device OSD Name Transfer transfers the preferred device names to the TV set
  • System Audio Control allows the volume of an AV receiver, integrated amplifier or preamplifier to be controlled using any remote control from a suitably equipped device(s) in the system

Settings in Kodi for CEC

These instructions work for all libCEC compatible HDMI-CEC controllers and adapters, such as the Pulse-Eight USB - CEC Adapter or the HDMI-CEC controller built-into the Raspberry Pi.

Settings for your CEC devices can be found in: Kodi Input Settings

CEC uses the remote.xml keymap, editing that XML file will allow you to customize most buttons.

To identify button names, enable the debug log and look for OnKey messages. Unfortunately the key name reported is bogus and you will need to deduce it by searching for the reported action in the default remote.xml and noting the key that causes the action in the window showing when the message was logged.

Changing the CEC name

By default Kodi will present itself as Kodi to other CEC devices, this can be changed if needed by editing the config file.

The file will be located in userdata/peripheral_data and the filename will contain CEC (on a Raspberry Pi running LibreElec it's cec_CEC_Adapter.xml, On Windows 10 with a Pulse-Eight USB adapter it's usb_"deviceid"_CEC_adapter.xml).

To edit this file you will first need to stop Kodi or the changes will be overwritten when exiting Kodi.

The layout of the "CEC file" is as follows:

   <setting id="activate_source" value="1" />   
   <setting id="device_name" value="Kodi" />
   <setting id="wake_devices_advanced" value="" />

To change the name, go to the device_name row and change value from Kodi to what you want. As an example to set the device_name to idoK the line would be

   <setting id="device_name" value="idoK" />

Save the changes and start Kodi.

CEC-capable HTPCs

  • Some ARM/"Android boxes" have the ability to use CEC, but only expose some basic functions to Kodi. These functions are typically enough to use a TV remote to control that box. For example, the Amazon Fire TV has this kind of CEC functionality.
  • Other devices, such as the Raspberry Pi, have more complete CEC abilities, and are completely built-in.

Trade names

There are different trade names for HDMI CEC, depending on who is the manufacturer of your device, so it doesn't have to be stated as HDMI-CEC. Find your manufacturer on this list and see what it is called for your device:

  • AOC - E-link
  • Hitachi - HDMI-CEC
  • LG - SimpLink
  • Loewe - Digital Link or Digital Link Plus
  • Marantz - HDMI Control
  • Mitsubishi - NetCommand for HDMI
  • Onkyo - RIHD (Remote Interactive over HDMI)
  • Panasonic - VIERA Link or HDAVI Control or EZ-Sync
  • Philips - EasyLink
  • Pioneer - Kuro Link
  • Runco International - RuncoLink
  • Samsung - Anynet+
  • Sharp - Aquos Link
  • Sony - BRAVIA Link or BRAVIA Sync (You may need to use a port labeled HDMI-MHL if the regular HDMI port does not work.)
  • Toshiba - Regza Link or CE-Link

Kodi Devices

Most HDMI ports on computers (onboard or via GPU) do not have integrated support for the CEC feature, but instead can use a external CEC adapter, such as the ones from Pulse-Eight, and some more recent Intel motherboards come with a integrated HTPC header to allow you to connect an internal CEC-adapter.

Pulse-Eight USB CEC Adapter

Pulse-Eight makes two different formats of HDMI-CEC USB-adapters, one for external and one internal. The work the same, with both permitting a connected device to send and receive HDMI-CEC control commands on the HDMI bus. The Pulse-Eight CEC adapters can be installed for use with Kodi. Your television remote can then be used to control Kodi, and Kodi can control all compatible connected devices.

Intel NUC

Intel Graphics doesn't support CEC commands (http://www.intel.com/support/graphics/sb/CS-034397.htm under "What are the differences between different HDMI versions?") and a Pulse-Eight adapter is required. Both the external USB adapter and the internal adapter (http://www.intel.com/support/motherboards/desktop/sb/CS-034631.htm) works.

Raspberry Pi

The Raspberry Pi GPU has CEC support which is supported by libCEC, and is therefore fully supported by Kodi.

Common Issues with CEC

When "setting up" CEC make sure your configuration uses good HDMI cables. Especially cheap cables - still able to support 1080p without any problems - have been reported to cause problems with CEC (eg. devices like raspberry not showing up in the CEC menu at all, devices showing up but remote not working, etc).

Using better HDMI cables might resolve that problem.

There are also reports of devices with improper HDMI CEC implementation, such as ROKU streaming box, causing problems with CEC device recognition. Disconnecting non-CEC devices, or upgrading firmware on those devices, may resolve the problem.

Further reading

Some Videos to demonstrate how it works

Simple but easy to understand:

More technical: