LG webOS TV Control Driver v1.14

Smart Home Programming

Overview

This driver provides full IP control of LG webOS Smart TVs (2014 and newer) using the SSAP (Second Screen Application Protocol) over WebSocket. Features include power, volume, input selection, app launching, media control, navigation, channel control, channel filtering, and text input.

Requirements

LG Smart TV with webOS (2014 or newer)

TV and RTI processor on the same network

TV IP address (static IP recommended)

TV MAC address (for Wake-on-LAN power on)

Setup

Step 1: Network Configuration

Configure a static IP on your LG TV: Settings > Network > Wired/Wi-Fi Connection > Edit > Set manually.

Step 2: Driver Settings

TV IP Address: Enter the static IP of your LG TV

WebSocket Port: Default 3001 (secure wss://) is recommended for webOS 4.x and newer. Only use 3000 (insecure ws://) for older 2014-2017 webOS TVs where the secure port is not supported.

MAC Address: Enter the TV's MAC address for Wake-on-LAN power on (format: XX:XX:XX:XX:XX:XX). Find this in TV Settings > Network > Wired/Wi-Fi Connection.

Step 3: Pairing

On first connection, the TV will display a pairing prompt asking you to accept the connection from "LG Remote App". Press Accept on the TV remote or via the TV's on-screen buttons. The driver stores the pairing key automatically —ou only need to pair once.

To re-pair: Use the "Pair" function or the debug console "pair" command. This clears the stored key and triggers a new pairing prompt.

Wake-on-LAN (Power On)

The TV must be in standby (not fully powered off) for WOL to work. Ensure:

TV Settings > General > Mobile TV On = Enabled

TV Settings > General > Quick Start+ = Enabled (if available)

MAC address is correctly entered in driver settings

After sending WOL, the driver will automatically retry connecting for up to 60 seconds while the TV boots.

Auto-Reconnect Watchdog

The driver includes a background watchdog that checks every 30 seconds if the TV is available. If the TV is turned on using its physical remote (not WOL), the driver will automatically detect this and reconnect. No manual intervention is required.

Manage Channels (Filter)

The browse menu includes a "Manage Channels" option inside the Channels list. This allows you to show or hide individual channels so only the channels you want appear in the main channel list.

Show All / Hide All: Bulk toggle all channels visible or hidden

Individual Toggle: Tap any channel to toggle between [ON] (visible) and [OFF] (hidden)

Channel filter settings are saved and persist across reboots

The main Channels list only shows visible channels with a count of hidden channels in the title

Channel & Input Behaviour

When the TV is on an HDMI input or another app (not Live TV), the channel name and number variables are automatically cleared. When the TV is powered off, all channel and app info is cleared.

Channel Icons

The driver displays network logos for Australian FTA channels in the browse menu, including ABC, SBS, Seven, Nine, Ten, and their sub-channels. Radio channels (Triple J, Double J, Triple J Unearthed) and other FTA channels (TVSN, Extra, Nickelodeon, etc.) are also supported.

App IDs

Common app IDs for the LaunchApp function:

netflix

youtube.leanback.v4

amazon

com.disney.disneyplus-prod

cdp-30 (Plex)

spotify-beehive

Use the debug console "apps" command or browse menu to see all available apps on your TV.

Known Limitations on Older webOS TVs (2014-2015)

On the earliest webOS TVs (typically UF series 2015 and earlier, webOS 1.x firmware) the TV does not action Magic Remote pointer-socket button events. The following functions will not have a visible effect on these older TVs:

Navigation buttons (Up / Down / Left / Right / OK / Back / Home / Menu)

Number keys 0-9 (direct keypad input)

Media transport (Play / Pause / Stop / Rewind / Fast Forward)

Info / Guide buttons

This is a TV firmware limitation, not a driver issue. The same socket protocol is documented as broken on these models by multiple open-source projects (openHAB LGWebOS binding, bscpylgtv, lgtv2). webOS 4.x and newer TVs (2018+) handle these events normally.

On these older TVs, the following SSAP-based functions continue to work fully:

Power on (Wake-on-LAN) and Power off

Volume Up / Down / Set, Mute

Input switching (HDMI 1-4, Component, AV)

Channel Up / Down and Channel Set (by channel ID via the browse menu)

App launch (Netflix, YouTube etc. by App ID)

Toast notifications

Browse menu for channels, inputs and apps

Live status feedback (volume, current app, current channel)

For older TVs, configure your RTI template to use these supported functions and the browse menu for selection, rather than direct keypad / nav buttons.

Troubleshooting Connection

If the driver cannot connect or the pairing prompt does not appear on the TV, work through these steps in order:

Use the correct port for your TV's webOS version. Newer webOS firmware (5.x and later, generally 2020+ models) blocks the insecure port 3000 and only accepts the secure port 3001. If you set the port to 3000 and the driver fails to connect, change WebSocket Port to 3001 and reconnect.

If using port 3001 and the connection still fails, the TV may not support the secure port - switch to port 3000 (older 2014-2017 webOS TVs).

Check the TV's network settings. Ensure the following are enabled: Settings > Connection > Mobile TV On (or Mobile Connection Management > TV On with Mobile), and Settings > Network > LG Connect Apps (if shown on your firmware), and Network IP Control.

Power cycle the TV at the wall after changing any of these settings or after a webOS firmware update - some settings only take effect on a cold boot.

Verify the IP address and MAC. Check both match the values shown in the TV's network settings.

Debug Console

Connect via telnet to the processor IP on port 12507 (configurable). Type "help" for a list of all available commands. This is useful for testing commands, viewing TV state, and troubleshooting.

Licensing

Licence keys can be purchased from the Smart Home Programming Driver Store:

Store: https://shpdrivers.services/store/

Email: david@smarthomeprogramming.com.au

A 120-minute trial is included for testing before purchase.

Support & Feature Requests

For bug reports, technical support, or new feature requests, please use the ticket system available in your account after logging in at the Driver Store.

Support Tickets: Log in at https://shpdrivers.services/store/ and submit a ticket from your account

Email: david@smarthomeprogramming.com.au

Terms of Service

All drivers are provided "as is" without warranty of any kind. You use this software entirely at your own risk. A free trial is included so you can verify compatibility with your system before purchasing. Do not purchase a licence if you have not tested the driver on your hardware. For full terms including warranty disclaimer, limitation of liability, and refund policy, visit:

https://smarthomeprogramming.com.au/store/terms.html

Copyright 2026 Smart Home Programming. All rights reserved.