tellive-py 0.5.0

Python wrapper for connecting to 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

• On Mac OS X, appnope is recommended.

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 disable 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")

Changelog

0.5.0 (2014-11-19)

• Disable appnap on Mac OS X if appnope module is available (issue #2).

• Report new/changed/removed devices to Telldus live.

• Release socket(s) before waiting to re-connect.

• Require tellcore-py >= v1.1.0.

0.4.2 (2014-02-25)

• Fixed problem that could occur after disconnect from server.

• Fixed tellive_core_connector problem on Mac OS X (issue #1).

0.4.1 (2014-02-06)

• Add all sensors and devices to the config on the first run.

0.4.0 (2014-02-06)

• Fixed tellive_core_connector to not wake up two times every second, but instead only wake up when there is work to do.

0.3.0 (2014-02-04)

• Removed reload message as it is not supposed to be sent to clients.

• Better values for os and os-version in register message.

• Support marking devices as disabled to not show up in Telldus Live.

0.2.0 (2014-02-02)

• tellive_core_connector now uses official keys from Telldus, so you no longer need to use private tokens.

• Log using the standard logging module.

• Reconnect if connection is lost for some reason.

• Fixed problem with Python 3.2.

• Added support for reload request from server.

• Only report sensors that are named in the config file.

0.1.1 (2014-01-28)

• Fix some packaging issues.

0.1.0 (2014-01-28)

• Initial release.