No further development will take place, since I do not own any FRITZ! Smart Devices anymore. Feel free to use it as a base for your own fork.
Development of the popular homebridge-fritz-platform has stalled.
The main goal of this project was to maintain compatibility with modern Homebridge and FRITZ!Box firmware versions, allowing users to control key smart home functions from within HomeKit.
This plugin focuses on stability and simplicity rather than feature completeness. It provides the essential functionality needed for daily use, but it is no full replacement for the original plugin or a competitor to more comprehensive solutions such as Home Assistant integrations.
This plugin supports the following devices and actions within the FRITZ! ecosystem:
| Device | Supported actions |
|---|---|
| Thermostats (e.g. FRITZ!DECT 301) |
- Temperature reporting - Change target temperature - Recall templates |
| Outlets (e.g. FRITZ!DECT 200 / 210) |
- Power toggle - Temperature reporting |
Other FRITZ! SmartHome devices (e.g. window sensors or lights) are not supported.
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 supports only outlets, thermostats and a template recall functionality. As I no longer own any FRITZ! SmartHome devices, I am not planning further development.
If you wish to extend support for additional FRITZ! devices (e.g., switches, sensors), please create an own fork of the repository.
Some examples of possible devices and features are:
| Device | Possibly supported actions |
|---|---|
| Lights (e.g. FRITZ!DECT 500) |
- Power toggle - Change brightness / color - Adaptive lighting |
| Sensors (e.g. FRITZ!DECT 350) |
- Window state reporting |
| Buttons (e.g. FRITZ!DECT 400, 440) |
- Temperature and humidity reporting - Note: Button presses cannot be detected reliably |
- 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.