LG WebOS TV (bscpylgtv) for Home Assistant (Marketplace integration)

On Home Assistant 2026.10 or older? Open it in HACS

Installs: 56 sharing analytics
GitHub stars: 15
Connection: Works locally
Upkeep: Updated in the last 6 months
Version: v2.0.10, November 7, 2026
Category: Media and entertainment, TV and streaming
Kind: Marketplace integration
Brand: LG
Needs: Needs the Marketplace (HACS on 2026.10 and older)
Domain: bscpylgtv
Source: github.com/belikh/ha-lg-webos-tv
Issues: Report an issue

Shows in Vulpo Quick Toggle card, Media Player card, Button card, Select card, Apple Watch, Control Center.

Independent directory, made by the developer of Vulpo. Not affiliated with Home Assistant or the Open Home Foundation.

About

LG WebOS TV (bscpylgtv) is a custom integration that controls LG TVs running webOS over a local connection. It keeps a persistent websocket connection to the TV and receives state updates as they happen instead of polling. Beyond the media player it adds a remote with pointer and text input, picture sliders such as backlight, brightness and contrast, and selects for picture mode, sound output and channel. Sensors report the current app, current channel, power state and volume, and screen notifications are supported. Actions can launch an app, send a button press, take a screenshot or send a raw SSAP command. Turning the TV on uses Wake-on-LAN, with the MAC address normally detected automatically and settable in the options. Setup happens in the UI, and the TV can be discovered on the network and paired through a prompt on the screen.

Automatic summary of the README and code of belikh/ha-lg-webos-tv. Something wrong, or are you the maintainer and want your own text here? Get in touch

Shows in Vulpo

Quick Toggle card, Media Player card, Button card, Select card, Apple Watch, Control Center.

Download Vulpo

Supports

Works locallyTalks to your devices on your own network. No vendor cloud in between.
Found by itselfHome Assistant spots it on the network and offers to add it.
From the MarketplaceInstalled through the Marketplace, formerly HACS.
Actively maintainedIts author released or pushed a change in the last six months.

Provides

Media
Remotes
Switches
Sensors

Setting it up

Install it from the Marketplace and restart Home Assistant, then add it under Settings, Devices and services.

Connect to your LG webOS TV

HostHostname or IP address of your LG webOS TV.

Also asked when changing the connection.

After setup

MAC addressMAC address of the TV, used to send wake-on-LAN packets so the TV can be turned on. This is normally detected automatically; only set it manually if turning the TV on does not work, e.g. when the TV was switched off during setup.
Sources listList of sources to show in the media player source list

Texts from the code of belikh/ha-lg-webos-tv.

Entities

ButtonsReboot, Turn screen off, Turn screen on
NotifiersNotifications
NumbersBacklight, Brightness, Color, Color temperature, Contrast, Sharpness
RemotesRemote
SelectsChannel, Picture mode, Sound output
SensorsCurrent app, Current channel, Power state, Volume
SwitchesGSR, TPC

Actions

ButtonSend a remote button press to the TV.
- Button
CommandSend a raw SSAP command to the TV.
- Command
- Payload
Launch appLaunch an app on the TV.
- App ID
- Parameters
Select sound outputChange the sound output of the TV.
- Sound output
Set settingsWrite settings via the TV's settings API (power-user escape hatch).
- Category
- Settings
Take screenshotTake a screenshot of the current TV screen.
- Filename

Troubleshooting

DiagnosticsDownloads a diagnostics file to attach to a bug report.

From the README

A custom integration for controlling LG TVs running webOS in Home Assistant, built on the bscpylgtv library by
The integration keeps a persistent websocket connection to the TV and receives state updates as they happen (push, not polling). Its architecture closely follows the built-in Home Assistant webostv integration — thanks to the HA core webostv maintainers for the reference implementation — while exposing the additional surface the bscpylgtv library offers: picture calibration sliders, picture mode / sound output / channel selects, power-state and channel sensors, a full remote with pointer and text input, screen notifications, and raw SSAP access for power users.
Setup via UI with SSDP auto-discovery and TV-prompt pairing (no PIN codes).
Push updates over a supervised websocket connection with automatic reconnect and self-healing after TV restarts or network hiccups.
Turn TV on via Wake-on-LAN (automatic MAC detection when available).
Reauth & reconfigure flows for pairing-key loss and IP/host changes.
Diagnostics with sensitive data redacted.
Entities across media player, remote, notify, button, number, select, sensor and switch platforms (see the table below).
Six integration services for advanced control, including raw SSAP commands and screenshots.

From the README of belikh/ha-lg-webos-tv, MIT License. Shortened.