How do I connect LGWebOSRemote to my LG TV?

Install via pip or pipx, run 'lgtv scan' to find your TV's IP, then use 'lgtv auth' with the IP and a name, following on-screen pairing instructions. Set a default TV with 'lgtv setDefault' to skip the --name argument.

LGWebOSRemote vs Home Assistant LG TV integration?

LGWebOSRemote is better for direct CLI scripting and fine-grained automation, while Home Assistant offers a GUI and broader smart home integration. Choose LGWebOSRemote if you need programmatic control from scripts or custom apps.

Why is LGWebOSRemote not working on my new LG TV?

Ensure your TV uses webOS firmware version 4 or higher and that you're using SSL with --ssl flag, as newer models require port 3001. Also, check network connectivity and that the TV is on the same local network.

How to automate turning on an LG TV with LGWebOSRemote?

First authenticate the TV to get its MAC address, then use 'lgtv --name TVName --ssl on' in scripts. For headless setups, integrate this into cron jobs or home automation systems, but note that initial pairing is manual.

Can LGWebOSRemote control streaming apps like Netflix?

Yes, you can launch apps using 'startApp' with the app ID, but internal app control (e.g., searching Netflix) is limited to button simulations; specific app APIs are not fully exposed, so functionality may vary.

What Python versions does LGWebOSRemote support?

Tested with Python 3.9 on Debian, 3.10 on Windows, and 3.12 on macOS, as per the README. It likely works with Python 3.x versions, but check compatibility if using older or newer releases.

Open-Awesome

LGWebOSRemote

MITPython

A command-line tool to control LG webOS TVs via WebSocket, supporting newer firmware with SSL.

GitHub

646 stars113 forks0 contributors

What is LGWebOSRemote?

LGWebOSRemote is a command-line remote control tool for LG webOS televisions. It connects to the TV via WebSocket (using port 3000 or 3001 with SSL) to send commands for power management, media playback, app launching, and system control. It solves the problem of controlling newer LG TVs where traditional REST-based methods on port 8080 are no longer available due to firmware updates.

Target Audience

Developers, home automation enthusiasts, and power users who want to script or automate control of their LG webOS TVs from a command line or within custom applications.

Value Proposition

Developers choose LGWebOSRemote because it supports modern LG TV firmware with SSL, offers a comprehensive set of commands, and is community-tested across a wide range of TV models. It provides a reliable, scriptable alternative to proprietary apps or unsupported methods.

Overview

Command line webOS remote for LGTVs

Use Cases

Best For

Automating TV power states in smart home setups
Scripting media playback control from a command line
Integrating LG TV control into home automation systems like Home Assistant
Developing custom remote applications for LG webOS TVs
Controlling LG TVs in headless or kiosk environments
Sending notifications or alerts to an LG TV display programmatically

Not Ideal For

Applications needing a graphical user interface for remote control
Environments with non-webOS LG TVs or very old firmware
Real-time, interactive remote control where CLI latency is unacceptable
Setups requiring fully automated control without manual TV pairing

Pros & Cons

Pros

Modern Firmware Compatibility

Uses WebSocket on ports 3000/3001 with SSL, specifically working on newer LG TVs where older REST methods on port 8080 are blocked, as stated in the README.

Extensive Command Library

Supports a wide range of functions from power management to app control, with commands like 'on', 'off', 'openApp', and 'sendButton' listed in the README.

Community-Tested Reliability

Maintained with user contributions, with a tested model list including various OLED and UHD models, ensuring broad compatibility and ongoing debugging.

Easy Network Discovery

Includes a 'scan' feature to automatically find LG TVs on the local network, simplifying initial setup and authentication.

Cons

SSL Dependency Complexity

Requires SSL for newer firmware, connecting to port 3001, which can complicate setup if users face certificate issues or network configuration challenges.

Incomplete Feature Set

The README lists TODOs like 'closeToast' and 'getSystemSettings', indicating missing functionalities that might be needed for comprehensive TV control.

Manual Authentication Barrier

Each TV requires on-screen pairing during authentication, which interrupts automation and adds a manual step before full control can be achieved.

Frequently Asked Questions

Related Projects

homebridge-webos-tv

Homebridge plugin for LG webOS TVs

Stars699

Forks86

Last commit4 months ago

lgtv2

Control LG WebOS TV using node.js :tv:

Stars344

Forks46

Last commit4 years ago

PyWebOSTV

Python API for controlling LG TVs (Web OS)

Stars313

Forks57

Last commit9 months ago

lgtv2mqtt

Interface between LG WebOS Smart TVs and MQTT :tv:

Stars109

Forks35

Last commit3 years ago

Community-curated · Updated weekly · 100% open source

Found a gem we're missing?

Open-Awesome is built by the community, for the community. Submit a project, suggest an awesome list, or help improve the catalog on GitHub.

Submit a project Star on GitHub