Skip to content

About

Home Assistant add-on that turns your device registry into a documented inventory — serial numbers, photos, warranties, firmware. Built for insurance documentation, estate planning, and rental property management. One-click HA import, MQTT Discovery, Excel/PDF export with insurance preset. 5 languages. Free + Pro.

Topics

Resources

Stars

8 stars

Watchers

2 watching

Forks

Latest commit

 

History

189 Commits

Folders and files

Repository files navigation


Geraeteverwaltung

Smart Home Device Inventory for Home Assistant

Version Home Assistant License GitHub Stars Architectures

🇬🇧 English • 🇩🇪 Deutsch • 🇫🇷 Français • 🇪🇸 Español • 🇷🇺 Русский


Geräteverwaltung Dashboard — 530 devices, multiple integrations, breakdown by type, network and warranty status


What's new

v3.1 (October 2026) — Duplicates and a smarter import. Since HA 2026.8, Home Assistant often creates several entries for one device — a Shelly via its own integration and again via the FRITZ!Box. The import now merges these twins automatically, Settings → Possible duplicates lists the ones already imported, and Merge with another device … on the detail page handles the rest by hand. The auto-categorisation was reworked from the ground up: HA device classes never actually reached it before, so smoke detectors, plugs and TVs are now recognised properly, and routers (FRITZ!Box/UPnP) are no longer treated as parent devices. A new per-device field Wall switch bridged? and a new export template Emergency folder cover the fuse-box binder; exports can be sorted by floor › location › name and carry images in the PDF. The import now brings serial number, MAC address and power source along, and the device list shows a photo thumbnail. Devices published via MQTT get a Visit link on their HA device page that opens them directly in the app (needs MQTT; a dedicated HA user for the Mosquitto broker is only needed if the Supervisor does not supply the MQTT credentials — see the manual). Import Excel reads the add-on's own Excel export back in, matching columns by their heading, and either adds the devices or replaces the existing ones (snapshot first). Without a Pro license the Pro features are now actually locked — languages other than English, HA import and recategorization, Excel import/export and PDF export, camera, scanner and device photo, installation photos and documents, the handover fields, bulk edit and switching MQTT on — while existing photos, documents and entries stay visible and MQTT can still be switched off and cleaned up. Deleted devices now stay in the trash for 30 days and are then removed automatically (a snapshot is taken first); Empty trash clears it by hand, and Create snapshot now under Settings → Database snapshots takes a snapshot on demand.

v3.0 (September 2026) — Handover documentation. Three new per-device fields answer the question "what happens to this house when someone else takes over": Works without Home Assistant? (yes / no / unknown), a free-text note on how to operate it without HA, and an external link into another system — the invoice in Paperless-ngx, the manufacturer's manual page. A new export template Removal/electrician produces the list you hand to a tradesperson: location, wiring, power source, works-without-HA — deliberately without serial numbers or purchase data. All three export templates were re-cut to carry only what their reader actually needs.

v2.6 (May 2026) — Built-in user manual, MQTT-Discovery cleanup buttons (orphan + full purge), smarter Companion-app deep-link, "Parents only" filter to collapse multi-channel device families, dynamic category chips, consistent bulk-action bar, and an "Also apply to {count} sub-devices" toggle that propagates manufacturer/warranty/power-source from a parent device to its sub-channels.

v2.5 (April 2026) — Multi-channel device grouping via HA's via_device_id (Shelly 2PM and similar appear as one logical device with sub-channel children). Up to 20 attachment images per device for installation-location documentation. Per-device change history with field-level revert. Custom Excel/PDF export with built-in Insurance and Estate-planning presets, plus seven sort orders.

For the full list see addon/CHANGELOG.md. Bugs and feature requests via GitHub Issues.


Table of Contents

Language Sections
🇬🇧 English Why · Features · Installation · Quick Start · Pro License · Device Types · Technical Requirements
🇩🇪 Deutsch Warum · Funktionen · Installation · Schnellstart · Pro-Lizenz · Gerätetypen · Voraussetzungen
🇫🇷 Français Pourquoi · Fonctionnalités · Installation · Démarrage · Licence Pro · Appareils · Prérequis
🇪🇸 Español Por qué · Características · Instalación · Inicio rápido · Licencia Pro · Tipos · Requisitos
🇷🇺 Русский Зачем · Возможности · Установка · Быстрый старт · Лицензия Pro · Типы устройств · Требования

Technical (EN only): Architecture · Development · Contributing · License & Legal


🇬🇧 English

Why Geraeteverwaltung?

Most smart home users have dozens or even hundreds of devices spread across their home. Routers, sensors, smart plugs, cameras, thermostats, gateways -- and the list keeps growing. But where do you track serial numbers? Warranty dates? Which IP address belongs to which device? What firmware is running on that Zigbee sensor in the basement?

Geraeteverwaltung solves this. It gives you a single, searchable inventory of every device in your home -- directly inside Home Assistant.

Use Cases

  • Insurance documentation -- Maintain a complete inventory with serial numbers, purchase dates, and photos. If the worst happens, you have everything documented.
  • Warranty tracking -- Record purchase dates and warranty expiration for every device. Never miss a warranty claim again.
  • Maintenance overview -- Firmware versions, IP addresses, MAC addresses, network types, and integrations at a glance. No more hunting through router admin pages.
  • Rental property management -- Document equipment in rental units separately from your own home. Know exactly what belongs where when tenants move in or out.
  • Handover and estate planning -- Print the inventory with your own notes and leave it for whoever takes the system over: family, an electrician, a buyer. Each device records whether its basic function survives without Home Assistant, and the "Removal/electrician" export preset produces exactly that sheet -- location, network, power, and what stops working when the box comes off the wall.
  • Tax documentation -- Track business equipment with purchase dates and costs for tax reporting.
  • Quick setup with HA import -- Instead of manually entering 200+ devices, import your entire Home Assistant device registry with one click. Device types, manufacturers, and models are detected automatically.
  • Multi-device access -- View and edit your inventory from your phone, tablet, or desktop. Changes sync automatically within 30 seconds.
  • Offline capable -- Works without internet. Add devices in the basement with no Wi-Fi signal, and everything syncs when you are back online.

Features

Feature Free Pro
Device inventory (CRUD) 50 devices Unlimited
Offline-first PWA Yes Yes
HA Add-on with sidebar integration Yes Yes
Area & floor mapping Yes Yes
Dashboard with charts Yes Yes
Dark mode Yes Yes
JSON export Yes Yes
32 built-in device categories + custom categories Yes Yes
Network & power source tracking Yes Yes
Languages English DE, EN, ES, FR, RU
One-click HA device import -- Yes
Smart type detection from HA data -- Yes
Duplicate detection on import -- Yes
Excel import / export -- Yes
PDF export (insurance documentation) -- Yes
Camera capture with live preview -- Yes
QR / Barcode scanner with auto-fill -- Yes
Device photo, installation photos (up to 20 per device) and documents -- Yes
Bulk edit (type, integration, delete) -- Yes
MQTT Discovery (publish as HA entities) -- Yes
"Works without Home Assistant?" per device -- Yes
External link per device (invoice, manual) -- Yes
Export template Removal/electrician -- Yes
Merge duplicate devices (Possible duplicates, manual merge, self-import cleanup) Yes Yes
Trash with automatic cleanup after 30 days Yes Yes
Database snapshots (automatic and by hand) Yes Yes
"Wall switch bridged?" per device -- Yes
Export template Emergency folder, sort by floor/location, images in PDF -- Yes
"Visit" link from the HA device page back into the app (via MQTT) -- Yes

Installation

1. Add the repository

  1. Open Home Assistant
  2. Go to Settings > Apps (Add-ons in older versions) > Install app (bottom right) — the App store opens
  3. Click the three-dot menu (top right) > Repositories
  4. Add this URL:
    https://github.com/DerRegner-DE/ha-device-inventory
    
  5. Click Add and close the dialog

2. Install the add-on

  1. Search for Geraeteverwaltung in the App store (refresh if needed)
  2. Click Install
  3. Click Start
  4. Enable Show in sidebar (recommended)
  5. Click Open Web UI

3. Activate Pro (optional)

  1. Open the app and go to Settings
  2. Enter your license key
  3. Click Activate -- all Pro features unlock immediately

Quick Start

  1. Add your first device -- Tap the + button
  2. Choose a type -- Select from 32 categories (Router, Camera, Thermostat, etc.)
  3. Fill in the basics -- Name, model, manufacturer, serial number
  4. Set the location -- Pick a floor and area from your Home Assistant setup
  5. Add network details -- IP address, MAC address, network type, power source (section Network & Power); the integration is in the section Home Assistant
  6. Record warranty info -- Purchase date and warranty expiration
  7. Take a photo (Pro) -- Use the camera button for a live preview capture
  8. Scan a barcode (Pro) -- Capture serial numbers or product codes instantly

Import from Home Assistant (Pro)

Instead of entering devices manually, use the HA Import feature:

  1. Go to Settings > Home Assistant Import
  2. Click Import HA Devices
  3. The app imports your entire HA device registry -- manufacturers, models, and integrations are mapped automatically
  4. Review and enrich the imported devices with serial numbers, photos, and warranty dates

The import is safe to run repeatedly -- existing devices are detected and skipped automatically. A re-import fills serial number and MAC address into empty fields of existing devices. It only prevents new twins: devices that were already imported twice are not merged by a re-import -- use Settings → Possible duplicates for those.

Pro License

EUR 9.99 -- one-time purchase, no subscription.

Free Pro
Price Free EUR 9.99 (one-time)
Device limit 50 Unlimited
Languages EN DE, EN, ES, FR, RU
HA Import & recategorization -- Yes
Excel Import/Export & PDF Export -- Yes
Camera & QR Scanner -- Yes
Device photo, installation photos & documents -- Yes
Handover fields (works without HA, wall switch, external link) -- Yes
Bulk Edit -- Yes
MQTT Discovery -- Yes
Merge duplicates, self-import cleanup Yes Yes
Trash (30-day automatic cleanup) Yes Yes
Database snapshots Yes Yes

Without a license, existing photos, documents and handover entries stay visible, and MQTT can still be switched off and cleaned up.

Buy Pro License -- Instant delivery. Your license key will be included in the purchase confirmation email. You can activate it on up to 3 installations.

Supported Device Types

The app includes 32 predefined device categories with dedicated icons:

Router Repeater Powerline DECT Repeater
Outlet Light Switch Light Bulb Actuator/Relay
Switch/Button Shutter Thermostat Controller/Gateway
Camera Doorbell Chime Lock
Alarm System Voice Assistant Smart TV Streaming
Display/Dashboard Tablet Speaker Appliance
Robot Mower Irrigation Fan Remote Control
Printer Sensor Smartphone Other

Each device can also track:

  • Network type: WiFi, LAN, Zigbee, Z-Wave, Bluetooth, Thread/Matter, DECT, Powerline, HomeMatic RF, KNX, Modbus, 1-Wire, RS-232, EnOcean, USB
  • Power source: Power Adapter, 230V Mains, Battery, Rechargeable, USB, PoE, Solar, High Voltage
  • Integration: Fritz, Zigbee2MQTT, Tuya, LocalTuya, Bosch SHC, HomeMatic IP, Ring, Blink, Alexa, TP-Link, Tasmota, MQTT, and more

Technical Requirements

  • Home Assistant 2024.1 or newer
  • Architecture: amd64, aarch64 (e.g. Raspberry Pi 4/5), armv7
  • Browser: Any modern browser (Chrome, Firefox, Safari, Edge)
  • Storage: ~50 MB for the add-on + your device photos
  • HTTPS required for Camera and QR Scanner (works automatically with Nabu Casa; for local access, SSL certificate or localhost required)

🇩🇪 Deutsch

Warum Geräteverwaltung?

Die meisten Smart-Home-Nutzer haben Dutzende oder sogar Hunderte von Geräten im Haus verteilt. Router, Sensoren, Steckdosen, Kameras, Thermostate, Gateways -- und die Liste wächst stetig. Aber wo hält man Seriennummern fest? Garantiedaten? Welche IP-Adresse gehört zu welchem Gerät? Welche Firmware läuft auf dem Zigbee-Sensor im Keller?

Geräteverwaltung löst genau das. Eine einzige, durchsuchbare Inventarliste aller Geräte im Haus -- direkt in Home Assistant.

Anwendungsfälle

  • Versicherungsdokumentation -- Vollständige Inventarliste mit Seriennummern, Kaufdaten und Fotos. Im Schadensfall ist alles dokumentiert.
  • Garantieverfolgung -- Kaufdaten und Garantieablauf für jedes Gerät erfassen. Nie wieder eine Garantie verpassen.
  • Wartungsübersicht -- Firmware-Versionen, IP-Adressen, MAC-Adressen, Netzwerktypen und Integrationen auf einen Blick. Kein Suchen mehr in Router-Administrationsseiten.
  • Mietobjektverwaltung -- Geräte in Mietwohnungen getrennt vom eigenen Zuhause dokumentieren. Immer wissen, was wo gehört.
  • Übergabe und Nachlass -- Die Geräteliste mit eigenen Notizen ausdrucken und dem hinterlassen, der die Anlage später übernimmt: Angehörige, Elektriker, Käufer. Pro Gerät lässt sich festhalten, ob die Grundfunktion auch ohne Home Assistant erhalten bleibt; das Export-Preset „Rückbau/Elektriker" erzeugt genau dieses Blatt -- Standort, Netzwerk, Stromversorgung und was ausfällt, wenn das Gerät von der Wand kommt.
  • Steuerliche Erfassung -- Betriebliche Geräte mit Kaufdatum und Kosten für die Steuererklärung erfassen.
  • Schnell-Setup per HA-Import -- Statt 200+ Geräte manuell einzutragen, das gesamte Home-Assistant-Geräteregister per Klick importieren. Typen, Hersteller und Modelle werden automatisch erkannt.
  • Mehrgerätezugriff -- Inventar vom Handy, Tablet oder Desktop abrufen und bearbeiten. Änderungen werden innerhalb von 30 Sekunden synchronisiert.
  • Offline-fähig -- Funktioniert ohne Internet. Geräte im Keller ohne WLAN-Signal erfassen, Sync erfolgt automatisch wenn die Verbindung wiederhergestellt ist.

Funktionen

Funktion Free Pro
Geräteverwaltung (CRUD) 50 Geräte Unbegrenzt
Offline-first PWA Ja Ja
HA Add-on mit Seitenleiste Ja Ja
Bereichs- und Etagenzuordnung Ja Ja
Dashboard mit Diagrammen Ja Ja
Dark Mode Ja Ja
JSON-Export Ja Ja
32 integrierte Gerätekategorien + eigene Kategorien Ja Ja
Netzwerk- und Stromquellenerfassung Ja Ja
Sprachen Englisch DE, EN, ES, FR, RU
HA-Import per Klick -- Ja
Automatische Typerkennung -- Ja
Duplikaterkennung beim Import -- Ja
Excel-Import / -Export -- Ja
PDF-Export (Versicherungsdokumentation) -- Ja
Kameraaufnahme mit Live-Vorschau -- Ja
QR- / Barcode-Scanner mit Auto-Ausfüllen -- Ja
Gerätefoto, Einbauort-Bilder (bis zu 20 pro Gerät) und Dokumente -- Ja
Massenbearbeitung (Typ, Integration, Löschen) -- Ja
MQTT Discovery (als HA-Entities publizieren) -- Ja
„Funktioniert ohne Home Assistant?" pro Gerät -- Ja
Externer Link pro Gerät (Rechnung, Handbuch) -- Ja
Export-Vorlage Rückbau/Elektriker -- Ja
Doppelte Geräte zusammenführen (Liste „Mögliche Dubletten", von Hand, „Self-Imports aufräumen") Ja Ja
Papierkorb mit automatischem Leeren nach 30 Tagen Ja Ja
Datenbank-Schnappschüsse (automatisch und von Hand) Ja Ja
„Wandschalter überbrückt?" pro Gerät -- Ja
Export-Vorlage Notfallmappe, Sortierung nach Etage/Standort, Bilder im PDF -- Ja
„Besuchen"-Link von der HA-Geräteseite zurück in die App (über MQTT) -- Ja

Installation

1. Repository hinzufügen

  1. Home Assistant öffnen
  2. Einstellungen > Apps (in älteren Versionen Add-ons) > unten rechts App installieren — es öffnet sich der App-Store
  3. Drei-Punkte-Menü (oben rechts) > Repositories
  4. Diese URL einfügen:
    https://github.com/DerRegner-DE/ha-device-inventory
    
  5. Hinzufügen klicken und den Dialog schließen

2. Add-on installieren

  1. Im App-Store nach Geraeteverwaltung suchen (ggf. Seite neu laden)
  2. Installieren klicken
  3. Starten klicken
  4. In Seitenleiste anzeigen aktivieren (empfohlen)
  5. Benutzeroberfläche öffnen klicken

3. Pro aktivieren (optional)

  1. App öffnen und zu Einstellungen navigieren
  2. Lizenzschlüssel eingeben
  3. Aktivieren klicken -- alle Pro-Funktionen sind sofort freigeschaltet

Schnellstart

  1. Erstes Gerät hinzufügen -- Auf + tippen
  2. Typ wählen -- Aus 32 Kategorien auswählen (Router, Kamera, Thermostat, ...)
  3. Basisdaten eingeben -- Name, Modell, Hersteller, Seriennummer
  4. Standort festlegen -- Etage und Bereich aus der Home-Assistant-Konfiguration wählen
  5. Netzwerkdaten erfassen -- IP-Adresse, MAC-Adresse, Netzwerktyp, Stromversorgung (Abschnitt Netzwerk & Strom); die Integration steht im Abschnitt Home Assistant
  6. Garantieinfo eintragen -- Kaufdatum und Garantieablauf
  7. Foto aufnehmen (Pro) -- Kamera-Button für Live-Vorschau verwenden
  8. Barcode scannen (Pro) -- Seriennummern oder Produktcodes sofort erfassen

Import aus Home Assistant (Pro)

Statt Geräte manuell einzugeben, die HA-Import-Funktion nutzen:

  1. Einstellungen > Home Assistant Import
  2. HA-Geräte importieren klicken
  3. Die App importiert das gesamte HA-Geräteregister -- Hersteller, Modelle und Integrationen werden automatisch zugeordnet
  4. Importierte Geräte mit Seriennummern, Fotos und Garantiedaten anreichern

Der Import kann mehrfach ausgeführt werden -- vorhandene Geräte werden automatisch erkannt und übersprungen. Ein erneuter Import trägt Seriennummer und MAC-Adresse in leere Felder vorhandener Geräte nach. Er verhindert nur neue Zwillinge: Geräte, die schon doppelt importiert wurden, führt ein erneuter Import nicht zusammen -- dafür Einstellungen → Mögliche Dubletten nutzen.

Pro-Lizenz

9,99 EUR -- Einmalzahlung, kein Abo.

Free Pro
Preis Kostenlos 9,99 EUR (einmalig)
Gerätelimit 50 Unbegrenzt
Sprachen EN DE, EN, ES, FR, RU
HA-Import & Neu-Kategorisieren -- Ja
Excel-Import/-Export & PDF-Export -- Ja
Kamera & QR-Scanner -- Ja
Gerätefoto, Einbauort-Bilder & Dokumente -- Ja
Übergabe-Felder (ohne HA, Wandschalter, Externer Link) -- Ja
Massenbearbeitung -- Ja
MQTT Discovery -- Ja
Dubletten zusammenführen, Self-Imports aufräumen Ja Ja
Papierkorb (automatisches Leeren nach 30 Tagen) Ja Ja
Datenbank-Schnappschüsse Ja Ja

Ohne Lizenz bleiben vorhandene Fotos, Dokumente und Übergabe-Angaben sichtbar; MQTT lässt sich weiterhin ausschalten und aufräumen.

Pro-Lizenz kaufen -- Sofortige Auslieferung. Der Lizenzschlüssel ist in der Kaufbestätigungs-E-Mail enthalten. Auf bis zu 3 Installationen aktivierbar.

Unterstützte Gerätetypen

Die App enthält 32 vordefinierte Gerätekategorien mit eigenen Icons:

Router Repeater Powerline DECT Repeater
Steckdose Lichtschalter Leuchtmittel Aktor/Relais
Schalter/Taster Rollladen Thermostat Controller/Gateway
Kamera Türklingel Gong Schloss
Alarmanlage Sprachassistent Smart TV Streaming
Display/Dashboard Tablet Lautsprecher Haushaltsgerät
Mähroboter Bewässerung Ventilator Fernbedienung
Drucker Sensor Smartphone Sonstiges

Jedes Gerät kann zusätzlich erfassen:

  • Netzwerktyp: WLAN, LAN, Zigbee, Z-Wave, Bluetooth, Thread/Matter, DECT, Powerline, HomeMatic RF, KNX, Modbus, 1-Wire, RS-232, EnOcean, USB
  • Stromquelle: Netzteil, 230V, Batterie, Akku, USB, PoE, Solar, Starkstrom
  • Integration: Fritz, Zigbee2MQTT, Tuya, LocalTuya, Bosch SHC, HomeMatic IP, Ring, Blink, Alexa, TP-Link, Tasmota, MQTT und weitere

Technische Voraussetzungen

  • Home Assistant 2024.1 oder neuer
  • Architektur: amd64, aarch64 (z. B. Raspberry Pi 4/5), armv7
  • Browser: Jeder moderne Browser (Chrome, Firefox, Safari, Edge)
  • Speicher: ~50 MB für das Add-on + Gerätefotos
  • HTTPS erforderlich für Kamera und QR-Scanner (funktioniert automatisch mit Nabu Casa; für lokalen Zugriff: SSL-Zertifikat oder localhost)

🇫🇷 Français

Pourquoi Geräteverwaltung ?

La plupart des utilisateurs de maison connectée possèdent des dizaines, voire des centaines d'appareils répartis dans leur domicile. Routeurs, capteurs, prises intelligentes, caméras, thermostats, passerelles -- et la liste ne cesse de s'allonger. Mais où consigner les numéros de série ? Les dates de garantie ? Quelle adresse IP correspond à quel appareil ? Quelle version de firmware tourne sur le capteur Zigbee dans la cave ?

Geräteverwaltung résout tout cela. Un inventaire unique et consultable de tous vos appareils -- directement dans Home Assistant.

Cas d'utilisation

  • Documentation pour l'assurance -- Inventaire complet avec numéros de série, dates d'achat et photos. En cas de sinistre, tout est documenté.
  • Suivi des garanties -- Enregistrez les dates d'achat et d'expiration de garantie. Ne manquez plus jamais une réclamation.
  • Vue de maintenance -- Versions firmware, adresses IP, adresses MAC, types réseau et intégrations en un coup d'œil. Fini les recherches dans les pages d'administration du routeur.
  • Gestion locative -- Documentez les équipements des locations séparément de votre domicile. Sachez exactement ce qui appartient à quoi lors des entrées et sorties de locataires.
  • Documentation fiscale -- Suivez les équipements professionnels avec dates d'achat et coûts pour la déclaration d'impôts.
  • Configuration rapide via import HA -- Importez tout votre registre d'appareils Home Assistant en un clic. Types, fabricants et modèles sont détectés automatiquement.
  • Accès multi-appareils -- Consultez et modifiez votre inventaire depuis votre téléphone, tablette ou bureau. Les modifications se synchronisent en 30 secondes.
  • Hors ligne -- Fonctionne sans internet. Ajoutez des appareils dans la cave sans signal Wi-Fi, tout se synchronise automatiquement à la reconnexion.

Fonctionnalités

Fonctionnalité Gratuit Pro
Inventaire (CRUD) 50 appareils Illimité
PWA hors ligne Oui Oui
Add-on HA avec barre latérale Oui Oui
Zones et étages Oui Oui
Tableau de bord avec graphiques Oui Oui
Mode sombre Oui Oui
Export JSON Oui Oui
32 catégories d'appareils intégrées + catégories personnalisées Oui Oui
Suivi réseau et alimentation Oui Oui
Langues Anglais DE, EN, ES, FR, RU
Import HA en un clic -- Oui
Détection automatique du type -- Oui
Détection des doublons à l'import -- Oui
Import / export Excel -- Oui
Export PDF (assurance) -- Oui
Capture photo avec aperçu en direct -- Oui
Scanner QR / code-barres -- Oui
Photo de l'appareil, photos d'installation (jusqu'à 20 par appareil) et documents -- Oui
Édition en masse (type, intégration, suppression) -- Oui
MQTT Discovery (publier comme entités HA) -- Oui
« Fonctionne sans Home Assistant ? » par appareil -- Oui
Lien externe par appareil (facture, manuel) -- Oui
Modèle d'export Démontage/électricien -- Oui
Fusion des appareils en double (« Doublons possibles », fusion manuelle, nettoyage des auto-imports) Oui Oui
Corbeille avec vidage automatique après 30 jours Oui Oui
Instantanés de la base de données (automatiques et manuels) Oui Oui
« Interrupteur mural ponté ? » par appareil -- Oui
Modèle d'export Dossier d’urgence, tri par étage/emplacement, images dans le PDF -- Oui
Lien depuis la page appareil de HA vers l'application (via MQTT) -- Oui

Installation

1. Ajouter le dépôt

  1. Ouvrir Home Assistant
  2. Aller dans Paramètres > Applications (Modules complémentaires dans les anciennes versions) > Installer une application (en bas à droite) — le Magasin d'applications s'ouvre
  3. Menu trois points (en haut à droite) > Dépôts
  4. Ajouter cette URL :
    https://github.com/DerRegner-DE/ha-device-inventory
    
  5. Cliquer sur Ajouter et fermer

2. Installer le module

  1. Rechercher Geraeteverwaltung dans le Magasin d'applications (actualiser si nécessaire)
  2. Cliquer sur Installer
  3. Cliquer sur Démarrer
  4. Activer Afficher dans la barre latérale (recommandé)
  5. Cliquer sur Ouvrir l'interface utilisateur web

3. Activer Pro (optionnel)

  1. Ouvrir l'application et aller dans Paramètres
  2. Saisir votre clé de licence
  3. Cliquer sur Activer -- toutes les fonctions Pro sont immédiatement disponibles

Démarrage rapide

  1. Ajouter le premier appareil -- Appuyer sur +
  2. Choisir un type -- Parmi 32 catégories (Routeur, Caméra, Thermostat, etc.)
  3. Remplir les informations -- Nom, modèle, fabricant, numéro de série
  4. Définir l'emplacement -- Choisir un étage et une zone depuis Home Assistant
  5. Ajouter les détails réseau -- Adresse IP, adresse MAC, type réseau, alimentation (section Réseau & Alimentation) ; l'intégration se trouve dans la section Home Assistant
  6. Enregistrer la garantie -- Date d'achat et date d'expiration
  7. Prendre une photo (Pro) -- Utiliser le bouton caméra avec aperçu en direct
  8. Scanner un code-barres (Pro) -- Capturer les numéros de série instantanément

Import depuis Home Assistant (Pro)

Au lieu de saisir les appareils manuellement, utiliser la fonction Import HA :

  1. Aller dans Paramètres > Import Home Assistant
  2. Cliquer sur Importer appareils HA
  3. L'application importe tout votre registre d'appareils HA -- fabricants, modèles et intégrations sont mappés automatiquement
  4. Enrichir les appareils importés avec numéros de série, photos et dates de garantie

L'import peut être exécuté plusieurs fois -- les doublons sont détectés et ignorés automatiquement. Un nouvel import complète le numéro de série et l'adresse MAC dans les champs vides des appareils existants. Il évite seulement les nouveaux jumeaux : les appareils déjà importés en double ne sont pas fusionnés par un nouvel import -- utiliser pour cela Paramètres → Doublons possibles.

Licence Pro

9,99 EUR -- achat unique, sans abonnement.

Gratuit Pro
Prix Gratuit 9,99 EUR (unique)
Limite d'appareils 50 Illimité
Langues EN DE, EN, ES, FR, RU
Import HA & recatégorisation -- Oui
Import/export Excel & export PDF -- Oui
Caméra & Scanner QR -- Oui
Photo de l'appareil, photos d'installation & documents -- Oui
Champs de remise (sans HA, interrupteur mural, lien externe) -- Oui
Édition en masse -- Oui
MQTT Discovery -- Oui
Fusion des doublons, nettoyage des auto-imports Oui Oui
Corbeille (vidage automatique après 30 jours) Oui Oui
Instantanés de la base de données Oui Oui

Sans licence, les photos, documents et champs de remise existants restent visibles ; MQTT peut toujours être désactivé et nettoyé.

Acheter la licence Pro -- Livraison instantanée par e-mail. Activable sur 3 installations maximum.

Types d'appareils pris en charge

L'application comprend 32 catégories prédéfinies avec des icônes dédiées :

Routeur Répéteur CPL Répéteur DECT
Prise Interrupteur Ampoule Actionneur/Relais
Interrupteur/Bouton Volet roulant Thermostat Contrôleur/Passerelle
Caméra Sonnette Carillon Serrure
Système d'Alarme Assistant Vocal Smart TV Streaming
Écran/Dashboard Tablette Enceinte Électroménager
Robot Tondeuse Arrosage Ventilateur Télécommande
Imprimante Capteur Smartphone Autre

Chaque appareil peut également suivre :

  • Type réseau : WiFi, LAN, Zigbee, Z-Wave, Bluetooth, Thread/Matter, DECT, CPL, HomeMatic RF, KNX, Modbus, 1-Wire, RS-232, EnOcean, USB
  • Alimentation : Adaptateur, 230V, Pile, Batterie, USB, PoE, Solaire, Haute Tension
  • Intégration : Fritz, Zigbee2MQTT, Tuya, LocalTuya, Bosch SHC, HomeMatic IP, Ring, Blink, Alexa, TP-Link, Tasmota, MQTT et plus

Prérequis techniques

  • Home Assistant 2024.1 ou version ultérieure
  • Architecture : amd64, aarch64 (p. ex. Raspberry Pi 4/5), armv7
  • Navigateur : Tout navigateur moderne (Chrome, Firefox, Safari, Edge)
  • Stockage : ~50 Mo pour le module + photos des appareils
  • HTTPS requis pour la caméra et le scanner QR (automatique avec Nabu Casa ; en local : certificat SSL ou localhost)

🇪🇸 Español

¿Por qué Geräteverwaltung?

La mayoría de los usuarios de hogares inteligentes tienen docenas o incluso cientos de dispositivos repartidos por su casa. Routers, sensores, enchufes inteligentes, cámaras, termostatos, pasarelas -- y la lista sigue creciendo. ¿Pero dónde anotas los números de serie? ¿Las fechas de garantía? ¿Qué dirección IP pertenece a qué dispositivo? ¿Qué firmware tiene el sensor Zigbee del sótano?

Geräteverwaltung lo soluciona. Un inventario único y buscable de todos tus dispositivos -- directamente dentro de Home Assistant.

Casos de uso

  • Documentación para seguros -- Inventario completo con números de serie, fechas de compra y fotos. Si ocurre lo peor, todo está documentado.
  • Seguimiento de garantías -- Registra fechas de compra y vencimiento de garantía. Nunca pierdas una reclamación.
  • Vista de mantenimiento -- Versiones de firmware, direcciones IP, MAC, tipos de red e integraciones de un vistazo. Sin más búsquedas en páginas de administración del router.
  • Gestión de alquileres -- Documenta los equipos de propiedades de alquiler por separado. Sabe exactamente qué pertenece a dónde en entradas y salidas de inquilinos.
  • Documentación fiscal -- Registra equipos de negocio con fechas de compra y costes para la declaración de impuestos.
  • Configuración rápida con importación HA -- Importa todo tu registro de dispositivos de Home Assistant con un clic. Tipos, fabricantes y modelos se detectan automáticamente.
  • Acceso multidispositivo -- Consulta y edita tu inventario desde el móvil, tableta o escritorio. Los cambios se sincronizan en 30 segundos.
  • Sin conexión -- Funciona sin internet. Añade dispositivos en cualquier lugar y se sincronizan automáticamente al reconectarse.

Características

Característica Gratis Pro
Inventario (CRUD) 50 dispositivos Ilimitado
PWA sin conexión Sí Sí
Add-on HA con barra lateral Sí Sí
Zonas y plantas Sí Sí
Panel con gráficos Sí Sí
Modo oscuro Sí Sí
Exportación JSON Sí Sí
32 categorías de dispositivos integradas + categorías personalizadas Sí Sí
Seguimiento de red y fuente de alimentación Sí Sí
Idiomas Inglés DE, EN, ES, FR, RU
Importación HA con un clic -- Sí
Detección automática de tipo -- Sí
Detección de duplicados en la importación -- Sí
Importación / exportación Excel -- Sí
Exportación PDF (seguros) -- Sí
Captura de foto con vista previa en vivo -- Sí
Escáner QR / código de barras -- Sí
Foto del dispositivo, fotos de instalación (hasta 20 por dispositivo) y documentos -- Sí
Edición masiva (tipo, integración, eliminar) -- Sí
MQTT Discovery (publicar como entidades HA) -- Sí
«¿Funciona sin Home Assistant?» por dispositivo -- Sí
Enlace externo por dispositivo (factura, manual) -- Sí
Plantilla de exportación Desmontaje/electricista -- Sí
Fusionar dispositivos duplicados («Posibles duplicados», fusión manual, limpieza de autoimportaciones) Sí Sí
Papelera con vaciado automático a los 30 días Sí Sí
Instantáneas de la base de datos (automáticas y manuales) Sí Sí
«¿Interruptor de pared puenteado?» por dispositivo -- Sí
Plantilla de exportación Carpeta de emergencia, orden por planta/ubicación, imágenes en el PDF -- Sí
Enlace desde la página del dispositivo en HA de vuelta a la app (vía MQTT) -- Sí

Instalación

1. Añadir el repositorio

  1. Abrir Home Assistant
  2. Ir a Configuración > Aplicaciones (Complementos en versiones anteriores) > Instalar aplicación (abajo a la derecha) — se abre la Tienda de aplicaciones
  3. Menú de tres puntos (arriba a la derecha) > Repositorios
  4. Añadir esta URL:
    https://github.com/DerRegner-DE/ha-device-inventory
    
  5. Clicar Añadir y cerrar

2. Instalar el complemento

  1. Buscar Geraeteverwaltung en la Tienda de aplicaciones (actualizar si es necesario)
  2. Clicar Instalar
  3. Clicar Iniciar
  4. Activar Mostrar en el panel lateral (recomendado)
  5. Clicar Open Web UI

3. Activar Pro (opcional)

  1. Abrir la app e ir a Ajustes
  2. Introducir tu clave de licencia
  3. Clicar Activar -- todas las funciones Pro se desbloquean inmediatamente

Inicio rápido

  1. Añadir el primer dispositivo -- Pulsar +
  2. Elegir tipo -- Entre 32 categorías (Router, Cámara, Termostato, etc.)
  3. Rellenar datos básicos -- Nombre, modelo, fabricante, número de serie
  4. Establecer ubicación -- Seleccionar planta y zona desde Home Assistant
  5. Añadir datos de red -- Dirección IP, MAC, tipo de red, fuente de alimentación (sección Red y Energía); la integración está en la sección Home Assistant
  6. Registrar garantía -- Fecha de compra y vencimiento
  7. Tomar foto (Pro) -- Usar el botón de cámara con vista previa en vivo
  8. Escanear código de barras (Pro) -- Capturar números de serie al instante

Importar desde Home Assistant (Pro)

En lugar de introducir dispositivos manualmente, usar la función Importar de HA:

  1. Ir a Ajustes > Importar Home Assistant
  2. Clicar Importar dispositivos HA
  3. La app importa todo tu registro de dispositivos HA -- fabricantes, modelos e integraciones se mapean automáticamente
  4. Enriquecer los dispositivos importados con números de serie, fotos y fechas de garantía

La importación se puede ejecutar varias veces -- los duplicados se detectan y omiten automáticamente. Una nueva importación completa el número de serie y la dirección MAC en los campos vacíos de los dispositivos existentes. Solo evita gemelos nuevos: los dispositivos ya importados por duplicado no se fusionan con una nueva importación -- para ello, usar Ajustes → Posibles duplicados.

Licencia Pro

9,99 EUR -- pago único, sin suscripción.

Gratis Pro
Precio Gratis 9,99 EUR (único)
Límite de dispositivos 50 Ilimitado
Idiomas EN DE, EN, ES, FR, RU
Importación HA y recategorización -- Sí
Importación/exportación Excel y exportación PDF -- Sí
Cámara & Escáner QR -- Sí
Foto del dispositivo, fotos de instalación y documentos -- Sí
Campos de traspaso (sin HA, interruptor de pared, enlace externo) -- Sí
Edición masiva -- Sí
MQTT Discovery -- Sí
Fusionar duplicados, limpieza de autoimportaciones Sí Sí
Papelera (vaciado automático a los 30 días) Sí Sí
Instantáneas de la base de datos Sí Sí

Sin licencia, las fotos, los documentos y los campos de traspaso existentes siguen visibles; MQTT se puede seguir desactivando y limpiando.

Comprar licencia Pro -- Entrega instantánea por correo electrónico. Activable en hasta 3 instalaciones.

Tipos de dispositivos

La app incluye 32 categorías predefinidas con iconos dedicados:

Router Repetidor Powerline Repetidor DECT
Enchufe Interruptor Bombilla Actuador/Relé
Interruptor/Pulsador Persiana Termostato Controlador/Gateway
Cámara Timbre Campana Cerradura
Sistema de Alarma Asistente de Voz Smart TV Streaming
Pantalla/Dashboard Tablet Altavoz Electrodoméstico
Robot Cortacésped Riego Ventilador Mando a Distancia
Impresora Sensor Smartphone Otros

Cada dispositivo también puede registrar:

  • Tipo de red: WiFi, LAN, Zigbee, Z-Wave, Bluetooth, Thread/Matter, DECT, Powerline, HomeMatic RF, KNX, Modbus, 1-Wire, RS-232, EnOcean, USB
  • Fuente de alimentación: Adaptador, 230V, Batería, Recargable, USB, PoE, Solar, Alta Tensión
  • Integración: Fritz, Zigbee2MQTT, Tuya, LocalTuya, Bosch SHC, HomeMatic IP, Ring, Blink, Alexa, TP-Link, Tasmota, MQTT y más

Requisitos técnicos

  • Home Assistant 2024.1 o posterior
  • Arquitectura: amd64, aarch64 (p. ej. Raspberry Pi 4/5), armv7
  • Navegador: Cualquier navegador moderno (Chrome, Firefox, Safari, Edge)
  • Almacenamiento: ~50 MB para el complemento + fotos de dispositivos
  • HTTPS requerido para cámara y escáner QR (automático con Nabu Casa; en local: certificado SSL o localhost)

🇷🇺 Русский

Зачем нужен Geräteverwaltung?

У большинства пользователей умного дома десятки или сотни устройств по всему дому. Роутеры, датчики, умные розетки, камеры, термостаты, шлюзы -- и список постоянно растёт. Но где хранить серийные номера? Даты гарантии? Какой IP-адрес у какого устройства? Какая прошивка стоит на Zigbee-датчике в подвале?

Geräteverwaltung решает эту задачу. Единый, удобный для поиска инвентарный список всех устройств -- прямо внутри Home Assistant.

Варианты использования

  • Документация для страховки -- Полный инвентарь с серийными номерами, датами покупки и фотографиями. При страховом случае всё задокументировано.
  • Отслеживание гарантии -- Записывайте даты покупки и истечения гарантии. Больше никаких пропущенных гарантийных обращений.
  • Обзор обслуживания -- Версии прошивок, IP-адреса, MAC-адреса, типы сетей и интеграции -- всё с первого взгляда. Больше не нужно искать в настройках роутера.
  • Управление арендой -- Документируйте оборудование арендуемого жилья отдельно от своего дома. Всегда знайте, что где находится при заселении и выселении жильцов.
  • Налоговая документация -- Учёт рабочего оборудования с датами покупки и стоимостью для налоговой декларации.
  • Быстрая настройка через импорт HA -- Импортируйте весь реестр устройств Home Assistant одним нажатием. Типы, производители и модели определяются автоматически.
  • Доступ с нескольких устройств -- Просматривайте и редактируйте инвентарь с телефона, планшета или ПК. Изменения синхронизируются в течение 30 секунд.
  • Работа офлайн -- Работает без интернета. Добавляйте устройства где угодно, синхронизация произойдёт автоматически при восстановлении соединения.

Возможности

Функция Бесплатно Pro
Инвентаризация (CRUD) 50 устройств Без ограничений
PWA офлайн Да Да
Add-on HA с боковой панелью Да Да
Зоны и этажи Да Да
Панель управления с графиками Да Да
Тёмная тема Да Да
Экспорт JSON Да Да
32 встроенные категории устройств + собственные категории Да Да
Отслеживание сети и питания Да Да
Языки Английский DE, EN, ES, FR, RU
Импорт HA одним кликом -- Да
Автоопределение типа -- Да
Определение дублей при импорте -- Да
Импорт / экспорт Excel -- Да
Экспорт PDF (страхование) -- Да
Съёмка фото с предпросмотром -- Да
Сканер QR / штрихкода -- Да
Фото устройства, фото установки (до 20 на устройство) и документы -- Да
Массовое редактирование (тип, интеграция, удаление) -- Да
MQTT Discovery (публикация как сущности HA) -- Да
«Работает без Home Assistant?» для каждого устройства -- Да
Внешняя ссылка для устройства (счёт, руководство) -- Да
Шаблон экспорта Демонтаж/электрик -- Да
Объединение дублей устройств («Возможные дубликаты», вручную, очистка самоимпорта) Да Да
Корзина с автоматической очисткой через 30 дней Да Да
Снимки базы данных (автоматически и вручную) Да Да
«Настенный выключатель перемкнут?» для каждого устройства -- Да
Шаблон экспорта Аварийная папка, сортировка по этажу/месту, изображения в PDF -- Да
Ссылка со страницы устройства в HA обратно в приложение (через MQTT) -- Да

Установка

1. Добавить репозиторий

  1. Открыть Home Assistant
  2. Перейти в Настройки > Приложения (в старых версиях Дополнения) > Установить приложение (внизу справа) — откроется Магазин приложений
  3. Меню с тремя точками (вверху справа) > Репозитории
  4. Добавить этот URL:
    https://github.com/DerRegner-DE/ha-device-inventory
    
  5. Нажать Добавить и закрыть

2. Установить дополнение

  1. Найти Geraeteverwaltung в Магазине приложений (обновите страницу при необходимости)
  2. Нажать Установить
  3. Нажать Запустить
  4. Включить Показывать на боковой панели (рекомендуется)
  5. Нажать Открыть веб-интерфейс

3. Активировать Pro (по желанию)

  1. Открыть приложение и перейти в Настройки
  2. Ввести лицензионный ключ
  3. Нажать Активировать -- все Pro-функции разблокируются мгновенно

Быстрый старт

  1. Добавить первое устройство -- Нажать +
  2. Выбрать тип -- Из 32 категорий (Роутер, Камера, Термостат и др.)
  3. Заполнить основные данные -- Название, модель, производитель, серийный номер
  4. Указать расположение -- Выбрать этаж и зону из Home Assistant
  5. Добавить сетевые данные -- IP-адрес, MAC-адрес, тип сети, источник питания (раздел Сеть и Питание); интеграция находится в разделе Home Assistant
  6. Записать гарантию -- Дата покупки и истечения гарантии
  7. Сделать фото (Pro) -- Использовать кнопку камеры с предпросмотром
  8. Сканировать штрихкод (Pro) -- Мгновенный захват серийных номеров

Импорт из Home Assistant (Pro)

Вместо ручного ввода устройств использовать функцию Импорт из HA:

  1. Перейти в Настройки > Импорт Home Assistant
  2. Нажать Импортировать устройства HA
  3. Приложение импортирует весь реестр устройств HA -- производители, модели и интеграции сопоставляются автоматически
  4. Дополнить импортированные устройства серийными номерами, фотографиями и датами гарантии

Импорт можно запускать несколько раз -- дубли определяются и пропускаются автоматически. Повторный импорт дописывает серийный номер и MAC-адрес в пустые поля существующих устройств. Он лишь предотвращает новые дубли-близнецы: устройства, уже импортированные дважды, повторный импорт не объединяет -- для этого используйте Настройки → Возможные дубликаты.

Лицензия Pro

9,99 EUR -- единоразовая оплата, без подписки.

Бесплатно Pro
Цена Бесплатно 9,99 EUR (единоразово)
Лимит устройств 50 Без ограничений
Языки EN DE, EN, ES, FR, RU
Импорт HA и перекатегоризация -- Да
Импорт/экспорт Excel и экспорт PDF -- Да
Камера и сканер QR -- Да
Фото устройства, фото установки и документы -- Да
Поля передачи (без HA, настенный выключатель, внешняя ссылка) -- Да
Массовое редактирование -- Да
MQTT Discovery -- Да
Объединение дублей, очистка самоимпорта Да Да
Корзина (автоочистка через 30 дней) Да Да
Снимки базы данных Да Да

Без лицензии существующие фото, документы и поля передачи остаются видимыми; MQTT по-прежнему можно отключить и очистить.

Купить лицензию Pro -- Мгновенная доставка на e-mail. Активация на 3 установки.

Поддерживаемые типы устройств

Приложение включает 32 предустановленные категории с собственными иконками:

Роутер Репитер Powerline DECT репитер
Розетка Выключатель Лампочка Актуатор/Реле
Переключатель/Кнопка Роллеты Термостат Контроллер/Шлюз
Камера Дверной звонок Гонг Замок
Сигнализация Голосовой ассистент Smart TV Стриминг
Дисплей/Панель Планшет Колонка Бытовая техника
Робот-газонокосилка Полив Вентилятор Пульт управления
Принтер Датчик Смартфон Прочее

Каждое устройство может дополнительно отслеживать:

  • Тип сети: WiFi, LAN, Zigbee, Z-Wave, Bluetooth, Thread/Matter, DECT, Powerline, HomeMatic RF, KNX, Modbus, 1-Wire, RS-232, EnOcean, USB
  • Источник питания: Блок питания, 230В, Батарея, Аккумулятор, USB, PoE, Солнечная, Высокое напряжение
  • Интеграция: Fritz, Zigbee2MQTT, Tuya, LocalTuya, Bosch SHC, HomeMatic IP, Ring, Blink, Alexa, TP-Link, Tasmota, MQTT и другие

Технические требования

  • Home Assistant 2024.1 или новее
  • Архитектура: amd64, aarch64 (например, Raspberry Pi 4/5), armv7
  • Браузер: Любой современный браузер (Chrome, Firefox, Safari, Edge)
  • Хранилище: ~50 МБ для дополнения + фотографии устройств
  • Требуется HTTPS для камеры и сканера QR (автоматически с Nabu Casa; локально: SSL-сертификат или localhost)

Screenshots

Dashboard Geräteliste Einstellungen
Dashboard Geräte Settings
Neues Gerät Formular ausgefüllt Kamera
Form Filled Camera

Architecture

geraeteverwaltung/
  frontend/           Preact + TypeScript + Tailwind CSS 4 (PWA)
  backend/            FastAPI + SQLite + openpyxl + fpdf2
  addon/              Home Assistant Add-on (Docker: nginx + uvicorn)
  • Frontend: Preact, Dexie.js (IndexedDB), Tailwind CSS 4, html5-qrcode
  • Backend: FastAPI, SQLite, openpyxl (Excel), fpdf2 (PDF), aiohttp, aiomqtt
  • Add-on: Docker multi-stage build (Node.js build + Python runtime + nginx)
  • Sync: Offline-first with queue-based sync to backend

Development

Frontend

cd frontend
npm install
npm run dev          # Vite dev server on :5173
npm run build        # Production build to dist/

Backend

cd backend
pip install -r requirements.txt
uvicorn app.main:app --reload --port 3002

Docker (full stack)

docker build -f addon/Dockerfile -t geraeteverwaltung .
docker run -p 3001:3001 geraeteverwaltung

Contributing

Contributions are welcome!

  1. Fork the repository
  2. Create a feature branch (git checkout -b feature/my-feature)
  3. Make your changes and test locally with the Docker build
  4. Submit a pull request

Please open an issue first for larger changes to discuss the approach.


License & Legal

  • Source code: Source-available. See LICENSE for details.
  • Pro features: Require a commercial license key (EUR 9.99 one-time).
  • Free tier: Fully functional for up to 50 devices in English.

Geraeteverwaltung is not affiliated with or endorsed by Home Assistant or Nabu Casa.


Links


Made with care by DerRegner-DE

About

Home Assistant add-on that turns your device registry into a documented inventory — serial numbers, photos, warranties, firmware. Built for insurance documentation, estate planning, and rental property management. One-click HA import, MQTT Discovery, Excel/PDF export with insurance preset. 5 languages. Free + Pro.

Topics

Resources

Stars

8 stars

Watchers

2 watching

Forks

Releases

Packages

Contributors

Languages