Skip to content

Repository files navigation

LGWebOSRemote

Command line webOS remote for LGTVs. This tool uses a connection via websockets to port 3000 on newer LG TVs, there are other tools which use a restful connection to port 8080 however that port is closed on newer firmware versions.

Supported models

Tested with

  • UF830V
  • UH650V
  • UJ635V
  • UF776V
  • HU80KG.AEU (CineBeam 4K)
  • [please add more!]

Tested with python 2.7 on mac/linux and works fine, your mileage may vary with windows, patches welcome.

Likely supports

All devices with firmware major version 4, product name "webOSTV 2.0"

Available Commands

scan
auth Hostname/IP Authenticate and exit, creates initial config ~/.lgtv.json
audioStatus audioVolume closeApp appid
getTVChannel input3DOff input3DOn inputChannelDown inputChannelUp inputMediaFastForward inputMediaPause inputMediaPlay inputMediaRewind inputMediaStop listApps listChannels listInputs listServices mute muted
notification message
off on openAppWithPayload payload
openBrowserAt url
openYoutubeId videoid
openYoutubeURL url
setInput input_id
setTVChannel channel
setVolume level
startApp appid
swInfo volumeDown volumeUp

Install

Requires wakeonlan, websocket for python and arp (in Debian/Ubuntu: apt-get install net-tools)

There's a requirements.txt included

virtualenv venv
source venv/bin/activate
pip install -r requirements.txt

Example usage

# Scan/Authenticate
$ python lgtv.py scan {
"count": 1, "list": [
{
"address": "192.168.1.31", "model": "UF830V", "uuid": "10f34f86-0664-f223-4b8f-d16a772d9baf"
}
], "result": "ok"
}
$ python lgtv.py auth 192.168.1.31
$ python lgtv.py on
$ python lgtv.py off
# If you have the youtube plugin
$ python lgtv.py openYoutubeURL https://www.youtube.com/watch?v=dQw4w9WgXcQ
# Otherwise, this works reasonably well
$ python lgtv.py openBrowserAt https://www.youtube.com/tv#/watch?v=dQw4w9WgXcQ

Caveats

You need to auth with the TV before being able to use the on command as it requires the mac address.

Bugs

I couldn't test youtube because it seems the app isn't installed and not available to download right now maybe they're updating it?

About

Command line webOS remote for LGTVs

Resources

Code of conduct

Stars

1 star

Watchers

1 watching

Forks

Releases

Packages

Contributors

Languages