diff --git a/README.md b/README.md index cb20a48..9958047 100644 --- a/README.md +++ b/README.md @@ -1,12 +1,16 @@ python-lgtv =========== -Simple class for pairing with and controlling your 2012+ LG TV with python. +Simple class for pairing with and controlling your 2011 LG TV with python. + +**For 2012+ TVs check out the original of this fork at https://github.com/grieve/python-lgtv** **This library does not appear to support the newer WebOS LG TVs. Please see https://github.com/klattimer/LGWebOSRemote if this does not work for you.** You can find all TVs on the network using the `find_tvs` class method. +**This was only tested with a 42LW579S-ZD + ``` from lg import Remote @@ -18,7 +22,7 @@ If you have only one, it'll be faster to use the `first_only` parameter. address = Remote.find_tvs(first_only=True) ``` -You will need a pairing key, if you already know it you can pass it to the `Remote` class' `__init__` otherwise you can create your remote control instance and it'll ask the TV to display it onscreen. You can then provide this pairing key using the `set_pairing_key` method. +You will need a pairing key, if you already know it you can initiate the Remote class with it as second parameter. Otherwise you can create your remote control instance and it'll ask the TV to display it onscreen. You can then provide this pairing key using the `set_pairing_key` method. ``` remote = Remote(address) @@ -28,9 +32,10 @@ remote.set_pairing_key(key) ``` After this you can send single or multiple commands using `send_command` and `send_multiple`. +2011 Models initiate a session key. This currently still needs to be passed every time you call `send_command` ``` -remote.send_command(Remote.VOLUME_UP) +remote.send_command(Remote.VOLUME_UP, remote.session) commands = [Remote.HOME, Remote.EXIT, Remote.MENU] remote.send_multiple(commands) @@ -38,72 +43,4 @@ remote.send_multiple(commands) An optional `delay` parameter can be provided to `send_multiple`; this will the amount of seconds the control will wait between commands. N.B. Sending commands too fast can cause some of them to be ignored. -A reference of all the shortcut commands available are below, you are free to send any integer with `send_command` but be careful if you don't know what your are doing, as some commands can force the TV in service modes that can be tricky to get back out of. - -``` - POWER = 1 - 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 - RESERVE = 413 - PIP_CHANNEL_UP = 414 - PIP_CHANNEL_DOWN = 415 - PIP_SWITCH = 416 - APPS = 417 -``` +Shortcuts-structure is subject to change. They still can be looked up in `lg.py`. Be careful on your journey! \ No newline at end of file