> about_project.ts

const hawall = {
    name: "Hawall",
    version: "1.5.0",
    platform: "Windows (.exe)",
    target: "Surface Go 2 — Layout aber vollständig responsiv",
    connection: {
        api: "Home Assistant REST + WebSocket",
        auth: "Long-Lived Access Token",
        note: "bewusst kein HA-Dashboard, sondern eigenes Layout"
    },
    setup: [
        "exe ausführen → Setup-Wizard → Autostart",
        "Vollbild zeigt 'Bereit zum Einrichten' + IP-Adresse",
        "Rest der Einrichtung im Browser eines anderen Geräts"
    ],
    dashboards: ["Dashboard", "Screensaver", "Unterdashboards"],
    updates: "automatisch & lautlos über GitHub Releases",
    funFact: "Das Tablet an der Wand darf sich nicht mehr drehen 🔒"
};

> tech_stack

> features

✓ Eigenes Dashboard-Layout mit freier Karten-Positionierung (4×6-Raster)
✓ Screensaver als vollwertiges zweites Dashboard mit eigenen Karten
✓ Unterdashboards mit Navigations-Karte und automatischem Zurück-Button
✓ Nachtmodus — Zeitfenster, schwarzer Bildschirm, Refresh pausiert
✓ Hell/Dunkel-Theme, gesteuert über eine Sonnenstand-Entität aus HA
✓ Akku-Überwachung des Geräts über die Browser-Battery-API
✓ Ankündigungs-Box über input_text
✓ Karten frei per Maus/Touch größenziehbar — mit Kollisionsschutz
✓ Bildschirmdrehung gesperrt (nur Querformat)
✓ Lautloses Auto-Update im Hintergrund, ohne Installer und Admin-Abfrage

> card_types

Karte	Beschreibung
Schalter	switch, light, binary_sensor (nur Anzeige)
Taster	Button für Skripte, Szenen und Automationen
Lampe / Dimmer	Helligkeit und Schalten in einer Karte
Gauge	Bogen-Design mit Schwellenwert-Farben und eigenem Suffix
Verlauf	Geglätteter History-Graph statt zackiger Rohdaten
Sensor	Freier Textwert mit editierbarem Anzeigenamen
Temperatur	Dedizierte Temperaturkarte
Wind / Regen / Regenradar	Wetterkarten, standardmäßig groß (lg), optional XL
Wettervorhersage	Täglich oder stündlich wählbar
Luftdruck	Druckverlauf als eigene Karte
Auswahl	input_select als bedienbare Karte
Energiefluss	Solar / Netz / Haus / Batterie mit animierten Flusslinien
Uhr	Nur im Screensaver verfügbar, ohne Entität
Navigation	Sprung in ein Unterdashboard

> installation

# 1 — Release herunterladen
https://github.com/Max6025/Hawall/releases/latest

# 2 — exe ausführen
Setup-Wizard führt durch die Installation, danach startet Hawall automatisch

# 3 — Wall Display zeigt im Vollbild
"Bereit zum Einrichten"  ·  http://<IP-des-Geräts>:<Port>

# 4 — Von einem anderen Gerät im Browser öffnen
Verbindung eintragen: HA-URL · Long-Lived Token · Titel

# 5 — Karten hinzufügen
Editor öffnen → + → Kartentyp wählen → Entität zuweisen → Speichern

Ein erneuter Start der exe erkennt eine bestehende Installation und aktualisiert sie, statt neu zu installieren.

> setup_pages

Seite	Inhalt
/setup	Verbindung zu Home Assistant
/setup/theme.html	Theme, Nachtmodus, Akkuwarnung
/setup/screensaver	Timeout und eigenes Screensaver-Dashboard
/setup/changelog.html	Versionsverlauf
/setup/debug-forecast.html	Diagnose der Wettervorhersage-Abfragen

> whats_new — v1.5.0

+ Hawall-Branding und einheitliche Navbar über alle Setup-Seiten
+ Modernisiertes Setup-Layout (style.css überarbeitet)
+ Neue Changelog-Seite mit Kacheln für große und Liste für kleine Updates
+ Akku-Banner im Screensaver bei niedrigem Gerätestand
+ Karten-Editor des Hauptdashboards auf feste 4×6-Arbeitsfläche umgestellt
+ Freie x/y-Positionierung der Karten — wie im Screensaver
! Nachtmodus-Aufwecken zeigt jetzt das Dashboard statt des Screensavers
! Kollisionsschutz verhindert Überlappen und Stapeln beim Größerziehen
! Karten können nicht mehr aus dem sichtbaren Bereich verschoben werden

Ältere Versionen

v1.4.2  ~ Akkuanzeige auf die Geräte-Batterie umgestellt (Browser-Battery-API)
v1.4.1  ! Nachtmodus blockierte den Zustands-Abruf — Rendering pausiert jetzt allein
v1.4.0  + Nachtmodus und Batteriewarnung mit Einstellungen unter /setup/theme.html
v1.3.0  + Energiefluss-Karte samt automatischem Laden der HA-Energiekonfiguration
v1.2.7  ! binary_sensor war im Typ-zuerst-Ablauf nicht auswählbar
v1.2.6  + Wettervorhersage wahlweise täglich oder stündlich
v1.2.5  ! Screensaver rief den Vorhersage-Fetch nie auf
v1.2.4  + Debug-Seite für Vorhersage-Abfragen
v1.2.3  ! Fehlgeschlagene Vorhersagen wurden dauerhaft gecacht
v1.2.0  + Vorhersage, Luftdruck, Auswahl-Karte, Kopieren, Unterdashboards, Ankündigung
v1.0.10 + Screensaver mit größeren Zellen und frei fixierbaren Karten
v1.0.9  + Editierbarer Anzeigename, Typ-zuerst-Ablauf, Screensaver als eigenes Dashboard

> screenshots

 

 

> repo_stats

     

> roadmap

- [x] Freie Karten-Positionierung im Hauptdashboard
- [x] Screensaver als eigenständiges Dashboard
- [x] Nachtmodus und Akkuwarnung
- [x] Setup-Redesign mit Navbar und Changelog
- [ ] Weitere Kartentypen nach Bedarf
- [ ] Feinschliff an Verlauf- und Gauge-Karten