Skip to content

A library for setting FRITZ!DECT thermostat values (e.g. offset, holidays, timer), that can't be set via AHA requests.

License

Notifications You must be signed in to change notification settings

mietzen/python-fritz-advanced-thermostat

Repository files navigation

Disclaimer

This package is not related to or developed by AVM. No relationship between the developer of this package and AVM exists.

All trademarks, logos and brand names are the property of their respective owners. All company, product and service names used in this package are for identification purposes only. Use of these names,trademarks and brands does not imply endorsement.

Advanced Fritz Thermostat

A library for setting the values AHA requests won't let you!

For basic settings use Heikos (hthiery) amazing pyfritzhome!

Disclaimer

This library will always be hacky and will never leave the "beta state", since it uses undocumented API's and selenium for data scraping. I use this library myself and I give my best to keep it updated.

But with any FritzOS upgrade this library might stop working, don't uses this if you can't live with that!

Remember: I'm doing this for free as a hobby, so be nice!

Requirements

  • Python 3.9.0 or higher

Tested configurations

Device Tested in FritzOS
FRITZ!DECT 301 7.29
FRITZ!DECT 301 7.30
FRITZ!DECT 301 7.31
FRITZ!DECT 301 7.56
FRITZ!DECT 301 7.57

If you have a different device or FritzOS version set experimental=True this will disable all checks, but beware there might be dragons!

Setup

Install using pip:

pip install fritz-advanced-thermostat

You will also need to setup a user.

Example Usage

from fritz_advanced_thermostat import FritzAdvancedThermostat
from fritz_advanced_thermostat import FritzAdvancedThermostatError

host='192.168.178.1'
user='my-user'
password='my-password'

try:
    fat = FritzAdvancedThermostat(host, user, password, ssl_verify=False, experimental=False)

    print('Available thermostats:')
    devices = fat.get_thermostats()
    for dev in devices:
        print('Device name: ' + dev)

    device_name = devices[0]
    current_offset = fat.get_thermostat_offset(device_name)
    print('Current offset of ' + device_name + ': ' + str(current_offset))
    fat.set_thermostat_offset(device_name, current_offset + 1)
    fat.commit()

    new_offset = fat.get_thermostat_offset(device_name, force_reload=True)
    print('New offset of ' + device_name + ': ' + str(new_offset))
except FritzAdvancedThermostatError as err:
    print('An error ouccured, check the logs!')
    print(err)

Contribute

Contributions are always welcome, just open a PR, specially if you find a way to obtain the thermostat data without selenium!

About

A library for setting FRITZ!DECT thermostat values (e.g. offset, holidays, timer), that can't be set via AHA requests.

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages