fashioncj / homebridge-bravia-tvos

Homebridge plugin for Sony Bravia Android TVs

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

Bravia!TVOS 3.0

npm npm GitHub last commit Donate

Creating and maintaining Homebridge plugins consume a lot of time and effort, if you would like to share your appreciation, feel free to "Star" or donate.

HomeKit Overview

This is a plugin for Homebridge to control your Sony Bravia Android TV.

This plugin supports following functions:

  • Power Switch (on/off)
  • Inputs like HDMI, Scart, CEC Devices, AV, WIFI, DVB:T, DVB:C etc.
  • Apps like YouTube, Prime Video etc.
  • Channels: Your favourite channels as inputs.
  • Remote control: native iOS Remote control
  • Login with PSK or without PSK (for older models)
  • WOL support Wake on Lan

Installation instructions

After Homebridge has been installed:

  • sudo npm i -g homebridge-bravia-tvos@latest

Preparing the TV (PSK)

  • Set Remote start to ON (Settings -> Network -> Remote Start)
  • Change Authentication to Normal and Pre-Shared Key (Settings -> Network -> IP Control -> Authentication)
  • Enter a Pre-Shared Key (Settings -> Network -> IP control -> Pre-Shared Key)

Preparing the TV (without PSK)

  • Set Remote start to ON (Settings -> Network -> Remote Start)
  • Change Authentication to Normal (Settings -> Network -> IP Control -> Authentication)

Basic configuration

{
"bridge": {
  ...
},
"accessories": [
  ...
],
"platforms": [
   {
     "platform": "BraviaOSPlatform",
     "tvs": [
       {
         "name": "Sony Lounge",
         "ip": "192.168.178.3",
         "port": 80,
         "psk": "lipsum555"
       }
     ],
     "interval": 10
   }
]
}

See Example Config for more details.

Options

Attributes Required Usage
name Yes Unique Name for the TV Accessory.
ip Yes IP adress from your Sony Bravia Android TV
mac No MAC address from TV (required if using WOL!)
port No If you have problems with connecting to the TV, try a different port (Default: 80)
psk No Your PRE SHARED KEY (see preparing the TV above)
extraInputs No Inputs for "Scart, Composite, Wifidisplay" (Default: false)
cecInputs No Inputs for connected cec devices like Apple TV (Default: false)
channelInputs No An Array of Channel input types (DVBT/DVBC/DVBS/ANALOG) (Default: false)
channels No List of your favourite channels (channel numbers from tv and source) to display these as inputs in the TV accessory (Default: false)
apps No List of your favourite apps to display as inputs in the TV accessory (Default: false)
wol No Wake On Lan (Default: false)
customSpeaker No If true, an extra speaker accessory will be published to HomeKit (Default: false)
speakerType No Type of the custom speaker (switch, lightbulb, speaker) (Default: speaker)
interval No Polling interval in seconds (Default: 10s)

Multiple TVs

If you have added multiple TVs to homebridge via this plugin, please note that all TVs except the first one will be published as "external accessories" ! That means, you need to add this TVs manually to HomeKit. It will be not exposed via the bridge. This is necessary due to handling of the TVs via Apple

Supported clients

This plugin has been verified to work with the following apps on iOS 12.2:

  • iOS 12.2
  • Apple Home (partial)
  • Homebridge v0.4.46

(All 3rd party apps like Elgato Eve etc are not supported at this time. Apple is blocking 3th party apps from accessing the TV accessory)

Contributing

You can contribute to this homebridge plugin in following ways:

  • Report issues and help verify fixes as they are checked in.
  • Review the source code changes.
  • Contribute bug fixes.
  • Contribute changes to extend the capabilities

Pull requests are accepted.

Troubleshooting

If you have any issues with the plugin or TV services then you can run homebridge in debug mode, which will provide some additional information. This might be useful for debugging issues.

HomeBridge with debug mode: DEBUG=BraviaPlatform,BraviaPlatformApi and homebridge -D

About

Homebridge plugin for Sony Bravia Android TVs

License:MIT License


Languages

Language:JavaScript 100.0%