FRITZ!Box Netzwerk/Die Dashboard-Karte

Karte hinzufügen → FRITZ!Box Netzwerk → Sensor mit der Geräteliste auswählen (üblicherweise sensor.<name>_gerate). Alles Weitere stellst du im grafischen Editor ein; ein YAML-Beispiel steht am Ende des Kapitels.

Reiter

Mit dem Schalter Kategorien als Tabs anzeigen (show_tabs, Standard aus) teilt sich die Karte in Reiter. Jeder Reiter zeigt nur seine eigenen Elemente; Reiter ohne Daten werden nicht angelegt, gibt es nur einen, verschwindet die Reiterleiste. Der Reiter Einstellungen ist immer der letzte. Ohne Tabs erscheinen Filter, Suche, Liste und (falls aktiviert) die Steuerungsleiste untereinander in einer Ansicht.

Reiter	Inhalt	Erscheint
Netzwerk (`mdi:lan`)	Filterleiste, Suchfeld, Zusammenfassung, Geräteliste	immer
Online-Monitor (`mdi:chart-areaspline`)	Down-/Upload-Rate mit Verlauf, Auslastung nach Priorität, größte Verbraucher, Verbindungsdetails, Online-Zähler	mit Datenverbrauchs-Erfassung; Editor: Reiter Online-Monitor anzeigen (`show_online`)
Mesh (`mdi:router-network`)	Mesh-Karte mit FRITZ!Box, Repeatern und verbundenen Geräten	mit mindestens einem Repeater; Editor: Reiter Mesh (Karte) anzeigen (`show_meshmap`)
Einstellungen (`mdi:cog`)	Schalter, Versionsanzeige, FRITZ!Box-Infos (früher „Steuerung“)	immer, letzter Reiter

Spalten

Spalte	Standard	Inhalt
Status	an	farbiger Punkt: verbunden / nicht verbunden
Gerät	an	Name aus der FRITZ!Box, mit Abzeichen für Gast, VPN und Priorität
IP-Adresse	an	Klick öffnet die Weboberfläche des Geräts
MAC-Adresse	an	Klick kopiert sie
Hersteller	aus	Hersteller zur MAC-Adresse aus der IEEE-Liste
Verbindung	an	z. B. „LAN 2“ oder „WLAN (Gast)“
Funkband	aus	WLAN-Band (2,4 / 5 / 6 GHz), in dem das Gerät gerade verbunden ist
Verbunden über	aus	Mesh-Nachbar (Box oder Repeater) samt Verbindungsrate
Home Assistant	an	Gerätename aus der Geräteregistrierung, verlinkt
IP-Typ	an	fest oder dynamisch, mit Lease-Restzeit, falls gemeldet
Internet	an	Internetzugang gesperrt (Kindersicherung)
Update	an	Firmware-Update für das Gerät verfügbar
Tempo	an	Verbindungsgeschwindigkeit in Mbit/s bzw. Gbit/s
Modell	aus	nur AVM-Geräte melden hier etwas
Gerätetyp	aus	automatisch erkannte oder gesetzte Geräteklasse
Zuletzt online	aus	wann das Gerät zuletzt aktiv war (von der Integration mitgeschrieben)
Etikett, Notiz	aus	eigene Angaben je Gerät, nur in Home Assistant gespeichert
Daten (7 Tage)	an	geschätzter Datenverbrauch mit Balken; nur sichtbar, wenn Messwerte vorliegen (seit 2.0.0)

Sortieren, filtern, suchen

Klick oder Enter auf eine Spaltenüberschrift sortiert nach dieser Spalte, ein zweiter Klick dreht die Richtung. IP-Adressen werden numerisch sortiert (192.168.178.9 vor 192.168.178.10). Startsortierung und -richtung stellst du im Editor ein (sort_by, sort_dir).

Die Karte startet standardmäßig mit dem Filter Aktiv. Mit default_filter wählst du einen anderen Startfilter (alle, aktiv, inaktiv, gast, gesperrt, update, fest, vpn). Ist der Button des Standardfilters ausgeblendet, fällt die Karte auf Alle zurück. Jeder Filterbutton ist einzeln ausblendbar (filter_alle, filter_aktiv, … filter_vpn, filter_neu, filter_lange_offline).

Filter	Zeigt
Alle / Aktiv / Inaktiv	alle, nur verbundene, nur nicht verbundene Geräte
Gast	Geräte im Gastnetz
Gesperrt	Geräte mit gesperrtem Internetzugang
Update	Geräte mit verfügbarem Firmware-Update
Feste IP	Geräte mit fester oder reservierter Adresse, aktive und inaktive
VPN	Geräte, die die Box als VPN kennzeichnet, und Einträge `VPN:<IP>` (seit 2.0.0)
Neu (7 Tage)	Geräte, die in den letzten 7 Tagen erstmals gesehen wurden
Lange offline	inaktive Geräte, die seit mindestens 30 Tagen nicht gesehen wurden

Suchfeld und Filterleiste arbeiten zusammen. Das Suchfeld durchsucht Name, IP, MAC, Modell, Hersteller und Home-Assistant-Namen. Enthält der Suchbegriff * oder ?, gilt er als Muster: 192.168.3.* findet alle Geräte dieses Teilnetzes, drucker* alle Namen, die mit „drucker“ beginnen.

Getrennte Geräte ausblenden (hide_inactive) gilt nur in den gemischten Ansichten. Seit 2.0.0 zeigen die Ansichten „Inaktiv“ und „Lange offline“ Offline-Geräte immer.

IP-Filter: das Netz auf mehrere Karten verteilen

Das Feld IP-Filter (ip_filter) bestimmt, welche Geräte die Karte überhaupt kennt. Mehrere Karten mit demselben Sensor und verschiedenen Filtern ergeben eine Aufteilung nach Bereichen. Filterleiste, Suchfeld, Zusammenfassung und Popup arbeiten innerhalb dieser Auswahl; die Zahlen zählen nur die Geräte der Karte.

Schreibweise	Bedeutung
`192.168.2.*`	alle Adressen mit diesem Anfang – `192.168.20.5` gehört nicht dazu
`192.168.1.1?`	`?` steht für genau ein Zeichen: `192.168.1.10` bis `192.168.1.19`
`192.168.2.* 192.168.3.*`	mehrere Muster, getrennt durch Leerzeichen, Komma oder Semikolon; ein Treffer genügt
`192.168.1.* !192.168.1.1`	ein `!` davor schließt aus: alles aus `192.168.1.*` außer der Box
`!192.168.1.*`	nur Ausschlüsse: alles außer diesem Bereich
(leer)	kein Filter, alle Geräte

type: custom:fritzbox-netzwerk-card
entity: sensor.fritz_box_netzwerk_gerate
title: Drucker
ip_filter: "192.168.2.*"

Der Filter arbeitet nur in der Karte. Sensoren, Geräte-Tracker und Zähler sehen weiterhin alle Geräte. Geräte ohne IP-Adresse erscheinen bei gesetztem Treffermuster nicht; bei einem reinen Ausschluss-Filter bleiben sie sichtbar.

Feste IP und Reservierungen

Der Filter Feste IP zeigt alle Geräte mit fester Adresse (aktive und inaktive). Mit default_filter: fest startet eine Karte gleich damit, ausblenden lässt sich der Knopf mit filter_fest: false.

Als fest erkennt die Integration Adressen, die am Gerät selbst fest eingestellt sind, und Reservierungen mit einer Adresse außerhalb des DHCP-Bereichs der Box. Reservierungen innerhalb des DHCP-Bereichs meldet die FRITZ!Box über TR-064 nicht; solche Geräte erscheinen als dynamisch. Drei Wege helfen:

Seit 2.0.0: Die Integration liest die Reservierungen zusätzlich aus der Weboberfläche der Box und zählt sie als fest. Das ist an keiner echten Box geprüft; der Diagnose-Download nennt unter reservations, was ankam.
Geräte im Popup von Hand als „reserviert“ markieren.
Viele auf einmal per Dienst mark_devices_reserved markieren (nur in Home Assistant, die Box bleibt unverändert; die Integration prüft nicht, ob die Reservierung wirklich besteht).

Funkband

Die Spalte Funkband (show_band) zeigt, in welchem WLAN-Band ein Gerät gerade verbunden ist; im Popup steht die Zeile unter Verbindung. Die Integration liest dazu je WLAN-Netz die Liste der verbundenen Geräte und ordnet sie über die MAC-Adresse zu. Das kostet je Netz einen Aufruf pro Abfrage; wer es nicht braucht, schaltet WLAN-Band je Gerät erfassen ab.

Nur Anzeige: Einem Gerät ein Band zuzuweisen, kann die FRITZ!Box nicht. Üblicher Weg: für die beiden Bänder getrennte WLAN-Namen vergeben. Ohne Angabe („—“) bleiben LAN-Geräte, Offline-Geräte und – ungeprüft – Geräte hinter einem Repeater. Seit 1.9.0 leitet die Integration das Band hinter Repeatern aus dem Namen der Mesh-Schnittstelle ab (z. B. AP:5G:0); das ist eine Annahme und an keiner echten Box geprüft.

Hersteller aus der MAC-Adresse

Die ersten drei Byte einer MAC-Adresse verraten den Hersteller der Netzwerkkarte. Die Integration bringt dafür eine lokale Liste mit (gut 38 000 Einträge); es wird nichts aus dem Internet nachgeladen, keine MAC-Adresse verlässt Home Assistant. Zu sehen ist der Hersteller in der Spalte Hersteller (show_vendor), im Popup unter der MAC-Adresse und als Suchbegriff.

Zufällige MAC-Adressen (iOS „Private WLAN-Adresse“, Android „Zufällige MAC“, Windows „Zufällige Hardwareadressen“) erkennt die Karte am „lokal verwalteten“ Bit (zweiter Hexwert 2, 6, A oder E) und zeigt „Zufällige MAC“ statt eines Herstellers.
Die mitgelieferte Liste enthält nur die großen IEEE-Blöcke (MA-L), Stand 30.11.2025. Der Hersteller nennt die Firma hinter der Netzwerkkarte, nicht unbedingt die Marke (viele Smart-Home-Geräte zeigen „Espressif“).
Liste aktualisieren (seit 1.7.0): Dienst update_oui oder Button „Herstellerliste aktualisieren“ laden MA-L, MA-M und MA-S von standards-oui.ieee.org und legen sie als oui_update.txt im Ordner fritzbox_netzwerk der Home-Assistant-Konfiguration ab; HACS-Updates überschreiben sie nicht.
Eigene Zuordnungen: Datei oui_custom.txt im selben Ordner, Zeilen PRÄFIX:Name mit 6, 7 oder 9 Hex-Zeichen. Vorrang: mitgelieferte Liste < aktualisierte Liste < eigene Zuordnungen. Wirkt nach einem Neustart oder nach update_oui.

MAC-Adresse kopieren

Ein Klick (oder Enter/Leertaste) auf die MAC-Adresse kopiert sie in die Zwischenablage; das Detail-Popup öffnet sich dabei nicht. Browser erlauben die moderne Zwischenablage nur bei HTTPS oder localhost; die Karte fällt sonst auf eine ältere Methode zurück. Wer lieber das Popup öffnen möchte, setzt mac_click_copies: false.

Steuerungsleiste und Einstellungen-Reiter

Der Editor-Schalter Steuerungsleiste anzeigen (show_controls) blendet Live-Werte für Download und Upload ein und – mit aktivierter FRITZ!Box-Steuerung – die Schalter für die WLAN-Bänder (2,4 GHz, 5 GHz, Gast) mit dem Button QR-Code, den MAC-Filter mit Button Pairing, die Buttons Neuverbinden (neue öffentliche IP) und Neustart sowie bei Repeatern die Mesh-Gruppe mit Alle neu starten. Mit Tabs ist das der Reiter Einstellungen.

Zwei-Klick-Bestätigung: Pairing, Neuverbinden, Neustart und Alle neu starten verlangen zwei Klicks. Der erste färbt den Button und fragt „Wirklich …?“, erst der zweite Klick innerhalb von 4 Sekunden löst aus. Das verhindert, dass ein versehentlicher Klick das WLAN öffnet, die Internetverbindung trennt oder Geräte neu startet.

Der Reiter Einstellungen enthält aufklappbare Bereiche (neu in 2.0.0):

Bereich	Inhalt
App-Version	installierte Version von Integration und Karte, neueste Version, Link zu den Release-Notizen; bei einer neueren Version orange hervorgehoben (offen)
FRITZ!Box	Modell, FRITZ!OS, IP-Adresse, Laufzeit sowie Temperatur, CPU- und RAM-Auslastung (nur mit der Option „CPU und RAM der Box lesen“, sonst ein Hinweis)
Internetverbindung	Status, externe IP, Online-Dauer, Raten, Maximaltempo
Heimnetz	Gerätezahlen und Mesh-Stand

Achtung: Die Laufzeit liest die Integration per TR-064 (DeviceInfo); sie ist an einer echten Box ungeprüft. Temperatur, CPU und RAM stammen aus der Weboberfläche und sind im Kapitel „Weitere Funktionen“ beschrieben.

Gast-WLAN: QR-Code

Gibt es einen Gast-WLAN-Schalter, erscheint in der Steuerungsleiste der Button QR-Code. Er öffnet ein Fenster mit Netzwerkname (SSID), Passwort (mit Kopierknopf) und einem QR-Code, den Besuch mit der Smartphone-Kamera scannen kann. Ist das Gast-WLAN gerade aus, erscheinen die Daten trotzdem, mit Hinweis. Bei einem offenen Gastnetz wird das so angezeigt, statt ein Passwort zu behaupten.

Datenschutz: Die Zugangsdaten werden nur bei Klick auf den Button abgerufen (Dienst gast_wlan_info) und erscheinen nirgends als Sensor-Attribut, landen also nie im Verlauf von Home Assistant. Den QR-Code erzeugt die in fritzconnection eingebaute Funktion (nutzt segno).

Der QR-Code setzt wie der Gast-Schalter ein separates Gast-WLAN voraus. Auf Boxen mit mehr als drei WLAN-Diensten wählt die Integration seit 1.9.0 den höchsten Dienst ab 3, der kein Frequenzband meldet (Annahme: das Gast-WLAN meldet keins). Seit 1.9.1 legt die Option Gast-WLAN-Dienst die Nummer fest (Automatisch oder 1–4). Der Diagnose-Download nennt unter wlan_service_bands, welches Band jeder Dienst meldet.

Version und Update-Hinweis

In den Einstellungen zeigt die Karte die installierte Version. Gibt es bei GitHub eine neuere, erscheint ein farbig hervorgehobener Hinweis mit Link zu den Release-Notizen. Die Prüfung läuft einmal täglich und ist abschaltbar; der Stand steht auch im Diagnose-Binärsensor Update verfügbar. Weicht die Version der Karte von der der Integration ab (alter Browser-Cache), erscheint ein roter Hinweis – dann Strg+F5. Ausblenden: show_version: false.

Etikett, Notiz und „reserviert“

Im Popup lassen sich je Gerät ein Etikett, eine Notiz und die Markierung „reserviert“ setzen (Stift-Symbol). Gespeichert wird nur in Home Assistant, die FRITZ!Box bleibt unverändert. Etikett und Notiz gibt es auch als Spalten (show_label, show_note) und in der Suche. Per Dienst: set_device_note.

Gruppieren, CSV-Export und gemerkte Ansicht

group_by gruppiert die Liste nach state, connection, vendor, band, subnet, label oder mesh (über welche Box bzw. welchen Repeater ein Gerät verbunden ist) mit einklappbaren Überschriften; das Auswahlfeld in der Filterleiste heißt show_group_select. Der CSV-Export (show_csv_export) speichert die sichtbare Liste; geht der Download nicht, landet die CSV in der Zwischenablage. Zellen, die mit =, +, - oder @ beginnen, werden entschärft, damit Tabellenprogramme sie nicht als Formel ausführen. Filter, Sortierung, Gruppierung und eingeklappte Gruppen merkt sich die Karte je Browser (remember_view).

Wischen und Blättern auf dem Smartphone

Passen nicht alle Spalten nebeneinander, wird die Tabelle waagerecht scrollbar. Mit dem Finger nach links und rechts wischen oder die Pfeile am Rand nutzen; jeder Klick blättert etwa eine halbe Kartenbreite weiter. Statuspunkt und Gerätename bleiben links stehen. Beides ist im Editor abschaltbar (show_scroll_arrows, sticky_name).

Feststehender Kopf, scrollbarer Datenbereich

Mit max_visible_rows (z. B. 15) scrollt nur der Datenbereich, während Titel, Auswahl und Tabellenüberschrift stehen bleiben. 0 zeigt alle Zeilen.

Ruhigeres Aktualisieren

Die Karte zeichnet die Liste höchstens alle 15 Sekunden neu (refresh_interval, 0 = sofort bei jeder Änderung), wartet, solange du scrollst oder die Maus über der Liste bewegst, und behält die Scrollposition.

IP-Adresse öffnet die Weboberfläche

Ein Klick auf die IP-Adresse öffnet die Weboberfläche des Geräts in einem neuen Tab. Bevorzugt wird die Adresse, die die FRITZ!Box selbst zum Gerät meldet; sonst wird http://<IP> versucht (abschaltbar mit ip_web_fallback: false). Es werden nur http- und https-Adressen geöffnet. Geräte ohne eigene Weboberfläche beantworten http://<IP> nicht; dann zeigt der Browser einen Fehler. Komplett ausschalten: ip_opens_web: false.

Detail-Popup

Ein Klick oder Enter auf eine Zeile öffnet ein Popup mit allen Angaben zum Gerät, auch den gerade ausgeblendeten Feldern. IP- und MAC-Adresse lassen sich dort kopieren. Je nach Gerät bietet es zusätzlich:

Gerätename umbenennen (Stift-Symbol, bis 64 Zeichen; Haken oder Enter speichert, Kreuz oder Escape verwirft). Geändert wird die Bezeichnung der FRITZ!Box, nicht der technische DNS-Hostname; Leerzeichen und Sonderzeichen sind erlaubt. Das Stift-Symbol erscheint nur, wenn die Box das Umbenennen für dieses Gerät erlaubt (name_writeable).
Weboberfläche öffnen, In Home Assistant öffnen (über die MAC-Adresse), Aufwecken (WoL) bei nicht verbundenen Geräten
Internet sperren/freigeben (experimentell)
Zugangsprofil (Kindersicherung, experimentell, mit show_parental: false ausblendbar)
Statische IP (experimentell, mit show_static_ip: false ausblendbar)
Anwesenheit: Zustand der zugehörigen device_tracker-Entität. Gibt es keinen nutzbaren Tracker, nennt die Zeile den Grund (nicht aktiviert, Entität deaktiviert oder „—“).
Daten (7 Tage), Daten heute mit Tagesverlauf (nur mit Datenverbrauchs-Erfassung)

Das Popup ist der Standard. Wer lieber direkt zur Home-Assistant-Geräteseite springen möchte, schaltet Klick öffnet ein Detail-Popup (show_details_popup) ab; dann greift Klick öffnet das Home-Assistant-Gerät (open_device_on_click).

Farben

Alle zwölf Farben (Kopf, Zeilen, Rahmen, aktiv, inaktiv, Gast, gesperrt, Update, fest, Akzent) und die Symbolfarben der Filterbuttons (color_cat_*) lassen sich im Abschnitt Farben des Editors setzen: als Hex, rgb(), hsl(), CSS-Farbname oder var(--…), oder über die Farbauswahl. Alle Farben zurücksetzen leert die Werte. Leer bedeutet: die Karte folgt dem aktiven Theme.

Sprache der Karte

Die Karte folgt der in Home Assistant eingestellten Sprache (Deutsch, Englisch, Niederländisch; sonst Rückfall auf Deutsch). Unabhängig davon lässt sie sich mit language: de | en | nl festlegen; leer bedeutet automatisch.

Beispiel-YAML

type: custom:fritzbox-netzwerk-card
entity: sensor.fritz_box_5690_pro_netzwerk_gerate
title: Heimnetz
show_title: true
show_tabs: true            # Reiter Netzwerk, Online-Monitor, Mesh, Einstellungen

# Spalten
show_status: true
show_name: true
show_ip: true
show_mac: true
show_connection: true
show_ha_name: true
show_ip_type: true
show_wan: true
show_update: true
show_speed: true
show_model: false
show_type: false
show_last_seen: false
show_vendor: false         # Hersteller zur MAC-Adresse
show_band: false           # Funkband (2,4 / 5 GHz)
show_traffic: true         # Daten (7 Tage), nur mit Messwerten sichtbar

# Darstellung
show_summary: true
show_search: true
show_filter: true
filter_vpn: true           # seit 2.0.0
default_filter: aktiv      # alle | aktiv | inaktiv | gast | gesperrt | update | fest | vpn
hide_inactive: false
ip_filter: ""              # z. B. "192.168.2.*"; ! schließt aus
group_by: ""               # state | connection | vendor | band | subnet | label | mesh
mac_click_copies: true
compact: false
max_visible_rows: 0        # 0 = alle; z. B. 15 = danach scrollen
refresh_interval: 15       # 0 = sofort bei jeder Änderung

# Sortierung
sort_by: ip
sort_dir: asc

# Farben (leer = Theme)
color_active: "#43a047"
color_blocked: "#db4437"

Anpassen: Ersetze sensor.fritz_box_5690_pro_netzwerk_gerate durch den Sensor mit der Geräteliste aus deiner Installation (der Name hängt vom Namen deiner FRITZ!Box und der Sprache ab) und 192.168.2.* durch dein Teilnetz.

Sicherheits- und Code-Hinweis: Verstehe und prüfe YAML, bevor du es übernimmst – auch wenn es von einer KI oder aus dem Netz stammt. Nach Home-Assistant-Updates können sich Optionen ändern (Breaking Changes). Öffne keine Ports ins Internet, nur um an die FRITZ!Box zu kommen, und lege Zugangsdaten nie in Dashboards oder YAML-Dateien ab.

← Einstellungen der Integration | Inhaltsübersicht | Online-Monitor und Datenverbrauch →