Usage

After you installed libtado you can easily test it by using the included cli like this:

tado --credentials-file /path/to/a/secure/folder/tado-credentials.json whoami

To use the library in your own code you can start with this:

from libtado.api import Tado
import webbrowser   # only needed for direct web browser access

t = Tado(token_file_path='/path/to/a/secure/folder/tado-credentials.json')

status = t.get_device_activation_status()

if status == "PENDING":
    url = t.get_device_verification_url()

    # to auto-open the browser (on a desktop device), un-comment the following line:
    # webbrowser.open_new_tab(url)

    t.device_activation()

    status = t.get_device_activation_status()

if status == "COMPLETED":
    print("Login successful")
else:
    print(f"Login status is {status}")

See the Authentication reference for details on the device-code login flow and token persistence.

Check out all available API methods to learn what you can to with libtado.