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.

"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.