UPnP / IGD Smart-Home-Integration, kostenlos und Open Source
Expose your internet box WAN link state and traffic counters over UPnP/IGD.
Veröffentlicht von callemand
- Geräte
- Version 1.0.0
- Erfordert Gladys >=4.84.0
- ★ 0
Die Dokumentation dieser Integration wird von ihrem Autor geschrieben und ist bisher nur auf Englisch verfügbar.
Overview
This integration connects Gladys Assistant to your internet box / router through the UPnP-IGD (Internet Gateway Device) protocol that almost every home box exposes on the local network. It turns your box into a Gladys device whose read-only features let you graph its traffic, chart your line and trigger scenes on the WAN link state (for example, be notified when your connection drops).
Discovery
The integration finds your box automatically using an SSDP network scan run by the Gladys core. Open the Gladys Discovery screen and your box appears — add it, and it starts reporting.
If auto-discovery finds nothing (some boxes disable UPnP, or the scan cannot
reach them), you can fill in the optional Box description URL setting with
your box's UPnP device description URL (something like
http://192.168.1.1:5000/rootDesc.xml) and run Discovery again.
Features
Each box exposes these read-only features:
- Connection status — whether the WAN link is up or down;
- External IP — your public internet IP address;
- Uptime — how long the internet connection has been up (seconds);
- Bytes sent / Bytes received — total traffic counters;
- Packets sent / Packets received — total packet counters.
Notes
- The byte and packet counters come straight from the box's IGD service. On many boxes these counters are 32-bit and wrap back to zero at ~4 GB — the raw value is reported as-is, so expect the graph to reset periodically on those boxes.
- Nothing is controllable: a box exposes only statistics over IGD, so every feature is read-only.
- UPnP/IGD must be enabled on your box (it usually is by default).
Konfigurationseinstellungen
Diese Einstellungen fragt UPnP / IGD in seinem Konfigurationsbildschirm in Gladys ab.
| Einstellung | Typ | Pflichtfeld | Beschreibung |
|---|---|---|---|
| Box description URL (optional) | string | Nein | Only needed if automatic discovery finds nothing: the UPnP device description URL of your box. |
So installierst du UPnP / IGD in Gladys
- Öffne in Gladys Integrationen: UPnP / IGD erscheint im Katalog neben den nativen Integrationen, mit einem Community-Badge.
- Klicke auf Installieren. Gladys lädt das Docker-Image (
ghcr.io/callemand/gladys-upnp-igd:1.0.0) herunter, startet es in einer vom Kern isolierten Sandbox und erzeugt die Oberfläche der Integration (Geräte, Erkennung und Konfiguration). - Öffne den Bildschirm Konfiguration der Integration, fülle die Einstellungen aus und speichere.
- Du kannst sie auch direkt über die URL ihres Repositorys installieren: https://github.com/callemand/gladys-upnp-igd.
UPnP / IGD benötigt Gladys >=4.84.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
UPnP / IGD 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 callemand 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