Planungswerkzeug für KNX-Installationen, entwickelt anhand echter ETS6-Projekte. Für Elektriker/Systemintegratoren, die mehrere Projekte parallel planen und dabei durchgängige Adressierungs- und Namenskonventionen einhalten wollen. Deckt den Weg von der ersten Raumplanung bis zur fertigen ETS6-Gruppenadressen-CSV, der Aktoren-Verdrahtungsliste (Abgangsliste), dem digitalen Funktions-/ Übergabe-Check vor Ort und der fertigen Kundendokumentation ab.
Kernablauf: Geschosse → Räume → Punkte (Licht / Steckdosen / Fenster / Heizung) → fertig. Zentral- und Allgemeinfunktionen (Datum/Uhrzeit, Wetterstation, "alle Lichter aus" je Geschoss usw.) werden automatisch aus Vorlagen erzeugt.
- Adressierung nach festem Schema — Hauptgruppe = Funktionskategorie,
Mittelgruppe = Zentral/je Geschoss, Untergruppe = Adressblock je Punkt,
mit reservierten
res-Plätzen für spätere Erweiterung. - Gebäudestruktur als Baum — Geschoss → Raum → Verteiler per Drag & Drop, optional mehrere KNX-Linien (z.B. je Wohnung) mit physikalischer Adressvergabe je Linie.
- ETS6-kompatibler CSV-Export/-Import, byte-genau gegen echte ETS6-Exporte geprüft.
- Abgangsliste — automatische Kanalzuordnung Aktor ↔ Funktion je Geschoss, plus CSV-/PDF-Export für die Schaltschrank-Verdrahtung.
- Geräteplanung, Pflichtenheft, digitale Checklisten und Klärungsliste — Stückliste, Leistungsbeschreibung, digitaler Funktions-/Übergabe-Check vor Ort (kein Papier), interne Rückfragenliste sowie eine Abschlussdokumentation am Ende, alle aus denselben Projektdaten.
- Globaler Gerätekatalog, mit Startkatalog gängiger KNX-Hersteller vorbelegt.
- Zeiterfassung je Projekt (optional) — Start/Stopp im Programmkopf, einstellbare Rundung, Abgerechnet-Markierung und Stundennachweis als PDF; rein intern, taucht in keinem Projekt-Export auf.
- Einzelbenutzer, keine Authentifizierung — für den Betrieb im eigenen
internen Netzwerk gedacht. Soll das Tool über eine Domain erreichbar
sein, gehört eine Zugriffskontrolle davor (VPN, oder ein Login via
Authelia vor einem Reverse Proxy — siehe
DEPLOYMENT.md), nie ungeschützt direkt ans Internet exponieren.
Eine vollständige Bedienungsanleitung (alle Tabs im Detail, Adressierungsmodell,
CSV-Format) ist direkt in der App verfügbar (Tab Hilfe) oder hier:
MANUAL.md.
Voraussetzungen: Docker mit Compose-Plugin, sowie git.
git clone https://github.com/seaspotter/knxpilot.git
cd knxpilot
docker compose pull
docker compose up -dDanach http://<host> öffnen (läuft auf Port 80, kein :8000 nötig).
Beim ersten Start sind Kategorien, Funktionstypen, Zentral-/ Allgemeinfunktions-Vorlagen sowie der Geräte-Katalog bereits mit sinnvollen Standardwerten vorbelegt.
MANUAL.md— vollständige Bedienungsanleitung (auch als Hilfe-Tab in der App)DEVELOPMENT.md— lokales Setup, Projektstruktur, Branch-WorkflowDEPLOYMENT.md— Persistenz, Self-Update-Mechanismus, Proxmox/LXC-BereitstellungCHANGELOG.md— Änderungen über die ZeitROADMAP.md— geplante/angedachte zukünftige Funktionen
GNU Affero General Public License v3.0 or later (AGPL-3.0-or-later) — siehe
LICENSE. Bewusst gewählt, weil dies ein Netzwerkdienst ist
(eine Webanwendung): AGPL schliesst die "SaaS-Lücke", die die einfache GPL
hat — betreibt jemand eine geänderte Version dieses Tools als gehosteten
Dienst, muss der geänderte Quellcode auch dessen Nutzern zur Verfügung
gestellt werden, nicht nur jenen, denen eine Kopie ausgehändigt wird.
Vor einer Veröffentlichung "the project author(s)" im Lizenz-Header am
Anfang von backend/main.py durch den tatsächlichen Namen bzw. die Firma
ersetzen.