IDM Tools – Support-Werkzeuge für die IDM-Heatpump-Integration

idm_web_capture (Version 1.1.0)

Deutsch

Was macht dieses Tool? Es meldet sich mit Ihrer Web-PIN an der lokalen Weboberfläche Ihres IDM Navigators an und liest ausschließlich lesend alle bekannten Datenseiten der Navigator-2.0-HTTP-Oberfläche sowie alle Nur-Lese-Datenkanäle der WebSocket-Oberfläche des Navigator 10 / Pro aus. Das Ergebnis wird in eine ZIP-Datei mit einer manifest.json gepackt, die jeden Abruf mit HTTP-Status, Inhaltstyp und Weiterleitung dokumentiert. Eine solche ZIP hilft bei der Fehlersuche, wenn einzelne Web-Werte in Home Assistant nicht angezeigt werden – denn dann brauchen wir die unveränderten Rohseiten, die Ihr Gerät tatsächlich ausliefert.

Nur Lesezugriff: Das Tool enthält keine Schreibbefehle. Es kann keine Einstellung ändern, keine Uhrzeit setzen, nichts quittieren.
Keine Erschleichung höherer Ebenen: Es wird exakt die Zugriffsebene genutzt, die Ihre PIN ohnehin freigibt. Service-/Fachmann-Ebene wird nie berührt.
Die Web-PIN landet nicht in der Datei: Sie wird nur für den Login verwendet; die Login-Anfragen werden nicht mitgeschnitten, und ein letzter Prüfschritt ersetzt die PIN-Zeichenkette notfalls in jeder Datei (das würde im Manifest vermerkt).
Kein Datenabfluss: Das Tool baut nur Verbindungen zu dem von Ihnen angegebenen Gerät in Ihrem lokalen Netz auf. Kein Cloud-Dienst, keine Telemetrie, kein automatischer Versand.

English

What does this tool do? It logs into your Navigator’s local web interface using your web PIN and reads — strictly read-only — every known data page of the Navigator 2.0 HTTP interface and every read-only channel of the Navigator 10 / Pro WebSocket interface. The result is packed into a ZIP file with a manifest.json documenting every request with its HTTP status, content type and redirect. Such a ZIP helps diagnose missing web values in Home Assistant, because that diagnosis needs the raw pages your device actually serves.

Read-only: the tool contains no write commands; it cannot change any setting.
No elevation: it uses exactly the access level your PIN grants — service/technician levels are never touched.
Your PIN never enters the archive: login requests are not captured, and a final guard redacts the PIN string from every file if it ever appeared.
No data leaves your network: the tool only talks to the device you name. No cloud, no telemetry, no automatic upload.

Download

Windows (EXE, keine Installation) idm_web_capture.exe

SHA-256:
7daa8591f6153d51aa0f2d6860fe00ae4bc7b3580c70f59317ba427087cb3fb0

Windows / Linux / macOS (Python 3.9+) idm_web_capture.py

SHA-256:
d907e383a330987db1da2e8819d91553086548c3726178bd1e93600f253fceb4

Prüfen Sie den Hash nach dem Download (PowerShell: Get-FileHash .\idm_web_capture.exe, Linux/macOS: sha256sum idm_web_capture.py). Weitere Dateien: SHA256SUMS.txt · Defender-Scan-Auszug · Build-Nachweis & Reproduktionsanleitung. Derselbe Stand liegt zusätzlich als Release-Asset auf GitHub.

Bedienung / Usage

Windows

EXE herunterladen (z. B. in den Ordner Downloads).
Eingabeaufforderung öffnen (Windows-Taste → cmd) und starten:
%USERPROFILE%\Downloads\idm_web_capture.exe 192.168.178.50
(die IP ist die Ihres Navigators – dieselbe wie in der Integration)
Web-PIN eingeben (Eingabe bleibt unsichtbar – beabsichtigt).
Es entsteht idm_web_capture_<IP>_<Datum>.zip im aktuellen Ordner – bitte komplett an den GitHub-Issue anhängen.

Linux / macOS

python3 idm_web_capture.py 192.168.178.50 – danach wie oben.

Warum Windows beim Download warnt / Why Windows warns

Die EXE ist nicht code-signiert (Zertifikate kosten mehrere hundert Euro pro Jahr und sind für private Open-Source-Projekte nicht leistbar). Microsoft Edge und SmartScreen zeigen deshalb beim Download bzw. ersten Start einen Hinweis. Das betrifft jede unsignierte Datei, auch eine saubere. Weiter mit „Weitere Informationen“ → „Trotzdem ausführen“. Für volle Transparenz liegt alles Prüfbares offen:

Prüfung	Ergebnis
Windows Defender (lokal, Build 1.1.0)	„Scan finished … found no threats“ – Auszug
VirusTotal (≈70 Engines)	Bericht zur EXE – 4/71 Engines mit reinen ML-/Heuristik-Verdicts, wie sie für unsignierte PyInstaller-EXEs typisch sind (u. a. Microsoft „Wacatac.C!ml“ – der lokale Defender derselben Datei meldet: sauber). Alle großen Engines (Kaspersky, ESET, BitDefender, Avira, Sophos, McAfee, TrendMicro, ClamAV …) sind „Undetected“.
Nachbaubar	Die EXE entsteht mit einem Einzeiler aus dem offenen Quellcode – genaue Anleitung im Build-Nachweis. Niemand muss der Binärdatei vertrauen; jeder kann sie selbst bauen oder das Python-Skript verwenden.

Datenschutz / Privacy

Welche Daten werden gelesen?

Ausschließlich Daten, die die Weboberfläche Ihrer eigenen Wärmepumpe im lokalen Netzwerk ohnehin anzeigt: Temperaturen, Betriebszustände, Einstellwerte, Statistiken sowie technische Kennungen des Geräts (z. B. Firmware-Stand, Gerätetyp, ggf. Seriennummer/myIDM-Kennung). Die Web-PIN wird nicht ausgelesen oder gespeichert und gelangt nicht in die ZIP-Datei.

Wohin gehen die Daten?

Nirgendwo automatisch. Das Tool erstellt die ZIP-Datei nur lokal auf Ihrem Rechner. Sie entscheiden, ob und an wen Sie sie senden – üblicherweise als Anhang an einen GitHub-Issue des Projekts oder per E-Mail an den Betreuer. Beachten Sie: Ein GitHub-Issue ist öffentlich einsehbar; die ZIP enthält o. g. Betriebs- und Gerätedaten (aber nie Ihre PIN). Prüfen Sie den Inhalt im Zweifel vor dem Veröffentlichen – jede Datei ist Klartext (HTML/JSON).

Datenverarbeitung auf dieser Webseite

Diese Seite wird ohne Cookies, ohne Analyse-Tracker und ohne Einbettung Dritter ausgeliefert (einzig externe Links zu GitHub/VirusTotal verlassen diese Seite). Beim Aufruf verarbeitet der Webserver technisch notwendige Verbindungsdaten (IP-Adresse, Zeitpunkt) wie jeder Webserver; es werden keine Profile erstellt. Es gilt die Datenschutzerklärung von xerolux.de.

English

The tool only reads data your own heat pump’s web interface shows anyway (temperatures, operating states, settings, statistics, device identifiers). Your web PIN is never stored and never enters the archive. Nothing is uploaded automatically: the ZIP is created locally and you choose whether to attach it to a public GitHub issue or send it by e-mail. This website serves no cookies and includes no third-party trackers; see the xerolux.de privacy statement.

Haftungsausschluss / Disclaimer

Deutsch: Dieses Tool wird unentgeltlich im Rahmen des Open-Source-Projekts „IDM Heatpump für Home Assistant“ (MIT-Lizenz) bereitgestellt. Die Nutzung erfolgt auf eigene Gefahr. Es wird keine Garantie und keine Gewährleistung für Fehlerfreiheit, Verfügbarkeit oder Eignung für einen bestimmten Zweck übernommen. Die Haftung des Autors und Betreibers für direkte, indirekte oder Folgeschäden jedweder Art – einschließlich Datenverlust oder Geräteschäden – ist, soweit gesetzlich zulässig, ausgeschlossen. Das Tool ist ausschließlich für die beschriebene, nur lesende Diagnose bestimmter und greift nicht steuernd in die Anlage ein. Trotz sorgfältiger Prüfung wird für die Inhalte externer Links (GitHub, VirusTotal) keine Haftung übernommen; für deren Inhalte sind ausschließlich deren Betreiber verantwortlich. Maßgeblich sind zudem die Lizenz- und Nutzungsbedingungen des GitHub-Projekts.

English: This tool is provided free of charge as part of the open-source project “IDM Heatpump for Home Assistant” (MIT licence). Use is at your own risk; no warranty of any kind is given, express or implied. To the extent permitted by law, the author and operator accept no liability for any direct, indirect or consequential damage, including data loss or equipment damage. The tool is designed solely for the described read-only diagnostics and never controls the system. No responsibility is taken for the content of external links (GitHub, VirusTotal).