#tv #control #remote-control #remote #lg #cli #command-line

bin+lib LGremote

Command line tool for controlling LG TVs from the 2012 era

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

#16 in #tv

27 downloads per month

MIT license

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.

  1. LGRemote IPaddress will cause the TV to display the pairing key.
  2. LGRemote IPaddress Key Command will issue the command to the TV.
  3. You can alias the command e.g. alias TV_control="LGRemote 192.168.1.100 123456" and use it like so TV_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.

  1. https://github.com/ubaransel/lgcommander
  2. https://github.com/grieve/python-lgtv - this is where the command codes are from largely.
  3. http://dorchain.net/~joerg/code/lg.py
  4. https://github.com/timmson/node-lgtv-api - most useful
  5. 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–20MB
~307K SLoC