pimatic-lg-smart-tv

A pimatic plugin to control WebOS based LG Smart TV's. This plugin was developed against a LG OLED55B8PLA. Similar models should work equally well. I do recommend connecting a Smart TV through cabled LAN for stability reasons - Which you already did for Netflix quality reasons anyway ;)

Status of Implementation

Since the first release the following features have been implemented:

• Autodiscovery of LG WebOS capable televisions
• Button devices for TV Channels, TV Inputs, and installed WebOS Apps, allowing to switch apps, inputs and channels rule-based
• Rule Action to show Toast messages on the television
• Turning TV on and off (Turning the TV on is accomplished through Wake-On-LAN)

Roadmap:

• Implement volume control (Not done initially since I use my AV Receiver for TV volume).

Contributions / Credits

Originally this project was inspired by pimatic-lgtv (Vincent Riemer). However, the code base has deviated significantly since then.

Configuration

• Add the plugin to your config.json, or via the GUI (Do not forget to activate)
• Create a device config, or run device autodiscovery (Recommended)

Plugin Configuration

{
  "plugin": "lg-smart-tv",
  "debug": false,
  "smartTVs": [
    {
      "id": "192.168.0.101",
      "mac": "a8:23:fe:66:dd:11"
    },
    {
      .......
    }
  ],
  "active": true
}

The plugin has the following configuration properties:

Property	Default	Type	Description
debug	false	Boolean	Debug messages to pimatic log, if set to true

Device Configuration

Default settings through autodiscovery should work fine.

LgSmartTvDevice

{
  "class": "LgSmartTvDevice",
  "name": "TV Livingroom",
  "id": "tv-livingroom",
  "tvIp": "192.168.0.101",
  "tvMac": "a8:23:fe:66:dd:11",
  "key": "401d6a314a8992695c0139c042084e4a"
}

The device has the following configuration properties:

Property	Default	Type	Description
tvIP	''	String	IPv4 address of TV (Populated by auto discovery
tvMAC	''	String	MAC address of TV (Populated by auto discovery
key	''	String	Unique key identifying Pimatic with the TV

LgSmartTvAppsDevice / LgSmartTvInputsDevice

{
  "class": "LgSmartTvAppsDevice",
  "name": "TV Apps",
  "id": "lg-smart-tv-applications",
  "tvIp": "192.168.0.101",
  "buttons": [
    {
      "id": "netflix",
      "text": "Netflix"
    },
    {
	  .....
    }
  ]
}

Property	Default	Type	Description
buttons	''	Array	Array of Applications installed on TV
id	''	String	Internal WebOS app id
text	''	String	Friendly App name for Pimatic GUI

In WebOS Apps and Inputs are treated similarly, therefore you can opt to include your inputs in your Apps device! In case you want to have a separate buttons device for inputs, the syntax is equal, where the id refers to the input in that case. *E.g. "id": "com.webos.app.hdmi2", "name": "Input HDMI 2"

LgSmartTvChannelsDevice

{
  "class": "LgSmartTvChannelsDevice",
  "name": "TV Channels",
  "id": "lg-smart-tv-channels",
  "tvIp": "192.168.0.101",
  "buttons": [
    {
      "id": "npo-1-hd",
      "text": "NPO 1 HD",
      "webosId": "3_36_1_501_114_14010_2249"
    },
    {
      ......
    }
  ]
}

Buttons Property	Default	Type	Description
id	''	String	Pimatic button ID
webosId	''	String	Internal WebOS channel id
text	''	String	Friendly Channel name for Pimatic GUI

Predicates and Actions

The following predicates are supported:

• {device} is turned on|off

The following actions are supported:

• switch {device} on|off
• show message "Look at the TV!" on TV Living Room
• press Discovery Channel HD (Discovery Channel HD being the friendly name for the TV Channel)
• Press Mediaplayer (Mediaplayer being the Pimatic friendly name for the corresponding TV Input)

License

Copyright (c) 2021, Danny Wigmans and contributors. All rights reserved.

GPL-3.0