lgtv-companion-linux

Keep LG webOS TVs in sync with your Linux PC's power state: automatic power on/off with boot, shutdown, suspend and resume; screen blanking on user idle; HDMI input management; Wake-on-LAN; and a CLI exposing the full webOS control surface (picture, sound, inputs, buttons, luna settings).

A feature-parity Linux port of the excellent LGTV Companion for Windows by Jörgen Persson — designed to work on immutable distributions such as Bazzite (Fedora Atomic) as well as regular desktops.

How it works

Reboot vs shutdown is detected deterministically via systemd (PrepareForShutdownWithMetadata + a Conflicts=reboot.target fallback unit): a reboot leaves the TV on, a shutdown powers it off. No localized-string matching like on Windows.

Before an automatic power-off the daemon checks which input the TV is showing (getForegroundAppInfo): if someone is watching another HDMI source or an app, the TV is left alone.

Install (system mode, works on ostree/immutable distros)

sudo python3 -m venv /usr/local/lib/lgtv-companion
sudo /usr/local/lib/lgtv-companion/bin/pip install lgtvcompanion   # or a git checkout
sudo ln -s /usr/local/lib/lgtv-companion/bin/lgtvc{,-daemon} /usr/local/bin/
sudo lgtvc setup install --mode system --service-user $USER
sudo lgtvc setup pair --host <tv-ip>       # approve the prompt on the TV
sudo systemctl enable --now lgtvc-daemon lgtvc-shutdown
systemctl --user enable --now lgtvc-agent

Nothing touches /usr (the venv lives in /usr/local = /var/usrlocal on ostree); units live in /etc/systemd/system, config in /etc/lgtv-companion/config.json, pairing keys in /var/lib/lgtv-companion/keys/.

Migrating from Windows? lgtvc setup import-windows --file config.json converts your existing settings including device session keys (no re-pairing).

CLI

lgtvc -poweron                        # all devices
lgtvc -backlight 80 -mute LivingRoom  # several commands, device by name
lgtvc -sethdmi 2
lgtvc -picturemode filmMaker -energysaving off
lgtvc -button INFO
lgtvc -get_system_settings picture '["backlight","contrast"]'
lgtvc -output friendly -request com.webos.service.tvpower/power/getPowerState
lgtvc events                          # stream SYSTEM_* events for scripting

Same syntax as the Windows LGTVcli: commands are case-insensitive, several per invocation, trailing bare words select devices (none = all).

Feature parity vs upstream (Windows)

Documentation

• Install — system & user modes, ostree/SELinux notes
• MQTT / Home Assistant — bridge + HA auto-discovery
• Migration — from Windows or a hand-rolled setup
• External API — event stream + scripting
• Parity matrix — vs the Windows app
• Troubleshooting — EACCES, WoL, suspend, and more

License

MIT. Portions of the design and the command/button tables are derived from LGTV Companion, © Jörgen Persson, MIT.