whyz / tellive-py

Python wrapper for Telldus Live

Python wrapper for Telldus Live

tellive-py is a Python wrapper for Telldus Live, "a user friendly service for automating your TellStick connected gear using the Internet".

• Official home page: https://github.com/erijo/tellive-py
• Python package index: https://pypi.python.org/pypi/tellive-py

Please report any problem as a GitHub issue report.

Features

• Includes the script tellive_core_connector for connecting a e.g. a Tellstick Duo to Telldus Live without needing Telldus Center. Supports both devices and sensors.
• Open source (GPLv3+).

Requirements

• Python 3.2+
• tellcore-py

Installation

$ pip install tellive-py

Example

To run the included program for connecting a TellStick to Telldus Live:

$ tellive_core_connector ~/.config/tellive.conf

The first time you run the program (with a particular config file), it will exit and ask you to visit a given URL to give the program access to your account.

When you have done so, you can then edit the config file (~/.config/tellive.conf in this example) and add a name to the sensors that you wish to send to Telldus Live. You can also disabled devices that you don't want to be controllable via Telldus Live (see tellive_core_connector --help for more info). Then start the program again as above.

The API can also be used by your own program. This how you would connect to Telldus Live and register the client (with PUBLIC_KEY and PRIVATE_KEY from here):

client = TellstickLiveClient(PUBLIC_KEY, PRIVATE_KEY)
(server, port) = client.connect_to_first_available_server()
client.register(version="0.1")