homebridge-hdmi-cec

Homebridge support for TV power on/off, source selection, using HDMI-CEC

Prerequisite

CEC-Enabled device. Raspberry Pi (tested working) or Pulse-Eight's USB - CEC Adapter

Installation

1. Install homebridge
2. Install this plugin using: sudo npm install -g homebridge-hdmi-cec
3. Install cec-utils if cec-client command is not present: sudo apt-get install cec-utils
   Note: On Raspberry Pi's OSMC image, cec-cilent is present at /usr/osmc/bin/cec-client-4.0.2, need to run sudo ln -s /usr/osmc/bin/cec-client-4.0.2 /usr/bin/cec-client to link it to default $PATH
4. Add CEC platform to your configuration file (See below for examples)
   Note: You might have to disable Kodi's (if installed) build in CEC functionality as it will interfere with this plugin

Minimal config

  "platforms":[
    {
      "platform": "CEC",
      "sources": [
        {
          "name": "Raspberry Pi",
          "address": "2.0.0.0"
        },
        {
          "name": "Apple TV",
          "address": "3.0.0.0"
        }
      ]
    }

Full config (with optional parameters)

See config-sample.json

Configurations

Platform

Field	Required?	Description
platform	Required	Must be "CEC" (all UPPERCASE).
sources	Required for source-switching	A JSON array, containing objects specified from below.
name	Optional	Name displayed in Home app.
manufacturer	Optional	Manufacturer displayed in Home app.
model	Optional	Model displayed in Home app.
serial	Optional	Serial# displayed in Home app.
tv_service	Optional	Uses TV service available in iOS >12.2.

"sources" entry

Field	Required?	Description
name	Required	Name displayed in Home app.
address	Required	Physical address as specified in HDMI-CEC standard.
manufacturer	Optional	Manufacturer displayed in Home app.
model	Optional	Model displayed in Home app.
serial	Optional	Serial# displayed in Home app.