FRITZ!Box Smart-Home-Integration, kostenlos und Open Source

Internetstatus und Datenraten, Gast-WLAN, Anwesenheit und Telefonanrufe deiner FRITZ!Box.

• Veröffentlicht von guim31
• Geräte
• Version 1.0.1
• Erfordert Gladys >=5.1.0
• ★ 0

Auf GitHub ansehenAlle externen Integrationen

Verbinde deine FRITZ!Box von AVM mit Gladys: Internetstatus und Datenraten, externe IP, ein Gast-WLAN, das du aus Gladys ein- und ausschalten kannst, die Anwesenheit der Handys und Rechner, die du auswählst (wer ist zu Hause), und auf Wunsch deine Telefonanrufe als Szenen-Auslöser. Alles bleibt in deinem lokalen Netzwerk: Die Integration spricht mit der Box über TR-064, die offizielle, von AVM dokumentierte Schnittstelle, und über den Anrufmonitor der Box. Keine Cloud, kein MyFRITZ!-Konto.

Ohne die Hardware entwickelt: Rückmeldungen sind willkommen. Die Integration ist durch automatische Tests abgedeckt, die auf echten Antworten von FRITZ!Boxen beruhen (gesammelt von der Bibliothek fritzconnection und von Home Assistant), lief aber noch nicht an einer echten Box. Erzähl uns im Gladys-Forum, wie sie mit deinem Modell läuft.

Was du bekommst

• Ein Gerät FRITZ!Box:

  Funktion	Typ in Gladys	Zeigt
  Internet	Eingangszustand (On/Off)	On, wenn die Box mit dem Internet verbunden ist
  Download	Datenrate, in Mbit/s	aktueller eingehender Verkehr der Leitung (Verlaufsdiagramm)
  Upload	Datenrate, in Mbit/s	aktueller ausgehender Verkehr
  Raten der Leitung	Datenrate, in Mbit/s (zwei Funktionen)	maximale Download- und Upload-Rate der Leitung (DSL-Synchronisation…)
  Externe IP	Text	öffentliche IPv4-Adresse der Box
  Verbindungsdauer	Dauer, in Minuten	Zeit seit der letzten (Neu-)Verbindung
  Gast-WLAN	Schalter	an/aus, aus Gladys steuerbar
  Neu verbinden	Taster	eine neue Internetverbindung (bei den meisten DSL-Anschlüssen neue IP)

• Ein Gerät pro ausgewähltem Netzwerkgerät (Handy, Rechner, Tablet…), mit einer Funktion Anwesenheit: anwesend, solange die Box es als verbunden sieht, abwesend nach einer Verzögerung, die du einstellst.

• Ein Dashboard-Widget FRITZ!Box: Datenraten, Internetstatus, Gast-WLAN mit Schaltfläche, wer zu Hause ist, und eine Schaltfläche Internet neu verbinden.

• Die Szenen-Auslöser Eingehender Anruf, Verpasster Anruf, Anruf beendet (mit der Nummer und dem Namen aus dem Telefonbuch der Box), Internetverbindung wiederhergestellt und Externe IP geändert.

• Die Szenen-Aktionen Gast-WLAN einschalten (auf Wunsch für eine Weile, mit Name und Kennwort für eine Nachricht an deine Gäste), Gast-WLAN ausschalten und Internet neu verbinden.

Voraussetzungen

• Gladys Assistant 5.1.0 oder neuer.
• Eine FRITZ!Box mit FRITZ!OS 7 oder neuer (Boxen mit FRITZ!OS 6.x antworten auch über TR-064, mit weniger Details), erreichbar von der Gladys-Maschine. FRITZ!Repeater und Boxen, die als Mesh-Repeater laufen, bekommen nur das Gast-WLAN und die Anwesenheit.
• Ein FRITZ!Box-Benutzer mit Kennwort und dem Recht FRITZ!Box Einstellungen. Für die Namen der Anrufer zusätzlich das Recht Sprachnachrichten, Faxnachrichten, FRITZ!App Fon und Anrufliste.
• Bei der Installation bittet Gladys dich, die SSDP-Suche nach urn:dslforum-org:device:InternetGatewayDevice:1 zu erlauben: Damit findet die Integration die Box ohne ihre Adresse.

Konfiguration

Die FRITZ!Box vorbereiten

Öffne die Oberfläche der Box (http://fritz.box):

1. Heimnetz > Netzwerk > Netzwerkeinstellungen: Aktiviere Zugriff für Anwendungen zulassen und Statusinformationen über UPnP übertragen (nötig für die aktuellen Datenraten). Übernehmen.
2. System > FRITZ!Box-Benutzer: Lege einen Benutzer für Gladys an, mit Kennwort und den oben genannten Rechten. Ein eigener Benutzer ist besser als dein eigener: Du kannst ihn jederzeit löschen.
3. Nur für die Anrufe: Wähle an einem Telefon an der Box (analog, DECT oder IP-Telefon) #96*5*, um den Anrufmonitor einzuschalten (#96*4* schaltet ihn aus).

Einstellungen

Unter Integrationen → FRITZ!Box → Konfiguration:

Einstellung	Standard	Wirkung
Adresse der FRITZ!Box	leer	Leer: Die Box wird im Netzwerk gesucht (dann fritz.box). Sonst ihre IP-Adresse oder ihr Name.
FRITZ!Box-Benutzername	—	Der oben angelegte Benutzer.
Kennwort	—	Sein Kennwort.
Verschlüsselte Verbindung (HTTPS)	aus	Port 49443 statt 49000. Das Zertifikat der Box wird nicht geprüft.
Aktualisierungsintervall	30 s	Wie oft die Box gelesen wird (10 s bis 5 min).
Abwesend nach	3 min	Wie lange ein Gerät in der Box fehlen darf, bevor es als abwesend gilt.
Telefonanrufe (Anrufmonitor)	aus	Schaltet die Anruf-Auslöser ein (Anrufmonitor der Box, Port 1012).
Sprache der Funktionsnamen	Französisch	Namen der Funktionen neuer Geräte und Sprache der Meldungen.

Starte dann Verbindung testen: Es zeigt das Modell der Box, ihr FRITZ!OS, den Internetstatus und die Zahl der verbundenen Geräte, oder sagt dir, was zu korrigieren ist.

Die Box und deine Geräte hinzufügen

Öffne den Tab Entdecken der Integration. Er listet die FRITZ!Box und die Geräte auf, die gerade mit ihr verbunden sind (die Box kennt viel mehr, aber nur die verbundenen werden vorgeschlagen: Ein Handy erscheint, wenn es im WLAN ist). Klicke bei der Box und bei jedem zu verfolgenden Gerät auf Zu Gladys hinzufügen. Die Schaltfläche Scannen liest die Liste der Box erneut.

Geräte

Die FRITZ!Box

• Internet ist On, wenn die Verbindung steht (Connected für die Box), sonst Off.
• Download und Upload sind der aktuelle Verkehr der Leitung in Mbit/s, bei jeder Aktualisierung gelesen. Beide brauchen Statusinformationen über UPnP übertragen: Ohne diese Einstellung meldet es die Konfiguration, und die beiden Funktionen bleiben leer.
• Download-Rate der Leitung und Upload-Rate der Leitung sind die maximalen Raten der Leitung (die DSL-Synchronisation oder die Raten des Kabel- oder Glasfasertarifs).
• Externe IP ist die öffentliche IPv4-Adresse. Hinter einem CGNAT (manche Glasfaser- und Kabelanbieter, DS-Lite) ist es eine Adresse des Anbieters, aus dem Internet nicht erreichbar.
• Verbindungsdauer zählt die Minuten seit der letzten Verbindung (sie beginnt bei jeder Neuverbindung von vorn: Die Zwangstrennung vieler DSL-Anschlüsse in der Nacht ist hier zu sehen).
• Gast-WLAN schaltet den Gastzugang der Box (das letzte WLAN der Box, wie bei Home Assistant). Richte ihn einmal in der Box ein (WLAN > Gastzugang, Name und Kennwort).
• Neu verbinden trennt die Internetverbindung; die Box wählt sofort neu. Bei DSL (PPPoE) gibt der Anbieter meist eine neue IP; bei Kabel oder Glasfaser bleibt die Adresse oft gleich. Das Internet ist einige Sekunden weg.

Nur die Änderungen werden veröffentlicht, und jeder Wert alle 12 Stunden erneut, damit ein stabiler Wert nie „Kein aktueller Wert“ zeigt.

Netzwerkgeräte (Anwesenheit)

Jedes hinzugefügte Gerät hat eine Funktion Anwesenheit: anwesend (1), sobald die Box es als verbunden auflistet, abwesend (0), sobald es während der Zeit Abwesend nach gefehlt hat. Handys im WLAN-Ruhezustand verschwinden für einige Minuten aus der Liste: Lass ihnen 3 bis 10 Minuten. Ein per Kabel angeschlossener Rechner wird sofort gesehen.

Um eine Person als zu Hause zu markieren, nimm die Anwesenheit ihres Handys in einer Szene: Änderung von Gerätestatus auf Anwesenheit → Benutzer zu Hause gesehen, mit angehaktem Nur ausführen, wenn der Schwellenwert überschritten wird (der Zustand wird alle 12 Stunden erneut gesendet).

Dashboard-Widget

Dashboard bearbeiten → Widget hinzufügen → FRITZ!Box. Das Widget zeigt die aktuellen Download- und Upload-Raten (Live-Kacheln, sobald die Box zu Gladys hinzugefügt ist), wie viele verfolgte Geräte zu Hause sind, den Internetstatus mit der Verbindungsdauer, das Gast-WLAN (mit der Restzeit, wenn es für eine Weile eingeschaltet wurde) und jedes verfolgte Gerät (zu Hause oder abwesend). Angezeigte Geräte wählt aus, welche (leer: alle, höchstens 8 neben den Zeilen Internet und Gast-WLAN). Zwei Schaltflächen: Gast-WLAN einschalten / ausschalten und Internet neu verbinden (mit Rückfrage). Das Widget zeigt nie die öffentliche IP und keine MAC-Adressen: Ein Dashboard kann Besuchern gezeigt werden.

Szenen-Auslöser

Auslöser	Wann	Variablen
Eingehender Anruf	das Telefon klingelt	Telefonnummer, Name (Telefonbuch), Deine Nummer
Verpasster Anruf	ein eingehender Anruf endete, ohne dass jemand abnahm (oder der Anrufbeantworter nahm ab)	dieselben, dazu Sekunden Klingeln und Anrufbeantworter (1/0)
Anruf beendet	ein angenommener Anruf endete, eingehend oder ausgehend	dieselben, dazu Richtung (incoming/outgoing) und Dauer (s)
Internetverbindung wiederhergestellt	die Box ist nach einem Ausfall wieder verbunden	Ausfall (Sekunden), Externe IP
Externe IP geändert	die öffentliche IPv4-Adresse hat sich geändert	Neue IP, Vorherige IP

Die Anruf-Auslöser brauchen die Einstellung Telefonanrufe und den Anrufmonitor der Box (#96*5*). Diese Auslöser lassen sich auf einen Anrufer (Nummer des Anrufers) oder auf eine deiner Nummern (Deine Nummer) beschränken, so geschrieben, wie die Box sie anzeigt (die Anrufliste der Box zeigt das Format). Der Name kommt aus den Telefonbüchern der Box; eine unbekannte Nummer ergibt die Nummer selbst, eine unterdrückte Nummer „Unterdrückte Nummer“ (in der Sprache der Konfiguration).

Für „das Internet ist weg“ nimm den Kern-Auslöser Änderung von Gerätestatus auf der Funktion Internet, Wert Off, mit gesetztem Schwellenwert-Häkchen. Eine Nachricht, die in diesem Moment gesendet wird, verlässt das Haus vielleicht nicht: Sende sie, wenn die Verbindung zurück ist, mit Internetverbindung wiederhergestellt und der Dauer des Ausfalls.

Szenen-Aktionen

• Gast-WLAN einschalten: optional Ausschalten nach (Minuten) (leer oder 0: bleibt an, höchstens 1440). Die Integration schaltet es am Ende aus, auch nach einem Neustart. Ergebnisse: Name des Gast-WLANs und Kennwort des Gast-WLANs, um sie deinen Gästen in einer Nachricht zu schicken. Von Hand ein- oder ausschalten bricht den Timer ab.
• Gast-WLAN ausschalten.
• Internet neu verbinden: Mit Auf die Neuverbindung warten starten die nächsten Schritte, sobald die Box wieder verbunden ist, oder nach 100 Sekunden (Gladys gibt einer Aktion höchstens 120 Sekunden). Ergebnisse: Verbunden (1/0), Externe IP und Neue IP (1/0).

Die Ergebnisse sind Zahlen (1/0), damit Nur fortsetzen, wenn sie vergleichen kann: Wähle das Ergebnis, =, und tippe 1.

Szenen-Beispiele

1. Gäste kommen: Zeitabhängiger Auslöser am Samstag um 19:00 → Gast-WLAN einschalten für 300 Minuten → Nachricht senden „Gast-WLAN: [Name], Kennwort [Kennwort]“ (füge die beiden Ergebnisse aus der Variablenliste ein).
2. Niemand zu Hause: Änderung von Gerätestatus auf der Anwesenheit jedes Handys, Wert Keine Anwesenheit, Schwellenwert angehakt → Anwesenheit von Benutzern überprüfen → Licht aus, Heizung herunter.
3. Verpasster Anruf: Verpasster Anruf → Nachricht senden „Verpasster Anruf von [Name] ([Telefonnummer])“.
4. Ausfallbericht: Internetverbindung wiederhergestellt → Nachricht senden „Das Internet war [Ausfall] Sekunden weg“.

Fehlerbehebung

• „Die FRITZ!Box lässt keine Anwendungen zu“: Aktiviere Zugriff für Anwendungen zulassen unter Heimnetz > Netzwerk > Netzwerkeinstellungen.
• „Die FRITZ!Box hat Benutzername oder Kennwort abgelehnt“: Prüfe den Benutzer und sein Kennwort unter System > FRITZ!Box-Benutzer. Nach einer Ablehnung wartet die Integration 15 Minuten vor dem nächsten Versuch (die Box sperrt Anmeldungen nach Fehlversuchen immer länger), oder bis du die Konfiguration änderst.
• „Dem FRITZ!Box-Benutzer fehlt das Recht FRITZ!Box Einstellungen“: Gib ihm dieses Recht; ohne es können das Gast-WLAN und die Geräteliste nicht gelesen werden.
• „Aktuelle Datenraten nicht verfügbar“: Aktiviere Statusinformationen über UPnP übertragen.
• „Keine FRITZ!Box gefunden“ oder „antwortet nicht“: Gib die IP-Adresse der Box (oft 192.168.178.1) unter Adresse der FRITZ!Box ein. Die Netzwerksuche braucht den bei der Installation erlaubten SSDP-Zugriff und geht weder über Router noch über VLANs.
• „Der Anrufmonitor ist aus“: Wähle #96*5* an einem Telefon an der Box.
• Ein Handy erscheint abwesend, obwohl es da ist: Es schläft im WLAN; erhöhe Abwesend nach auf 10 oder 15 Minuten. Neuere Handys nutzen eine private WLAN-Adresse: Diese bleibt für ein bestimmtes Netzwerk gleich (iOS „Fest“, Android „Zufällige MAC“ pro Netzwerk), aber eine „Rotierende“ Adresse erzeugt alle paar Tage ein neues Gerät: Wähle für das WLAN zu Hause eine feste Adresse.
• Das Gast-WLAN tut nichts: Richte den Gastzugang einmal in der Box ein (WLAN > Gastzugang).

Grenzen

• Ohne die Hardware entwickelt: siehe oben.
• Eine FRITZ!Box pro Installation der Integration. Die FRITZ!Repeater eines Mesh werden nicht gelesen (die Geräte, die sie versorgen, erscheinen trotzdem in der Liste der Box).
• FRITZ!SmartHome (DECT-Steckdosen und -Thermostate) ist nicht abgedeckt: Das wird eine andere Integration.
• Die aktuellen Datenraten kommen aus dem UPnP-Status der Box, im gewählten Intervall gelesen: Das ist eine Momentaufnahme, kein Mittelwert.
• Nur externe IPv4; das IPv6-Präfix wird nicht angezeigt.
• Die Anwesenheit eines Geräts ist das, was die Box weiß: Ein Handy mit ausgeschaltetem WLAN oder in einem anderen Netzwerk ist abwesend.
• Was die Integration speichert, in /data/state.json ihres Containers: die von der Suche gefundene Adresse der Box, ihre Seriennummer, die letzte externe IP und das Ende eines Gast-WLAN-Timers. Das Kennwort bleibt in der Gladys-Konfiguration; Nummern und Namen werden nie auf die Festplatte oder in die Protokolle geschrieben.
• Anfragerate: Jede Aktualisierung sendet 4 bis 6 kleine Anfragen an die Box (standardmäßig alle 30 s).

Konfigurationseinstellungen

Diese Einstellungen fragt FRITZ!Box in seinem Konfigurationsbildschirm in Gladys ab.

Einstellung	Typ	Pflichtfeld	Beschreibung
Deine FRITZ!Box verbinden	section	Nein	In der FRITZ!Box (http://fritz.box): Aktiviere „Zugriff für Anwendungen zulassen“ und „Statusinformationen über UPnP übertragen“ unter Heimnetz > Netzwerk > Netzwerkeinstellungen und lege unter System > FRITZ!Box-Benutzer einen Benutzer mit dem Recht „FRITZ!Box Einstellungen“ an. Starte dann „Verbindung testen“ und füge die Box und deine Geräte im Tab „Entdecken“ hinzu.
Adresse der FRITZ!Box	string	Nein	Leer lassen, um sie automatisch im Netzwerk zu finden.
FRITZ!Box-Benutzername	string	Ja	Ein Benutzer aus System > FRITZ!Box-Benutzer mit dem Recht „FRITZ!Box Einstellungen“.
Kennwort	secret	Ja
Verschlüsselte Verbindung (HTTPS)	boolean	Nein	Port 49443 statt 49000. Das eigene Zertifikat der Box wird nicht geprüft.
Aktualisierungsintervall	select	Nein	Wie oft die Box gelesen wird (Status, Datenraten, verbundene Geräte).
Abwesend nach	select	Nein	Zeit, die ein Gerät in der Box fehlen darf, bevor es als abwesend gilt. Handys im WLAN-Ruhezustand verschwinden für einige Minuten.
Telefonanrufe (Anrufmonitor)	boolean	Nein	Szenen-Auslöser für eingehende, verpasste und beendete Anrufe. Wähle vorher #965 an einem Telefon an der FRITZ!Box.
Sprache der Funktionsnamen	select	Nein	Namen der Funktionen neuer Geräte und Sprache der Meldungen.

So installierst du FRITZ!Box in Gladys

1. Öffne in Gladys Integrationen: FRITZ!Box erscheint im Katalog neben den nativen Integrationen, mit einem Community-Badge.
2. Klicke auf Installieren. Gladys lädt das Docker-Image (ghcr.io/guim31/gladys-fritzbox:1.0.1) herunter, startet es in einer vom Kern isolierten Sandbox und erzeugt die Oberfläche der Integration (Geräte, Erkennung und Konfiguration).
3. Öffne den Bildschirm Konfiguration der Integration, fülle die Einstellungen aus und speichere.
4. Du kannst sie auch direkt über die URL ihres Repositorys installieren: https://github.com/guim31/gladys-fritzbox.

FRITZ!Box benötigt Gladys >=5.1.0. Der Katalog in Gladys wird stündlich aktualisiert, eine neue Version ist also spätestens eine Stunde nach ihrer Veröffentlichung verfügbar.

Du nutzt Gladys noch nicht? Es ist kostenlos und Open Source: folge der Installationsanleitung, um loszulegen.

Über externe Integrationen

FRITZ!Box ist eine externe Integration: eine Community-Integration, die als Docker-Container verpackt und auf GitHub veröffentlicht wird. Gladys installiert sie mit einem Klick und führt sie in einer vom Kern isolierten Sandbox aus. Sie wird von guim31 veröffentlicht und gepflegt, nicht vom Gladys-Kernteam.

• Alle externen Integrationen durchsuchen
• Die nativen Integrationen entdecken, die in Gladys eingebaut sind
• Deine eigene externe Integration bauen und veröffentlichen
• Quellcode auf GitHub — Quelle dieser Dokumentation

Abonniere den Newsletter von Gladys Assistant

Ein paar E-Mails im Monat zu neuen Releases und Neuigkeiten aus dem Projekt. Verschickt von Pierre-Gilles Leymarie, dem Gründer des Projekts. Jederzeit abbestellbar 🙂