5 releases
0.2.1 | Jan 30, 2022 |
---|---|
0.2.0 | Jan 24, 2022 |
0.1.2 | Jan 19, 2022 |
0.1.1 | Jan 11, 2022 |
0.1.0 | Jan 10, 2022 |
#20 in #tv
27 downloads per month
13KB
200 lines
LGRemote
LG TVs of the 2012 era (before WebOS) allowed control via the network, this command line program allows you to issue commands to a compatible TV on your network.
If this project doesn't meet your needs check the Resources/References section for several others.
Installation
This project uses cargo
for build managment and is written entirely in rust
. Binaries are not yet available.
Either clone this repo and run cargo install --path .
or install via https://crates.io with cargo install LGremote
.
Usage
TVs can be identified through SSDP which is not yet supported. This is required to find the IP addresses of a TV.
LGRemote IPaddress
will cause the TV to display the pairing key.LGRemote IPaddress Key Command
will issue the command to the TV.- You can alias the command e.g.
alias TV_control="LGRemote 192.168.1.100 123456"
and use it like soTV_control VOLUME_UP
.
Compatible Commands
Command | Key | Notes |
---|---|---|
POWER | 1 | Can power the TV off but not on. Consider trying Wake on lan (not all TVs support this). |
NUM_0 | 2 | |
NUM_1 | 3 | |
NUM_2 | 4 | |
NUM_3 | 5 | |
NUM_4 | 6 | |
NUM_5 | 7 | |
NUM_6 | 8 | |
NUM_7 | 9 | |
NUM_8 | 10 | |
NUM_9 | 11 | |
UP | 12 | |
DOWN | 13 | |
LEFT | 14 | |
RIGHT | 15 | |
OK | 20 | |
HOME | 21 | |
MENU | 22 | |
BACK | 23 | |
VOLUME_UP | 24 | |
VOLUME_DOWN | 25 | |
MUTE | 26 | |
CHANNEL_UP | 27 | |
CHANNEL_DOWN | 28 | |
BLUE | 29 | |
GREEN | 30 | |
RED | 31 | |
YELLOW | 32 | |
PLAY | 33 | |
PAUSE | 34 | |
STOP | 35 | |
FF | 36 | |
REW | 37 | |
SKIP_FF | 38 | |
SKIP_REW | 39 | |
REC | 40 | |
REC_LIST | 41 | |
LIVE | 43 | |
EPG | 44 | |
INFO | 45 | |
ASPECT | 46 | |
EXT | 47 | |
PIP | 48 | |
SUBTITLE | 49 | |
PROGRAM_LIST | 50 | |
TEXT | 51 | |
MARK | 52 | |
3D | 400 | |
3D_LR | 401 | |
DASH | 402 | |
PREV | 403 | |
FAV | 404 | |
QUICK_MENU | 405 | |
TEXT_OPTION | 406 | |
AUDIO_DESC | 407 | |
NETCAST | 408 | |
ENERGY_SAVE | 409 | |
AV | 410 | |
SIMPLINK | 411 | |
EXIT | 412 | |
RESERVED | 413 | Does nothing? |
PIP_CHANNEL_UP | 414 | |
PIP_CHANNEL_DOWN | 415 | |
PIP_SWITCH | 416 | |
APPS | 417 |
Resources/References
Unfortunately official documentation doesn't seem to be available any longer but several libraries and scripts are available. node-lgtv-api[4] is by far the most complete and useful project.
- https://github.com/ubaransel/lgcommander
- https://github.com/grieve/python-lgtv - this is where the command codes are from largely.
- http://dorchain.net/~joerg/code/lg.py
- https://github.com/timmson/node-lgtv-api - most useful
- https://developer.lgappstv.com/TV_HELP/index.jsp?topic=%2Flge.tvsdk.references.book%2Fhtml%2FUDAP%2FUDAP%2FAnnex - defunct
License
MIT licensed as that is in keeping with previous projects.
Dependencies
~7–18MB
~283K SLoC