Development of the popular homebridge-fritz-platform has stalled.
The main goal of this project is to maintain compatibility with modern Homebridge and FRITZ!Box firmware versions, allowing users to control key smart home functions from within HomeKit.
This plugin currently focuses on stability and simplicity rather than feature completeness. It provides the essential functionality needed for daily use, but it is currently no full replacement for the original plugin or a competitor to more comprehensive solutions such as Home Assistant integrations.
Currently, this plugin supports the following devices and actions within the FRITZ! ecosystem:
| Device | Supported actions |
|---|---|
| Thermostats (e.g. FRITZ!DECT 301) |
- Power toggle - Change target temperature - Temperature reporting - Recall templates |
Other FRITZ! SmartHome devices (e.g., plugs or lights) are not yet supported.
Contributions are welcome if you wish to extend functionality. See below for further information.
You need access to a FRITZ!Box on your local network.
In your FRITZ!Box settings, enable access for local applications:
FRITZ! manual: Allowing Access to the Home Network for Apps and Applications
- ✅ Allow access for applications
- ✅ Transmit status information via UPnP
Create a FRITZ!Box user account with full permissions for home network access:
FRITZ! manual: Configuring FRITZ!Box Users
You can add this plugin either via the Homebridge UI or by editing your config.json manually.
Example configuration:
{
"platforms": [
{
"name": "FRITZ! Light",
"host": "fritz.box",
"username": "homebridge",
"password": "_example_password_change_me_",
"exposeTemplates": true,
"templatePrefix": "Template:",
"platform": "FritzLight"
}
]
}This plugin communicates directly with the FRITZ!Box using official local interfaces:
- TR-064 protocol: Currently only used to authenticate with the FRITZ!Box.
- AVM Home Automation (AHA) HTTP Interface: Provides access to smart home device lists and features such as thermostats, power outlets, and sensors.
- The newly developed FRITZ! Smart Home REST API is currently not used, since it is not very broadly supported yet (e.g. not by my devices).
All communication happens locally within your home network; no data is transmitted to external servers.
This plugin currently supports only thermostats and a template recall functionality. As I no longer own other FRITZ! SmartHome devices, I am not planning further feature development.
However, contributions are very welcome! If you wish to extend support for additional FRITZ! devices (e.g., plugs, switches, sensors), please fork the repository and open a pull request.
Some examples of possible devices and features are:
| Device | Supported actions |
|---|---|
| FRITZ!Box, FRITZ!Repeater | - Toggle guest WLAN |
| Buttons (e.g. FRITZ!DECT 400, 440) |
- Temperature and humidity reporting - Note: Button presses cannot be detected reliably |
| Lights (e.g. FRITZ!DECT 500) |
- Power toggle - Change brightness / color - Support for adaptive lighting |
| Outlets (e.g. FRITZ!DECT 200) |
- Power toggle - Temperature reporting |
| Sensors (e.g. FRITZ!DECT 350) |
- Window state reporting |
- Original
homebridge-fritz-platformby SeydX. - FRITZ!Box communication is based loosely on the
fritzboxTypeScript library by lukesthl.
All product and company names are trademarks™ or registered® trademarks of their respective holders.
Use of them does not imply any affiliation with or endorsement by them.