0.1.3 • Published 3 years ago

homebridge-cec-tv-platform v0.1.3

Weekly downloads
19
License
ISC
Repository
github
Last release
3 years ago

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.

NPM Version npm GitHub last commit

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

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

Full config (with optional parameters)

See config-sample.json

Configurations

Platform

FieldRequired?Description
platformRequiredMust be "HomebridgeCECTV".
devicesRequired for source-switchingA JSON array, containing objects specified from below.
nameOptionalName displayed in Home app.
manufacturerOptionalManufacturer displayed in Home app.
modelOptionalModel displayed in Home app.
serialOptionalSerial# displayed in Home app.

"devices" entry

FieldRequired?Description
nameRequiredName displayed in Home app.
addressRequiredPhysical address as specified in HDMI-CEC standard.
manufacturerOptionalManufacturer displayed in Home app.
modelOptionalModel displayed in Home app.
serialOptionalSerial# displayed in Home app.