PyWebOSTV

Why another Library?

I looked at a few libraries. The LGWebOSRemote repository by klattimer is definitely a good library, but it has a few problems:

Meant to be used with Python 2.x.
Assumes all the users of the library would like to save the credentials to ~/.lgtv.json.
Assumes only a single command will be fired and waited on at any given time (ctrl+F for self.__waiting_callback)
Mouse/Keyboard not supported.

This SDK is a tiny attempt at overcoming some of the above problems.

Current status?

At the moment, I haven't been able to do any kind of extensive testing. No unit test cases too! Current status: Works for me! :)

Currently working on more controls and unit test cases. Upon testing, I will upload it to PyPI.

How to use it?

from pywebostv.connection import WebOSClient
from pywebostv.controls import (
    MediaControl, SystemControl, ApplicationControl, InputControl)

store = {}  # or e.g. {"client_key": "1a234567890bcdef1a234567890bcdef"}
client = WebOSClient.discover()[0]  # or e.g. WebOSClient('192.0.2.1')
client.connect()
for status in client.register(store):
    if status == WebOSClient.PROMPTED:
        print("Please accept the connect on the TV!")
    elif status == WebOSClient.REGISTERED:
        print("Registration successful!")

media = MediaControl(client)
system = SystemControl(client)
app = ApplicationControl(client)
inp = InputControl(client)

Media Controls

media.volume_up()
media.volume_down()
print(media.get_volume())
media.set_volume(int(11))
media.mute(bool(True))
media.play()
media.pause()
media.stop()
media.rewind()
media.fast_forward()

System Controls

system.notify("This is a notification message!")
print(system.info())
system.power_off()

Application Controls

apps = app.list_apps()
launch_info = app.launch(apps[0])  # content_id="...", params=...
app.close(launch_info)

Mouse and Button Controls

inp.connect_input()

inp.move(10, 10) # Moves mouse
inp.click()
inp.up()
inp.down()
inp.left()
inp.right()
inp.home()
inp.back()

# Following 3 lines are valid only when an input field is focussed on TV.
inp.type("This sends keyboard input!")
inp.enter()  # Return key.
inp.delete(10)  # Backspace 10 chars

inp.disconnect_input()

More controls coming soon!

Credits

klattimer for his library! Since WebOS team decided against providing any sort of documentation, his repository was extremely useful for an initial implementation
As far as input controls are concerned, they are based on the Java package written by Connect-SDK folks!

galvanist / PyWebOSTV