Skip to content

Samfox2/homebridge-cec-tv-platform

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

42 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

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

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.

Releases

No releases published

Packages

No packages published