/homebridge-tv-cec

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

Primary LanguageJavaScriptGNU General Public License v3.0GPL-3.0

homebridge-hdmi-cec

Demo Screenshot

NPM Version
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.