ViEventLog

Ein benutzerfreundlicher Web-Viewer zur Visualisierung und Analyse von Betriebszuständen und Events Ihrer Viessmann Heizungsanlage über die Viessmann Developer API.

Hintergrund

Mit der Abschaltung von ViGuide durch Viessmann verlieren Anlageneigentümer die bisherige Möglichkeit, das Event-Log ihrer Heizung einzusehen. ViEventLog bietet hier eine moderne Alternative und macht diese wichtigen Informationen wieder zugänglich.

Entwicklungshinweis: Dieses Projekt wurde mit Unterstützung von AI entwickelt und steht als Open-Source-Lösung für die Community zur Verfügung.

Tipp: Wenn Sie sich für Verbraucherschutz-Tools interessieren, schauen Sie sich auch mein Projekt RauchmelderApp.de an – eine kostenfreie Alternative zu teuren Ablesefirmen für die jährliche Rauchmelderwartung.

Screenshots

Event-Ansicht mit Timeline und Filterung

Umfassendes Dashboard mit Live-Daten

Multi-Account-Verwaltung mit Event-Archivierung und Temperatur-Logging

Vitocharge VX3 - PV und Batteriespeicher

SmartClimate - Raumsteuerung

SmartClimate - Thermostate

Vitovent Lüftung

Lizenz

Dieses Projekt ist unter der MIT-Lizenz lizenziert.

Wichtige Hinweise

Nur für private, nicht-kommerzielle Nutzung

Diese Anwendung verwendet die Viessmann Developer API und unterliegt den Nutzungsbedingungen des Viessmann Developer Portal. Die Nutzung ist ausschließlich für private, nicht-kommerzielle Zwecke und zur Steuerung eigener Viessmann-Anlagen gestattet.

Eigener Developer Portal Account erforderlich

Jeder Benutzer muss einen eigenen Account im Viessmann Developer Portal erstellen und seine eigenen API-Credentials verwenden. Die Weitergabe von API-Credentials an Dritte ist nicht gestattet.

Voraussetzungen

Viessmann Developer Portal Account erstellen

Bevor Sie den Event Viewer nutzen können, müssen Sie einen API-Client im Viessmann Developer Portal erstellen:

Anmelden beim Developer Portal
- Öffnen Sie https://app.developer.viessmann-climatesolutions.com
- Melden Sie sich mit Ihren ViCare App Zugangsdaten an (die gleichen Credentials, die Sie in der ViCare App verwenden), Sofern schon eine HomeAssitant integration verwendet wird, kann auch die ClientID von HomeAssitant verwendet werden.
API Client erstellen
- Klicken Sie auf "API-Client erstellen" oder "Create API Client"
- Geben Sie folgende Daten ein:
  - Name: EventViewer (oder ein beliebiger Name für Ihre Anwendung)
  - Google reCAPTCHA: Deaktiviert (disabled)
  - Redirect URIs: vicare://oauth-callback/everest
- Bestätigen Sie die Erstellung
Client ID notieren
- Nach der Erstellung wird Ihnen eine Client ID angezeigt
- Kopieren Sie diese Client ID - Sie benötigen sie für die Einrichtung des Event Viewers
- Die Client ID ist eine lange alphanumerische Zeichenfolge (z.B. ab741319e11245de5f91d15ff4cac2c1)

Systemanforderungen

Go 1.21 oder höher (für die Kompilierung)
Linux: libsecret / gnome-keyring für sichere Credential-Speicherung
macOS: Keychain (bereits vorhanden)
Windows: Credential Manager (bereits vorhanden)

Installation

Option 1: Binary herunterladen (empfohlen)

Schritt 1: Download

Besuchen Sie die Release-Seite und laden Sie die passende Version für Ihr Betriebssystem herunter:

Windows (64-bit): vieventlog_X.X.X_Windows_x86_64.zip
Windows (ARM64): vieventlog_X.X.X_Windows_arm64.zip
macOS (Intel): vieventlog_X.X.X_Darwin_x86_64.tar.gz
macOS (Apple Silicon): vieventlog_X.X.X_Darwin_arm64.tar.gz
Linux (64-bit): vieventlog_X.X.X_Linux_x86_64.tar.gz
Linux (ARM64): vieventlog_X.X.X_Linux_arm64.tar.gz

Schritt 2: Entpacken

Windows:

# Mit Windows Explorer: Rechtsklick auf die .zip Datei → "Alle extrahieren..."
# Oder mit PowerShell:
Expand-Archive vieventlog_X.X.X_Windows_x86_64.zip -DestinationPath vieventlog
cd vieventlog

macOS / Linux:

tar -xzf vieventlog_X.X.X_*.tar.gz
cd vieventlog_X.X.X_*

Schritt 3: Starten

Windows:

.\vieventlog.exe

macOS / Linux:

./vieventlog

macOS Hinweis: Bei der ersten Ausführung erscheint möglicherweise eine Sicherheitswarnung. Öffnen Sie in diesem Fall die Systemeinstellungen → Sicherheit → "Dennoch öffnen".

Schritt 4: Browser öffnen

Nach dem Start öffnen Sie Ihren Browser und navigieren zur angezeigten URL. Der Application zeigt die richtige URL beim Start an:

http://localhost:5000

macOS Hinweis zu Port 5000: macOS belegt standardmäßig Port 5000 mit dem AirPlay Receiver. Falls dieser aktiv ist, versucht ViEventLog automatisch Port 5001. Sie sehen beim Start die korrekte URL (z.B. http://localhost:5001). Falls Sie Port 5000 bevorzugen, können Sie AirPlay Receiver in den Systemeinstellungen deaktivieren.

Option 2: Aus Quellcode kompilieren

Mit Keyring-Support (empfohlen für Desktop):

go mod download
go build  # Baut mit Keyring-Support

Ohne Keyring (für Server/Container):

go mod download
go build -tags nokeyring  # Baut ohne Keyring, nutzt ENV/File-Storage

Nach erfolgreicher Kompilierung erhalten Sie eine ausführbare Datei vieventlog.

Hinweis: Die vorkompilierten Binaries von GitHub Releases verwenden keine Keyring-Integration (um Cross-Platform-Builds zu ermöglichen). Sie nutzen automatisch Environment Variables oder File-Storage für Credentials. Wenn Sie Keyring-Support benötigen, kompilieren Sie bitte lokal aus dem Quellcode.

Option 3: Docker Container (für Server/NAS)

Schnellstart mit Docker:

docker run -d \
  --name vieventlog \
  -p 5000:5000 \
  -e VICARE_EMAIL=ihre@email.de \
  -e VICARE_PASSWORD=ihr-passwort \
  -e VICARE_CLIENT_ID=ihre-client-id \
  -e BASIC_AUTH_USER=admin \
  -e BASIC_AUTH_PASSWORD=geheim123 \
  ghcr.io/mschneider82/vieventlog:latest

Mit docker-compose (empfohlen):

# docker-compose.yml erstellen (siehe Beispiel unten)
docker-compose up -d

Siehe Docker-Deployment für Details.

Verwendung

Erste Schritte

ViEventLog starten
```
./vieventlog
```
Browser öffnen

Öffnen Sie http://localhost:5000 in Ihrem Browser
Anmelden

Beim ersten Start werden Sie zur Login-Seite weitergeleitet. Geben Sie folgende Daten ein:
- E-Mail: Ihre ViCare App E-Mail-Adresse
- Passwort: Ihr ViCare App Passwort
- Client ID: Die Client ID aus dem Developer Portal (siehe Voraussetzungen)
Zugangsdaten werden gespeichert

Nach erfolgreicher Anmeldung werden Ihre Zugangsdaten sicher im System-Keyring gespeichert. Sie müssen sich beim nächsten Start nicht erneut anmelden.

Port ändern (optional)

Standardmäßig läuft ViEventLog auf Port 5000. Sie können einen anderen Port verwenden:

PORT=8080 ./vieventlog

macOS und AirPlay Receiver:

Falls Port 5000 durch den AirPlay Receiver belegt ist:

Automatisch: ViEventLog versucht automatisch Port 5001 als Fallback
Manuell: Mit PORT=8080 ./vieventlog einen anderen Port wählen
AirPlay deaktivieren: Systemeinstellungen → Allgemein → AirDrop und Handoff → "AirPlay Receiver" deaktivieren

Die beim Start angezeigte URL ist immer korrekt!

Docker-Deployment

Verfügbare Container-Images

Container-Images werden automatisch für linux/amd64 und linux/arm64 gebaut und sind verfügbar unter:

ghcr.io/mschneider82/vieventlog:latest
ghcr.io/mschneider82/vieventlog:v1.2.3  # Spezifische Version

Deployment-Optionen

1. Einzelner Account mit Environment Variables

Docker Run:

docker run -d \
  --name vieventlog \
  -p 5000:5000 \
  -e VICARE_EMAIL=ihre@email.de \
  -e VICARE_PASSWORD=ihr-passwort \
  -e VICARE_CLIENT_ID=ihre-client-id \
  -e VICARE_ACCOUNT_NAME="Mein Haus" \
  -e BASIC_AUTH_USER=admin \
  -e BASIC_AUTH_PASSWORD=geheim123 \
  --restart unless-stopped \
  ghcr.io/mschneider82/vieventlog:latest

docker-compose.yml:

version: '3.8'

services:
  vieventlog:
    image: ghcr.io/mschneider82/vieventlog:latest
    container_name: vieventlog
    ports:
      - "5000:5000"
    environment:
      - VICARE_EMAIL=ihre@email.de
      - VICARE_PASSWORD=ihr-passwort
      - VICARE_CLIENT_ID=ihre-client-id
      - VICARE_ACCOUNT_NAME=Mein Haus
      - BASIC_AUTH_USER=admin
      - BASIC_AUTH_PASSWORD=geheim123
    restart: unless-stopped

2. Multi-Account mit Config-File

docker-compose.yml:

version: '3.8'

services:
  vieventlog:
    image: ghcr.io/mschneider82/vieventlog:latest
    container_name: vieventlog
    ports:
      - "5000:5000"
    volumes:
      - ./config:/config
    environment:
      - VICARE_CONFIG_DIR=/config
      - BASIC_AUTH_USER=admin
      - BASIC_AUTH_PASSWORD=geheim123
    restart: unless-stopped

Config-File erstellen (./config/accounts.json):

{
  "accounts": {
    "user1@example.com": {
      "id": "user1@example.com",
      "name": "Haupthaus",
      "email": "user1@example.com",
      "password": "passwort1",
      "clientId": "client-id-1",
      "clientSecret": "8ad97aceb92c5892e102b093c7c083fa",
      "active": true
    },
    "user2@example.com": {
      "id": "user2@example.com",
      "name": "Ferienhaus",
      "email": "user2@example.com",
      "password": "passwort2",
      "clientId": "client-id-2",
      "clientSecret": "8ad97aceb92c5892e102b093c7c083fa",
      "active": true
    }
  }
}

Wichtig: Schützen Sie die accounts.json Datei:

chmod 600 ./config/accounts.json

3. Hinter Reverse Proxy (z.B. Nginx, Traefik)

Wenn Sie bereits einen Reverse Proxy mit Authentifizierung verwenden:

version: '3.8'

services:
  vieventlog:
    image: ghcr.io/mschneider82/vieventlog:latest
    container_name: vieventlog
    ports:
      - "127.0.0.1:5000:5000"  # Nur localhost
    environment:
      - VICARE_EMAIL=ihre@email.de
      - VICARE_PASSWORD=ihr-passwort
      - VICARE_CLIENT_ID=ihre-client-id
      # Kein BASIC_AUTH nötig - Reverse Proxy übernimmt
    restart: unless-stopped

Environment Variables (Container)

Variable	Beschreibung	Beispiel	Standard
`BIND_ADDRESS`	Bind-Adresse und Port	`0.0.0.0:5000`	`0.0.0.0:5000`
`VICARE_EMAIL`	ViCare Account E-Mail	`user@example.com`	-
`VICARE_PASSWORD`	ViCare Account Passwort	`geheim123`	-
`VICARE_CLIENT_ID`	Developer Portal Client ID	`ab741319...`	-
`VICARE_ACCOUNT_NAME`	Anzeigename für Account	`Mein Haus`	E-Mail
`VICARE_CONFIG_DIR`	Config-Verzeichnis für accounts.json	`/config`	`/config`
`VICARE_ACCOUNTS`	Multi-Account als JSON	`{"accounts":{...}}`	-
`BASIC_AUTH_USER`	Basic Auth Benutzername	`admin`	-
`BASIC_AUTH_PASSWORD`	Basic Auth Passwort	`geheim123`	-

Hinweis: Im Container wird kein System-Keyring verwendet. Credentials müssen über ENV-Vars oder Config-File bereitgestellt werden.

Sicherheitshinweise für Container

Basic Auth aktivieren: Wenn der Container aus dem Internet erreichbar ist:

environment:
  - BASIC_AUTH_USER=admin
  - BASIC_AUTH_PASSWORD=ein-sicheres-passwort

Secrets Management: Verwenden Sie Docker Secrets oder externe Secret-Manager:

services:
  vieventlog:
    secrets:
      - vicare_password
    environment:
      - VICARE_PASSWORD_FILE=/run/secrets/vicare_password

Config-File Permissions:

chmod 600 config/accounts.json
chown 1000:1000 config/accounts.json

Reverse Proxy verwenden: Für zusätzliche Sicherheit (TLS, Rate-Limiting, etc.)

Logs anzeigen

# Docker
docker logs vieventlog

# Docker Compose
docker-compose logs -f

Container aktualisieren

# Neues Image holen
docker pull ghcr.io/mschneider82/vieventlog:latest

# Container neu starten
docker-compose down && docker-compose up -d

Features

Multi-Account-Unterstützung

Der Event Viewer unterstützt mehrere Viessmann-Accounts gleichzeitig. Dies ist nützlich, wenn Sie mehrere Heizungsanlagen mit unterschiedlichen ViCare-Accounts verwalten.

Account-Verwaltung aufrufen:

Klicken Sie auf das Zahnrad-Symbol oben rechts in der Hauptansicht
Oder öffnen Sie direkt: http://localhost:5000/accounts

Funktionen:

Mehrere Accounts hinzufügen
Accounts aktivieren/deaktivieren
Accounts bearbeiten oder löschen
Events von allen aktiven Accounts werden kombiniert angezeigt
Jedes Event zeigt den zugehörigen Account und Standort

Event-Archivierung in SQLite

ViEventLog kann Events dauerhaft in einer SQLite-Datenbank speichern, um eine langfristige Historie zu bewahren:

Funktionen:

Automatische Speicherung aller Events in SQLite-Datenbank
Konfigurierbare Aufbewahrungsdauer (z.B. 90, 180, 365 Tage)
Intervall-basierte Synchronisation (z.B. alle 60 Minuten)
Automatische Bereinigung alter Events nach Ablauf der Aufbewahrungsfrist
Export-Funktion für archivierte Events
Vollständige API-Nutzung für Archivierung (keine Viessmann-API-Limits)

Aktivierung:

In der Account-Verwaltung kann die Event-Archivierung pro Account aktiviert werden
Konfiguration: Datenbankpfad, Aufbewahrungsdauer und Synchronisationsintervall

Temperatur-Logging und Visualisierung

Das Temperatur-Logging erfasst regelmäßig wichtige Sensordaten für historische Analysen:

Erfasste Daten:

Alle Temperatursensoren (Außen, Vorlauf, Rücklauf, Puffer, etc.)
Kompressor-Daten (Drehzahl, Leistung, Ein-/Auslasstemperatur)
Effizienz-Kennzahlen (SCOP/SPF)
Weitere Sensoren (Volumenstrom, Druck, etc.)

Funktionen:

Konfigurierbare Abtastrate (z.B. alle 5 Minuten)
SQLite-basierte Speicherung für minimalen Speicherplatzverbrauch
Grafische Visualisierung im Dashboard als Zeitreihen-Diagramme
Export-Funktion für historische Daten
Automatische Bereinigung alter Daten nach konfigurierbarer Zeit

Aktivierung:

In der Account-Verwaltung kann das Temperatur-Logging aktiviert werden
Anpassbare Sample-Intervalle und Aufbewahrungsdauer

Vitocharge VX3 - PV und Batteriespeicher

Vollständige Integration von Viessmann Vitocharge VX3 PV- und Batteriespeichersystemen:

Funktionen:

Live-Anzeige des Energieflusses (PV-Produktion, Netzeinspeisung/-bezug, Batterie-Ladung/-Entladung)
Energiebilanz mit Visualisierung der Stromflüsse
Batterie-Status (Ladestand, Leistung)
Wechselrichter-Informationen
PV-Produktionsstatistiken
Eigenverbrauchsoptimierung

Zugriff:

Über das Dashboard oder direkten Button in der Hauptansicht
Automatische Erkennung bei vorhandenem Vitocharge-System

SmartClimate - Raumsteuerung

Integration der Viessmann SmartClimate Raumsteuerung mit Thermostaten:

Funktionen:

Übersicht aller verbundenen Räume
Ist-Temperatur und Luftfeuchtigkeit pro Raum
Soll-Temperatur für Heizen und Kühlen
Steuerung der Raumtemperaturen über Thermostate
Visualisierung von Fußboden-Thermostaten
Anzeige der Verbindungsqualität (HKI - HomeKit Integration)
Raumsteuerung und weitere SmartClimate-Geräte

Zugriff:

Über den SmartClimate-Button im Dashboard
Automatische Erkennung bei vorhandenen SmartClimate-Geräten

Vitovent Lüftung

Dashboard für Viessmann Vitovent Lüftungsanlagen:

Anzeige:

Betriebsmodus (Auto-Sensor, Konstant, Programm, Sensor+Programm)
Schnellwahl-Modi (Intensivlüftung, Geräuschreduziert, Temperatur-Abschaltung)
Temperaturen (Zuluft, Abluft, Fortluft, Außentemperatur, Wärmerückgewinnung)
Luftfeuchte (Zuluft, Abluft, Fortluft, Außenluft)
Luftmenge (Zu- und Abluft in m³/h, aktuelles Level)
Ventilatoren (Zuluft-/Fortluft-Ventilator mit Drehzahl und Laufzeit)
Filter-Status (Verschmutzungsgrad, verbleibende/Betriebszeit)
Bypass-Information (Betriebsstunden, Arbeitsweise, Position, Temperaturen)

Steuerung:

Betriebsmodus ändern
Schnellwahl-Modi aktivieren/deaktivieren

Zugriff:

Über den Vitovent-Button im Dashboard
Automatische Erkennung bei vorhandener Vitovent-Anlage

Dashboard-Ansicht

Das Dashboard bietet eine übersichtliche Echtzeitansicht aller wichtigen Parameter Ihrer Heizungsanlage:

Anzeige und Überwachung

Live-Anzeige von Temperaturen: Außentemperatur, Vorlauf, Rücklauf, Puffer, Primär- und Sekundärkreis
Kompressor-Status bei Wärmepumpen: Drehzahl, Leistung, Ein-/Auslasstemperatur
Brenner-Status bei Gasheizungen: Modulation, Betriebszustand
Warmwasser-Informationen: Ist- und Soll-Temperatur, Betriebsmodus, Hysterese
Heizkreis-Status: Betriebsmodus, Betriebsprogramm, Heizkurve
Zusätzliche Sensoren: Volumenstrom, Druck, interne Pumpe, Lüfter
Effizienz-Kennzahlen: SCOP/SPF für Heizung und Warmwasser
Unterstützung mehrerer Geräte pro Installation (z.B. Wärmepumpe + Gasheizung)
Automatische Anpassung der Anzeige je nach Gerätetyp (Vitocal, Vitodens, etc.)

Interaktive Steuerung (nur Wärmepumpen)

Warmwasser-Steuerung:

Betriebsart ändern: Eco, Komfort oder Aus
Soll-Temperatur einstellen: 10-60°C in 1°C Schritten
Hysterese Ein: 1-10K in 0,5K Schritten
Hysterese Aus: 0-2,5K in 0,5K Schritten
Einmalige Warmwassererwärmung starten: Einmaliges Aufheizen per Knopfdruck

Heizkreis-Steuerung:

Betriebsart ändern: Heizen oder Standby
Heizkurve anpassen:
- Steigung: 0,2-3,5 in 0,1er Schritten
- Niveau: -13 bis +40 in 1er Schritten
Vorlauftemperaturbegrenzung: 10-70°C in 1°C Schritten

Alle Änderungen werden sofort an die Viessmann API übermittelt und das Dashboard aktualisiert sich nach 2 Sekunden automatisch, um die neuen Werte anzuzeigen.

Das Dashboard ist über den entsprechenden Button in der Hauptansicht erreichbar und aktualisiert sich automatisch.

Timeline-Visualisierung

Die Timeline zeigt grafisch die Betriebszustände Ihrer Heizungsanlage über die Zeit:

Farbcodierte Zustände: Heizen, Warmwasser, Vorlauf, Nachlauf, Aus
Anzeige von Dauer und Start-/Ende-Zeiten
Berücksichtigung von Ventilstellungen (Heizen vs. Warmwasser-Bereitung)

Event-Liste mit Filterung

Chronologische Sortierung (neueste zuerst)
Filterung nach Installation/Gerät
Filterung nach Event-Typ (Status-Codes/Fehler-Codes/Aktive Events)
Freitext-Suche über alle Event-Felder
Zeitraum-Filter: 24 Stunden bis alle Events

Deutsche Error-Code-Übersetzung

Automatische Übersetzung von Viessmann Status- und Fehler-Codes:

S-Codes (Status): Betriebszustände wie "Heizen", "Warmwasser-Bereitung", "Abtauung"
F-Codes (Fehler): Störungen wie Sensorfehler, Druckprobleme
Automatische Kategorisierung und Schweregrad-Erkennung

Sichere Credential-Speicherung

Ihre Zugangsdaten werden sicher im System-Keyring gespeichert, nicht auf der Festplatte:

Linux: libsecret / gnome-keyring
macOS: Keychain
Windows: Credential Manager

Event-Caching und Performance

Events werden 5 Minuten gecacht für schnellere Ladezeiten
Thread-safe Implementierung mit Mutex-Synchronisation
OAuth2 Token werden pro Account gecacht
Automatisches Token-Refresh

API Endpoints

Hauptseiten

GET / - Web UI (Event-Viewer)
GET /login - Login-Seite
GET /accounts - Account-Verwaltung
GET /dashboard - Dashboard-Ansicht mit Live-Daten

API

Events und Status

GET /api/events?days=7 - Events abrufen (Parameter: 1, 7, 14, 30 oder 365 für "Alle")
GET /api/status - Verbindungsstatus und Account-Info
GET /api/devices - Geräteliste gruppiert nach Installation
GET /api/features?installationId=XXX&gatewaySerial=YYY&deviceId=0&refresh=true - Feature-Daten für Dashboard

Account-Verwaltung

GET /api/accounts - Liste aller gespeicherten Accounts

POST /api/accounts/add - Account hinzufügen

{
  "name": "Haupthaus",
  "email": "ihre@email.de",
  "password": "ihr-passwort",
  "clientId": "ihre-client-id",
  "active": true
}

POST /api/accounts/toggle - Account aktivieren/deaktivieren
```
{
  "id": "account-id",
  "active": true
}
```
POST /api/accounts/delete - Account löschen
```
{
  "id": "account-id"
}
```

Login

POST /api/login - Anmeldung mit Viessmann-Credentials

{
  "email": "ihre@email.de",
  "password": "ihr-passwort",
  "clientId": "ihre-client-id"
}

GET /api/credentials/check - Prüft, ob gespeicherte Credentials vorhanden sind

Gerätesteuerung

Warmwasser (DHW) Steuerung:

POST /api/dhw/mode/set - Betriebsart ändern

{
  "accountId": "account-id",
  "installationId": "installation-id",
  "gatewaySerial": "gateway-serial",
  "deviceId": "0",
  "mode": "efficient"
}

Gültige Modi: efficient (Eco), efficientWithMinComfort (Komfort), balanced (Balanced), off (Aus)

POST /api/dhw/temperature/set - Soll-Temperatur setzen

{
  "accountId": "account-id",
  "installationId": "installation-id",
  "gatewaySerial": "gateway-serial",
  "deviceId": "0",
  "temperature": 50
}

POST /api/dhw/hysteresis/set - Hysterese Ein/Aus setzen

{
  "accountId": "account-id",
  "installationId": "installation-id",
  "gatewaySerial": "gateway-serial",
  "deviceId": "0",
  "type": "switchOn",
  "value": 5.0
}

Typ: switchOn (Ein) oder switchOff (Aus)

POST /api/dhw/oneTimeCharge/activate - Einmalige Warmwassererwärmung starten

{
  "accountId": "account-id",
  "installationId": "installation-id",
  "gatewaySerial": "gateway-serial",
  "deviceId": "0"
}

Heizkreis-Steuerung:

POST /api/heating/mode/set - Betriebsart ändern

{
  "accountId": "account-id",
  "installationId": "installation-id",
  "gatewaySerial": "gateway-serial",
  "deviceId": "0",
  "circuit": 0,
  "mode": "heating"
}

Gültige Modi: heating (Heizen), standby (Standby)

POST /api/heating/curve/set - Heizkurve anpassen

{
  "accountId": "account-id",
  "installationId": "installation-id",
  "gatewaySerial": "gateway-serial",
  "deviceId": "0",
  "circuit": 0,
  "slope": 1.2,
  "shift": 5
}

POST /api/heating/supplyTempMax/set - Vorlauftemperaturbegrenzung setzen

{
  "accountId": "account-id",
  "installationId": "installation-id",
  "gatewaySerial": "gateway-serial",
  "deviceId": "0",
  "circuit": 0,
  "temperature": 55
}

Alle Steuerungs-Endpoints invalidieren automatisch den Feature-Cache und geben bei Erfolg {"success": true} zurück.

Technische Details

Architektur

Backend: Go mit integriertem HTTP-Server
Frontend: Vanilla JavaScript, keine externen Frameworks
Templates: Embedded HTML-Templates (keine externen Dateien erforderlich)
Storage: System-Keyring für Credentials, Memory-Cache für Events und Tokens

Dependencies

Go Standard Library
System-Keyring Libraries (plattformabhängig)

Build-Eigenschaften

Standalone Binary ohne externe Abhängigkeiten zur Laufzeit
Alle Templates sind im Binary eingebettet
Geringer Memory-Footprint
Schnelle Startzeit

Troubleshooting

Login schlägt fehl

Überprüfen Sie Ihre ViCare App Zugangsdaten
Stellen Sie sicher, dass die Client ID korrekt aus dem Developer Portal kopiert wurde
Prüfen Sie, ob die Redirect URI im Developer Portal korrekt konfiguriert ist: vicare://oauth-callback/everest

Events werden nicht angezeigt

Überprüfen Sie, ob mindestens ein Account aktiviert ist (Account-Verwaltung)
Stellen Sie sicher, dass Ihre Viessmann-Anlage Events generiert hat
Prüfen Sie den Zeitraum-Filter (Standard: "Alle")

Keyring-Fehler unter Linux

Falls der Keyring nicht verfügbar ist, installieren Sie:

# Debian/Ubuntu
sudo apt-get install gnome-keyring libsecret-1-0

# Fedora/RHEL
sudo dnf install gnome-keyring libsecret

Container startet nicht / keine Credentials

Problem: Container läuft, aber zeigt "no credentials configured"

Lösung:

Prüfen Sie die Environment Variables mit docker inspect vieventlog
Stellen Sie sicher, dass mindestens VICARE_EMAIL, VICARE_PASSWORD und VICARE_CLIENT_ID gesetzt sind
Logs prüfen: docker logs vieventlog

Problem: "Authentication failed" beim Start

Lösung:

Verifizieren Sie Ihre Credentials in der ViCare App
Prüfen Sie die Client ID im Developer Portal
Stellen Sie sicher, dass die Redirect URI korrekt ist: vicare://oauth-callback/everest

Container-Image nicht gefunden

Stellen Sie sicher, dass Sie den korrekten Image-Namen verwenden:

# Richtig
docker pull ghcr.io/mschneider82/vieventlog:latest

# Falsch (ohne ghcr.io)
docker pull mschneider82/vieventlog:latest

Entwicklung

Tests ausführen

go test -v ./...

Code formatieren

go fmt ./...
go vet ./...

Dependencies aktualisieren

go mod tidy

Beiträge

Contributions sind willkommen! Bitte beachten Sie:

Code sollte den Go-Konventionen folgen (go fmt, go vet)
Neue Features sollten dokumentiert werden
Bug-Reports mit reproduzierbaren Schritten sind hilfreich

Support

Hinweis: Diese Software wurde größtenteils mit AI-Unterstützung entwickelt.

Bei Fragen, Problemen oder Anregungen öffnen Sie bitte ein Issue auf GitHub. Wir freuen uns über Bug-Reports und Feature-Vorschläge!

Danksagung

Die Kältekreislauf-Visualisierung im Dashboard verwendet Grafiken aus dem Projekt iob.vis.vitocal250 von MyHomeMyData. Vielen Dank für die ausgezeichnete Visualisierung des Viessmann Wärmepumpen-Kältekreislaufs!

Haftungsausschluss

Diese Software wird "wie besehen" ohne jegliche Garantie bereitgestellt. Die Nutzung erfolgt auf eigenes Risiko. Der Autor übernimmt keine Haftung für Schäden, die durch die Nutzung dieser Software entstehen.

Diese Software ist nicht offiziell von Viessmann unterstützt. Sie verwendet die öffentliche Viessmann Developer API gemäß den Nutzungsbedingungen.

Name		Name	Last commit message	Last commit date
Latest commit History 252 Commits
.github		.github
charts/vieventlog		charts/vieventlog
static		static
templates		templates
.dockerignore		.dockerignore
.gitignore		.gitignore
.goreleaser.yaml		.goreleaser.yaml
Dockerfile		Dockerfile
LICENSE		LICENSE
README.md		README.md
auth.go		auth.go
auth_middleware.go		auth_middleware.go
credentials.go		credentials.go
credentials_keyring.go		credentials_keyring.go
credentials_simple.go		credentials_simple.go
db.go		db.go
docker-compose.yml		docker-compose.yml
error_codes.go		error_codes.go
event_scheduler.go		event_scheduler.go
go.mod		go.mod
go.sum		go.sum
handlers.go		handlers.go
handlers_api.go		handlers_api.go
handlers_devices.go		handlers_devices.go
handlers_event_archive.go		handlers_event_archive.go
handlers_rooms.go		handlers_rooms.go
handlers_smartclimate.go		handlers_smartclimate.go
handlers_temperature_log.go		handlers_temperature_log.go
handlers_vitovent.go		handlers_vitovent.go
main.go		main.go
screenshot_accounts.png		screenshot_accounts.png
screenshot_dashboard.jpg		screenshot_dashboard.jpg
screenshot_events.png		screenshot_events.png
screenshot_lueftung.png		screenshot_lueftung.png
screenshot_smartclimate1.png		screenshot_smartclimate1.png
screenshot_smartclimate2.png		screenshot_smartclimate2.png
screenshot_vitocharge.png		screenshot_vitocharge.png
temperature_scheduler.go		temperature_scheduler.go
types.go		types.go
utils.go		utils.go
vicare_auth.go		vicare_auth.go
viessmann_api.go		viessmann_api.go

Uh oh!

License

mschneider82/vieventlog

Folders and files

Latest commit

History

Repository files navigation

ViEventLog

Hintergrund

Screenshots

Event-Ansicht mit Timeline und Filterung

Umfassendes Dashboard mit Live-Daten

Multi-Account-Verwaltung mit Event-Archivierung und Temperatur-Logging

Vitocharge VX3 - PV und Batteriespeicher

SmartClimate - Raumsteuerung

SmartClimate - Thermostate

Vitovent Lüftung

Lizenz

Wichtige Hinweise

Voraussetzungen

Viessmann Developer Portal Account erstellen

Systemanforderungen

Installation

Option 1: Binary herunterladen (empfohlen)

Option 2: Aus Quellcode kompilieren

Option 3: Docker Container (für Server/NAS)

Verwendung

Erste Schritte

Port ändern (optional)

Docker-Deployment

Verfügbare Container-Images

Deployment-Optionen

1. Einzelner Account mit Environment Variables

2. Multi-Account mit Config-File

3. Hinter Reverse Proxy (z.B. Nginx, Traefik)

Environment Variables (Container)

Sicherheitshinweise für Container

Logs anzeigen

Container aktualisieren

Features

Multi-Account-Unterstützung

Event-Archivierung in SQLite

Temperatur-Logging und Visualisierung

Vitocharge VX3 - PV und Batteriespeicher

SmartClimate - Raumsteuerung

Vitovent Lüftung

Dashboard-Ansicht

Anzeige und Überwachung

Interaktive Steuerung (nur Wärmepumpen)

Timeline-Visualisierung

Event-Liste mit Filterung

Deutsche Error-Code-Übersetzung

Sichere Credential-Speicherung

Event-Caching und Performance

API Endpoints

Hauptseiten

API

Events und Status

Account-Verwaltung

Login

Gerätesteuerung

Technische Details

Architektur

Dependencies

Build-Eigenschaften

Troubleshooting

Login schlägt fehl

Events werden nicht angezeigt

Keyring-Fehler unter Linux

Container startet nicht / keine Credentials

Container-Image nicht gefunden

Entwicklung

Tests ausführen

Code formatieren

Dependencies aktualisieren

Beiträge

Support

Danksagung

Haftungsausschluss

About

Packages