LG webOS TV Control Driver v1.05

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 3000 (insecure ws://). Use 3001 for secure wss:// on newer TVs.

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.

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.