Homebridge-philips-tv-2020

A Homebridge plugin to control your Philips TV. Made for the 43PUS7805 2020 model, but it should work for most non-Android TV version 6 API TVs.

Uses API version 6 and port 1925.

Features

• Turn your TV on and off using HomeKit
• Basic TV remote controls on your device
• Change volume of TV on your device
• Change ambilight style using a source selector in Home

Remote

To use the remote functionality, add the "Apple TV Remote" button to your control centre and open it. Your TV should be available in the list. The cursor and back buttons work as expected, but the Play-Pause button is currently configured to act as the ambilight button on your remote, and the Info button simulates the Home button.

While you are in the remote menu, you can use the volume buttons of your device to adjust the volume of your TV (or the speaker connected to it with HDMI ARC).

Installation

Installing the plugin

This plugin is not published on npm. To install it from GitHub, make sure you have git installed and run:

npm install -g git+https://github.com/larsjuhw/homebridge-philips-tv-2020.git

Adding the accessory to HomeKit

HomeKit currently only allows one bridge to add one Television accessory. Therefore,this plugin is configured as a separate accessory and you need to manually add it to HomeKit.

1. Open the Home app on your device.
2. Tap the Home tab, then tap .
3. Tap Add Accessory, and select I Don't Have a Code or Cannot Scan.
4. Enter the Homebridge PIN, this can be found under the QR code in Homebridge UI or your Homebridge logs.

Config

Required parameters

Name	Type	Description
name	string	The name of your TV in HomeKit
ip	string	The IP address of your TV
mac_address	string	The MAC Address of your TV which is used to turn on the TV with WOL
ambihue	boolean	Whether the Play/Pause button should be replace by an Ambilight + Hue toggle

Optional parameters

• ambilight_styles - List of Ambilight style objects. See Ambilight styles for more information.

Example config

{
    "platform": "HomebridgePhilipsTV",
    "name": "Philips TV",
    "ip": "192.168.2.110",
    "mac_address": "51:AC:47:4A:0A:8B",
    "ambihue": false,
    "ambilight_styles": [
        {
            "name": "Standard",
            "value": "STANDARD",
            "type": "FOLLOW_VIDEO"
        }
    ]
}

See Ambilight styles for an example array of styles.

Ambilight styles

Adding the ambilight_styles parameter to your config will allow you to change between ambilight styles using a source selector in the Home app.

Example ambilight object:

{
    "name": "Standard",
    "value": "STANDARD",
    "type": "FOLLOW_VIDEO"
}

You can find the value and type parameter of the current ambilight style with a GET request to tvip:1925/6/ambilight/currentconfiguration. The returned menuSetting is the value in the ambilight object, and the returned styleName is the type parameter. Some styles do not work when using their menuSetting in the POST request to change style, in that case you can add the optional str parameter to the ambilight object and use the stringValue of the style.

To (somewhat) find out which menuSettings your TV supports, you can GET tvip:1925/6/ambilight/supportedstyles and it will return a list of the three styleNames with their possible menuSetting values. However, this list will most likely contain many duplicates and styles that are not actually supported.

Example styles

[
    {
        "name": "Standard",
        "value": "STANDARD",
        "type": "FOLLOW_VIDEO"
    },
    {
        "name": "Natural",
        "value": "NATURAL",
        "type": "FOLLOW_VIDEO"
    },
    {
        "name": "Sports",
        "value": "SPORTS",
        "type": "FOLLOW_VIDEO"
    },
    {
        "name": "Vivid",
        "value": "VIVID",
        "type": "FOLLOW_VIDEO"
    },
    {
        "name": "Game",
        "value": "GAME",
        "type": "FOLLOW_VIDEO"
    },
    {
        "name": "Lumina",
        "value": "ENERGY_ADAPTIVE_BRIGHTNESS",
        "type": "FOLLOW_AUDIO"
    },
    {
        "name": "Retro",
        "value": "VU_METER",
        "type": "FOLLOW_AUDIO",
        "str": "Retro"
    },
    {
        "name": "Rhythm",
        "value": "RANDOM_PIXEL_FLASH",
        "type": "FOLLOW_AUDIO"
    },
    {
        "name": "Hot Lava",
        "value": "HOT_LAVA",
        "type": "FOLLOW_COLOR"
    },
    {
        "name": "Deep Water",
        "value": "DEEP_WATER",
        "type": "FOLLOW_COLOR"
    },
    {
        "name": "Fresh Nature",
        "value": "FRESH_NATURE",
        "type": "FOLLOW_COLOR"
    },
    {
        "name": "Warm White",
        "value": "ISF",
        "type": "FOLLOW_COLOR"
    }
]