Homebridge LG webOS TV

Homebridge plugin for LG webOS. Tested with OLED65G6V, 32LM6300PLA, 49SK8500, OLED65C7T, 55SK800PLB, OLED48CX, OLED48C2, OLED48C3.

Package Requirements

| Package | Installation | Role | Required | | --- | --- | --- | --- | | Homebridge | Homebridge Wiki | HomeKit Bridge | Required | | Homebridge UI <= v5.5.0 | Homebridge UI Wiki | Homebridge User Interface | Recommended | | LG webOS TV | Plug-In Wiki | Homebridge Plug-In | Required |

Abut The Plugin

• Support SSL Web Socket for newer TV, plugin config Advanced Settings >> Device >> SSL WebSocket
• Power and Screen ON/OFF short press tile in HomeKit app.
• RC/Media control is possible after you go to the RC app on iPhone/iPad.
• Speaker control is possible after you go to RC app on iPhone/iPad Speaker Service.
• Legacy Volume and Mute control is possible throught extra lightbulb/fan (slider).
• Inputs can be changed using Inputs selector in HomeKit.app, additionally can create separate tile.
• Channels can be changed using Channels selector in HomeKit app, additionally can create separate tile.
• Brightness, Contrast, Backlight, Color, Picture Mode, Sound Mode and Sound Output can be changed using extra tile.
• Siri can be used for all functions, some times need create legacy buttons/switches/sensors.
• Automations can be used for all functions, some times need create legacy buttons/switches/sensors.
• Support external integrations, RESTFul, MQTT.

Configuration

• Please configure LG Connect Apps
• Run this plugin as a Child Bridge (Highly Recommended), this prevent crash Homebridge if plugin crashes.
• Install and use Homebridge UI <= v5.5.0 to configure this plugin.
• The sample-config.json can be edited and used as an alternative.

| Key | Description | | --- | --- | | name | Here set the accessory Name to be displayed in Homebridge/HomeKit. | | host | Here set the Hsostname or Address IP of TV. | | mac | Here set the Mac Address of TV. | | displayType | Accessory type to be displayed in Home app: 0 - None/Disabled, 1 - Television , 2 - TV Set Top Box, 3 - TV Streaming Stick, 4 - Audio Receiver. | | inputs{} | Inputs object. | | inputs.getFromDevice | This enable load inputs and apps direct from device. | | inputs.filterSystemApps | This enable filter sysem apps, only if getFromDevice is true. | | inputs.displayOrder | Here select display order of the inputs list, 0 - None, 1 - Ascending by Name, 2 - Descending by Name, 3 - Ascending by Reference, 4 - Ascending by Reference. | | inputs.data[].name | Here set Name which You want expose to the Homebridge/HomeKit. | | inputs.data[].reference | Here set Reference. Live TV, HDMI 1, HDMI 2 are created by default. | | inputs.data[].mode | Here select input mode, 0 - Input/App, 1 - Live TV Channel. | | buttons[] | Buttons array. | | buttons[].displayType | Here select display type in HomeKit app, possible 0 - None/Disabled, 1 - Outlet, 2 - Switch.| | buttons[].name | Here set Name which You want expose to the Homebridge/HomeKit. | | buttons[].mode | Here select button mode, 0 - Input/App, 1 - Live TV Channel, 2 - Remote Control. | | buttons[].reference | Here set Reference, only for Input/App or Live TV Channel mode, in other case leave empty. | | buttons[].command | Here select Remote Control command which will be assigned to the button. | | buttons[].namePrefix | Here enable/disable the accessory name as a prefix for button name.| | sensors{} | Sensors object. | | sensors.power| If enabled, then the Power will be exposed as a Contact Sensor, fired if Power ON. | | sensors.pixelRefresh| If enabled, then the PoPixel Refresh will be exposed as a Contact Sensor, fired if Pixel Refresh ON. | | sensors.volume| If enabled, then the Volume will be exposed as a Contact Sensor, fired on every Volume change. | | sensors.mute| If enabled, then the Mute will be exposed as a Contact Sensor, fired if Mmute ON. | | sensors.input| If enabled, then the Input will be exposed as a Contact Sensor, fired on every Input change. | | sensora.channel| If enabled, then the Channel will be exposed as a Contact Sensor, fired on every Channel change. | | sensors.soundMode| If enabled, then the Sound Mode will be exposed as a Contact Sensor, fired on every Sound Mode change, webOS >= 6.0. | | sensors.soundOutput| If enabled, then the Sound Output will be exposed as a Contact Sensor, ffired on every Sound Output change. | | sensors.pictureMode| If enabled, then the Picture Mode will be exposed as a Contact Sensor, fired on every Picture Mode change, webOS >= 4.0. | | sensors.screenOnOff| If enabled, then the Screen On/Off will be exposed as a Contact Sensor, fired on Screen OFF, webOS >= 4.0. | | sensors.screenSaver| If enabled, then the Screen Saver will be exposed as a Contact Sensor, fired on Screen Saver ON, webOS >= 4.0. | | sensors.playState| If enabled, then the Play State will be exposed as a Contact Sensor, fired on Playing, webOS >= 7.0. | | sensors.inputs[]| Sensor inputs array. | | sensors.inputs[].displayType | Here select sensor type to be exposed in HomeKit app, possible 0 - None/Disabled, 1 - Motion Sensor, 2 - Occupancy Sensor, 3 - Contact Sensor. | | sensors.inputs[].name | Here set own Name which You want expose to the Homebridge/HomeKit for this sensor. | | sensors.inputs[].reference | Here set Reference like com.webos.app.hdmi1 to be exposed as sensor (active on switch to this Input). | | sensors.inputs[].namePrefix | Here enable/disable the accessory name as a prefix for sensor name.| | picture{} | Picture object. | | picture.brightnessControl | This enable possibility adjust the Brightness. | | picture.backlightControl | This enable possibility adjust the Backlight. | | picture.contrastControl | This enable possibility adjust the Contrast. | | picture.colorControl | This enable possibility adjust the Color. | | picture.modes[]| Picture modes array, webOS >= 4.0. | | picture.modes[].displayType | Here select display type in HomeKit app, possible 0 - None/Disabled, 1 - Outlet, 2 - Switch.| | picture.modes[].name | Here set own Name which You want expose to the Homebridge/HomeKit for this sensor. | | picture.modes[].reference | Here select mode to be exposed in Homebridge/HomeKit. | | picture.modes[].namePrefix | Here enable/disable the accessory name as a prefix for picture mode.| | sound{} | Sound object. | | sound.modes{} | Sound mode object. | | sound.modes.data[]| Sound modes array, webOS >= 6.0. | | sound.modes.data[].displayType | Here select display type in HomeKit app, possible 0 - None/Disabled, 1 - Outlet, 2 - Switch.| | sound.modes.data[].name | Here set own Name which You want expose to the Homebridge/HomeKit for this sensor. | | sound.modes.data[].reference | Here select mode to be exposed in Homebridge/HomeKit. | | sound.modes.data[].namePrefix | Here enable/disable the accessory name as a prefix for sound mode.| | sound.outputs{} | Sound output object. | | sound.outputs.data[]| Sound outputs array. | | sound.outputs.data[].displayType | Here select display type in HomeKit app, possible 0 - None/Disabled, 1 - Outlet, 2 - Switch.| | sound.outputs.data[].name | Here set own Name which You want expose to the Homebridge/HomeKit for this sensor. | | sound.outputs.data[].reference | Here select output to be exposed in Homebridge/HomeKit. | | sound.outputs.data[].namePrefix | Here enable/disable the accessory name as a prefix for sound output.| | screen{} | Screen object. | | screen.turnOnOff | This enable possibility turn the screen ON/OFF, webOS >= 4.0. | | screen.saverOnOff | This enable possibility turn the screen saver ON/OFF, webOS >= 4.0. | | power{} | Power object. | | power.broadcastAddress | Her set network Broadcast Address, only if You use VLANS in Your network configuration and Your router/switch support IP Directed Broadcast, default is 255.255.255.255. | | power.startInput | This enable possibilty to set default Input/App after Power ON TV. | | power.startInputReference | Here set the default Input/App reference. | | volume{} | Volume object. | | volume.displayType | Here choice what a additional volume control mode You want to use 0 - None/Disabled, 1 - Lightbulb, 2 - Fan, 3 - TV Speaker, 4 - TV Speaker / Lightbulb, 5 - TV Speaker / Fan. | | volume.name | Here set Your own volume control name or leave empty. | | volume.namePrefix | Here enable/disable the accessory name as a prefix for volume control name. | | sslWebSocket | If enabled, SSL WebSocket will support TV with new firmware. | | disableTvService | This disable TV service and prevent display double services if TV already support HomeKit native. | | infoButtonCommand | Here select the function of I button in RC app. | | log{} | Log object. | | log.deviceInfo | If enabled, log device info will be displayed by every connections device to the network. | | log.success | If enabled, success log will be displayed in console. | | log.info | If enabled, info log will be displayed in console. | | log.warn | If enabled, warn log will be displayed in console. | | log.error | If enabled, error log will be displayed in console. | | log.debug | If enabled, debug log will be displayed in console. | | restFul{} | RESTFul object. | | restFul.enable | If enabled, RESTful server will start automatically and respond to any path request. | | restFul.port | Here set the listening Port for RESTful server. | | mqtt{} | MQTT object. | | mqtt.enable | If enabled, MQTT Broker will start automatically and publish all awailable PV data. | | mqtt.host | Here set the IP Address or Hostname for MQTT Broker. | | mqtt.port | Here set the Port for MQTT Broker, default 1883. | | mqtt.clientId | Here optional set the Client Id of MQTT Broker. | | mqtt.prefix | Here set the Prefix for Topic or leave empty. | | mqtt.auth{} | MQTT authorization object. | | mqtt.auth.enable | Here enable authorization for MQTT Broker. | | mqtt.auth.user | Here set the MQTT Broker user. | | mqtt.auth.passwd | Here set the MQTT Broker password. | | reference | All can be found in homebridge_directory/lgwebosTv, inputs_xxx file, where reference == id, or channels_xxx file, where reference == channelId. |

RESTFul Integration

• POST data as a JSON Object {Power: true}, content type must be application/json
• Path status response all available paths.
• References:
  • Picture Mode - cinema, eco, expert1, expert2, game, normal, photo, sports, technicolor, vivid, hdrEffect, hdrFilmMaker, hdrCinema, hdrCinemaBright, hdrStandard, hdrEffect, hdrGame, hdrVivid, hdrTechnicolor, hdrExternal, dolbyHdrCinema, dolbyHdrCinemaBright, dolbyHdrDarkAmazon, dolbyHdrStandard, dolbyHdrGame, dolbyHdrVivid.
  • Sound Mode - aiSoundPlus, standard, movie, clearVoice, news, sport, music, game.
  • Sound Output - tv_speaker, external_speaker, external_optical, external_arc, lineout, headphone, tv_external_speaker, tv_external_headphone, bt_soundbar, soundbar.

| Method | URL | Path | Response | Type | | --- | --- | --- | --- | --- | | GET | http//ip:port | systeminfo, softwareinfo, channels, apps, power, audio, currentapp, currentchannel, picturesettings, soundmode, soundoutput, externalinputlist, mediainfo. | {"state": Active} | JSON object. |

| Method | URL | Key | Value | Type | Description | | --- | --- | --- | --- | --- | --- | | POST | http//ip:port | Power | true, false | boolean | Power state. | | | http//ip:port | Input | input reference | string | Set input. | | | http//ip:port | Channel | channel reference | string | Set channel. | | | http//ip:port | Volume | 100 | integer | Set volume. | | | http//ip:port | Mute | true, false | boolean | Set mute. | | | http//ip:port | Brightness | 100 | integer | Set brightness. | | | http//ip:port | Backlight | 100 | integer | Set backlight. | | | http//ip:port | Contrast | 100 | integer | Set contrast. | | | http//ip:port | Color | 100 | integer | Set color. | | | http//ip:port | PictureMode | picture mode reference | string | Set picture mode. | | | http//ip:port | SoundMode | sound mode reference | string | Set sound mode. | | | http//ip:port | SoundOutput | sound output reference | string | Set sound output. | | | http//ip:port | PlayState | play, pause | string | Set media play state. | | | http//ip:port | RcControl | REWIND | string | Send RC command. |

MQTT Integration

• Subscribe data as a JSON Object {Power: true}
• References:
  • Picture Mode - cinema, eco, expert1, expert2, game, normal, photo, sports, technicolor, vivid, hdrEffect, hdrFilmMaker, hdrCinema, hdrCinemaBright, hdrStandard, hdrEffect, hdrGame, hdrVivid, hdrTechnicolor, hdrExternal, dolbyHdrCinema, dolbyHdrCinemaBright, dolbyHdrDarkAmazon, dolbyHdrStandard, dolbyHdrGame, dolbyHdrVivid.
  • Sound Mode - aiSoundPlus, standard, movie, clearVoice, news, sport, music, game.
  • Sound Output - tv_speaker, external_speaker, external_optical, external_arc, lineout, headphone, tv_external_speaker, tv_external_headphone, bt_soundbar, soundbar.

| Method | Topic | Message | Type | | --- | --- | --- | --- | | Publish | System Info, Software Info, Channels, Apps, Power, Audio, Current App, Current Channel, Picture Settings, Sound Mode, Sound Output, External Input List, Media Info | {"state": Active} | JSON object. |

| Method | Topic | Key | Value | Type | Description | | --- | --- | --- | --- | --- | --- | | Subscribe | Set | Power | true, false | boolean | Power state. | | | Set | Input | input reference | string | Set input. | | | Set | Channel | channel reference | string | Set channel. | | | Set | Volume | 100 | integer | Set volume. | | | Set | Mute | true, false | boolean | Set mute. | | | Set | Brightness | 100 | integer | Set brightness. | | | Set | Backlight | 100 | integer | Set backlight. | | | Set | Contrast | 100 | integer | Set contrast. | | | Set | Color | 100 | integer | Set color. | | | Set | PictureMode | picture mode reference | string | Set picture mode. | | | Set | SoundMode | sound mode reference | string | Set sound mode. | | | Set | SoundOutput | sound output reference | string | Set sound output. | | | Set | PlayState | play, pause | string | Set media play state. | | | Set | RcControl | REWIND | string | Send RC command. |