README

homebridge-cec-tv-platform

TV CEC client plugin for homebridge: https://github.com/nfarina/homebridge

The plugin is based on homebridge-cec from Dominick Han (dominick-han) but uses platform toolkit.

Homebridge plugin to control a TV via CEC protocol (power on/off, volume +/-, source selection)

Prerequisite

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

Installation

Install homebridge
Install this plugin using: sudo npm install -g homebridge-cec-tv-platform
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
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": "HomebridgeCECTV",
        "accessories": [
            {
                "name": "TOSHIBA",
                "devices": [
                    {
                        "1": "Sat Receiver",
                        "2": "Apple TV"
                    }
                ]
            }
        ]
    }
]

Full config (with optional parameters)

See config-sample.json

Configurations

Platform

Field	Required?	Description
platform	Required	Must be "HomebridgeCECTV".
devices	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.

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

Usage no npm install needed!