Der Nachfolger von SmartMirror2: ein schlanker Smart Mirror für einen Raspberry Pi 5 mit Ubuntu 26.04 LTS Server (ohne Desktop). Alles läuft in Docker. Das Dashboard erscheint im Vollbild auf einem WQHD-Monitor im Hochformat (1440×2560). Die Drehung lässt sich in der App einstellen.
Stand: Phase 7 (Logbuch, Update-Knopf) abgeschlossen – funktional vollständig, die Abnahme am Pi steht aus.
- Verwaltung unter
/admin: Anordnung, Anzeige (mit Nachtruhe), Wetter, Kamera, WLAN-QR-Code, Kalender (Kalender, Bereiche, Regeln, Vorschau), Symbole, Bring!-Einkaufsliste, Logbuch, System (Version, Update per Knopf) und Konto.- Dashboard: Es zeigt die Module Uhr, Wetter, Kamera, Kalender-Bereiche, Schichten, Bring! und WLAN-QR-Code in der eingestellten Anordnung, im Look von SmartMirror2.
- Kiosk-Container: Er zeigt das Dashboard per Cage und Chromium im Vollbild, dreht es zur Laufzeit und schaltet den Monitor zur Nachtruhe aus. Die Abnahme am Pi steht noch aus (siehe
deploy/INSTALL.md).- Noch offen: die Abnahme am Gerät nach
deploy/INSTALL.md(Anzeige, Drehung, Nachtruhe, Kamera, Update-Dienst).
Pi 5 · Ubuntu 26.04 Server · Host: nur Docker (docker compose up -d)
├─ mirror Go-Binary: API + eingebettete React-App, :8080, Volume /data
├─ kiosk Debian + Cage + Chromium + kioskd
│ öffnet http://mirror:8080, setzt Drehung und Monitor an/aus
└─ camera go2rtc, nur im internen Docker-Netz; mirror reicht das Video durch
- Server (
server/): Go mit der Standardbibliothek (net/http,slog,embed). Das Binary bettet die gebaute React-App ein und liefert sie aus. Unbekannte Client-Routen bekommenindex.html, unbekannte/api/-Pfade einen JSON-404. Gehashte Assets werden ein Jahr gecacht. - Oberfläche (
web/): React 19, Vite, TypeScript, React Query. Layout und Design des Dashboards stammen aus SmartMirror2. Der Admin-Bereich wird neu gestaltet. - API-Vertrag (
api/openapi.yaml): spec-first. Daraus erzeugtoapi-codegenden Go-Server-Code undopenapi-typescriptdie Client-Typen. Die Oberfläche spricht die API nur über den erzeugten Client an. - Daten: keine Datenbank. Einstellungen liegen ab Phase 2 als JSON-Datei im Volume
/data.
| Pfad | Inhalt |
|---|---|
api/ |
OpenAPI-Vertrag |
server/ |
Go-Modul: cmd/mirror (Server), cmd/kioskd (Kiosk-Agent), internal/{api,auth,bring,calendar,camera,config,display,fsutil,httpserver,icons,kiosk,logbook,modules,settings,update,weather,web,wifi} |
web/ |
React-App (src/app, src/shared, src/features/{dashboard,admin,modules}); je Modul ein Ordner mit Widget und Admin-Seite; die Verwaltung (Mantine) lädt als eigener Chunk; src/vendor/go2rtc ist der Player von go2rtc (MIT) |
kiosk/ |
Dockerfile des Kiosk-Images (Cage, Chromium, kioskd) |
deploy/ |
compose.yaml, .env.example, INSTALL.md (Installation auf dem Pi) und host/ (Update-Dienst für den Host) |
tools/ |
Prüfskript verify.mjs, Changelog-Werkzeug changelog.mjs |
.github/workflows/ |
CI: Prüfung und Images für GHCR |
Voraussetzungen:
- Go 1.27: Mit
GOTOOLCHAIN=auto(Standard) lädt Go die Version ausgo.modselbst nach. - Node.js 22 oder neuer: Die CI nutzt Node 26.
- git
Abhängigkeiten der Oberfläche einmalig installieren:
npm ci --prefix webServer mit gebauter Oberfläche starten:
npm --prefix web run build # schreibt nach server/internal/web/dist
cd server
MIRROR_ADDR=127.0.0.1:8080 MIRROR_DATA_DIR=./data go run ./cmd/mirrorDanach ist das Dashboard unter http://127.0.0.1:8080/ erreichbar, das Testbild unter http://127.0.0.1:8080/?diagnose. Ohne gebaute Oberfläche antwortet der Server mit 503 und einem Hinweis.
Oberfläche mit Hot Reload entwickeln: den Server wie oben starten, dann npm --prefix web run dev. Vite leitet /api an :8080 weiter.
| Umgebungsvariable | Standard | Bedeutung |
|---|---|---|
MIRROR_ADDR |
:8080 |
Listen-Adresse (host:port) |
MIRROR_DATA_DIR |
/data |
Verzeichnis für Einstellungen und Daten |
MIRROR_OPENWEATHER_URL |
https://api.openweathermap.org/ |
Basis-URL von OpenWeather (nur für Tests mit einem nachgebauten Server) |
MIRROR_BRING_URL |
https://api.getbring.com/rest/v2/ |
Basis-URL von Bring! (nur für Tests) |
MIRROR_CONTROL_DIR |
– | Gemeinsames Verzeichnis mit dem Host-Update-Dienst (im Container /control); leer = kein Update per Knopf |
MIRROR_GO2RTC_URL |
http://camera:1984/ |
API von go2rtc im internen Netz |
TZ |
– | Zeitzone des Spiegels (Nachtruhe, Kalender); Standard in deploy/.env ist Europe/Berlin |
Die Verwaltung liegt unter /admin und funktioniert am Handy wie am Rechner.
- Beim ersten Aufruf: Du legst das Admin-Passwort fest (mindestens 10 Zeichen). Gespeichert wird es als Argon2id-Hash in
<MIRROR_DATA_DIR>/admin.json. - Sitzung: Eine Anmeldung gilt 8 Stunden ab der letzten Nutzung.
- Fehlversuche: Nach 5 falschen Passwörtern in 15 Minuten sperrt der Server weitere Versuche dieser Adresse vorübergehend.
- Einstellungen: Sie liegen in
<MIRROR_DATA_DIR>/settings.json. Eine unlesbare oder fremde Datei wird alssettings.json.discarded-<Zeit>beiseitegelegt, und der Server startet mit Standardwerten. - Passwort vergessen: Server stoppen,
admin.jsonim Datenverzeichnis löschen, neu starten und neu einrichten. - Module und Anordnung: Der Spiegel besteht aus Modulen: Uhr, Wetter, Kamera, WLAN-QR-Code, je ein Modul pro Kalender-Bereich und Bring!. Unter „Anordnung“ legst du fest, welches Modul in welcher der fünf Regionen steht: oben links, oben rechts, Mitte, unten links, unten rechts. Was nicht eingeordnet ist, bleibt aus.
- Wetter: Es braucht einen OpenWeather-API-Key mit dem Abo „One Call API 3.0“ (1.000 Abrufe am Tag sind kostenlos).
- Kalender:
- Du trägst beliebig viele private iCal-Links ein (Google, iCloud, Outlook) und legst Bereiche an, entweder Terminlisten oder eine Schichtanzeige für den Dienstplan. Neue Bereiche erscheinen oben links.
- Regeln blenden Termine aus, setzen Symbole oder benennen sie um. Die Vorschau zeigt mit echten Terminen, welche Regel greift.
- Je Bereich lässt sich die Zeitangabe einfärben: läuft gerade, beginnt in weniger als X Stunden, beginnt heute – jede Stufe mit eigener Farbe.
- Serientermine, Ausnahmen, ganz- und mehrtägige Termine sowie Zeitzonen werden korrekt berechnet.
- Die iCal-Adressen bleiben auf dem Server.
- Symbole: eigene SVG- oder PNG-Dateien bis 256 KB. SVGs werden auf aktive Inhalte geprüft.
- Bring!: Anmeldung mit E-Mail und Passwort deines Bring!-Kontos; die Liste wählst du aus. Am Spiegel erscheinen bis zu 18 Einträge.
- Nachtruhe (unter „Anzeige“): Aus- und Einschaltzeit, auch über Mitternacht, in der Zeitzone aus
TZ. Der Kiosk schaltet den Monitor perwlr-randraus, das Dashboard zeigt in der Zeit nur Schwarz und arbeitet nicht. Ein Knopf schaltet den Monitor zum Test 10 Sekunden aus. - Logbuch: die letzten 500 Meldungen des Servers seit dem Start, filterbar nach Warnungen und Fehlern. Die Kachel zählt Warnungen und Fehler.
- System: installierte Version und Update per Knopf. Der Server legt nur eine Anfrage-Datei in
MIRROR_CONTROL_DIRab, ein systemd-Dienst auf dem Host (deploy/host/) holt die neuen Images und startet neu. Einrichtung indeploy/INSTALL.md, Abschnitt „Updates per Knopf“. - Kamera: Eine RTSP-, RTSPS- oder RTSPX-Adresse (sie bleibt auf dem Server). Für UniFi Protect
rtspx://stattrtsps://verwenden;?enableSrtpentfernt der Spiegel selbst. Der Dienstcamera(go2rtc) gibt das Video ohne Umkodierung weiter, der Server reicht es per WebSocket an das Dashboard durch. Helligkeit, Kontrast, Sättigung und Schwarzweiß stellst du in der Verwaltung ein.
api/openapi.yamlanpassen.npm run generateerzeugt den Go-Server-Code und die TypeScript-Typen neu.- Den Handler in Go umsetzen und testen.
- In der Oberfläche über
apiundunwrap()ausweb/src/shared/api/client.tsaufrufen.
Erzeugte Dateien (*.gen.go, schema.gen.ts) werden committet und nie von Hand geändert.
npm run verifyDas Gate läuft unter Windows, Linux und in der CI.
- Selbsttest: Zuerst prüft es seine eigene Logik (
node --test 'tools/*.test.mjs'). - Zwei Stränge, parallel:
- Backend:
go mod tidy -diff, Drift des erzeugten Go-Codes,gofmt,go vet,go test. - Frontend: Drift der API-Typen,
tsc, ESLint, Vitest, Build.
- Backend:
- Ergebnis: Am Ende stehen beide Logs und eine Tabelle mit Dauer und Ergebnis je Schritt.
| Schalter | Wirkung |
|---|---|
--only <schritt>[,<schritt>] |
nur diese Schritte (unbekannter Name: Exit 2) |
--sequential |
alles nacheinander, zum Eingrenzen |
--skip-build |
ohne Frontend-Build |
--race |
go test mit Race-Detector (CI) |
Einzelprüfungen:
- Backend (aus
server/):go test ./... - Frontend (aus
web/):npx tsc -p tsconfig.app.json,npm run lint,npx vitest run
Die CI baut bei jedem Push auf main, claude/** und bei Tags v* die Images ghcr.io/thazzr/mirrornextgen/mirror (für linux/arm64 und linux/amd64, per Cross-Compile ohne QEMU) und ghcr.io/thazzr/mirrornextgen/kiosk (linux/arm64, auf einem arm64-Runner). Die Kamera nutzt das fertige Image alexxit/go2rtc.
| Tag | Quelle |
|---|---|
| Branch-Name | letzter Stand des Branches |
sha-… |
ein bestimmter Commit |
| Version | bei Tags v* |
latest |
main |
Auf dem Pi:
cp deploy/.env.example deploy/.env # MIRROR_TAG, MIRROR_PORT, TZ anpassen
docker compose -f deploy/compose.yaml --env-file deploy/.env up -dDie Schritt-für-Schritt-Anleitung für den Pi 5 mit Ubuntu 26.04 Server (Anzeige-Vorbereitung, Docker, Start, Abnahme-Checkliste, Fehlersuche) steht in deploy/INSTALL.md. Solange die Images in GHCR privat sind, braucht der Pi einmalig docker login ghcr.io mit einem Token mit read:packages.
| Phase | Version | Inhalt |
|---|---|---|
| 1 | 0.1.0 | Grundgerüst: Go-Server, React-Oberfläche, Prüfskript, Image und CI |
| 2 | 0.2.0 | Admin-Zugang und Einstellungen (neu gestaltet), erster Abschnitt „Anzeige“ mit Drehung |
| 3 | 0.3.0 | Kiosk-Container auf dem Pi: Cage + Chromium, Drehung per wlr-randr, Installationsanleitung |
| 4 | 0.4.0 | Module und freie Anordnung (fünf Regionen), Uhr, Wetter, WLAN-QR im Layout von SmartMirror2 |
| 5 | 0.5.0 | Kalender (Neuentwurf: Bereiche, Regeln mit Vorschau, Schichtanzeige), Icon-Bibliothek, Bring! |
| 6 | 0.6.0 | Kamera (go2rtc) und Nachtruhe |
| 7 | 0.7.0 | Update-Knopf und Logbuch |
Regeln, Architekturgrenzen und den Ablauf pro Phase beschreibt CLAUDE.md: Planen und Prüfen, Umsetzen durch Subagenten, Gegenproben, Gate, Conventional Commits, SemVer-Tags.
CHANGELOG.md wird mit npm run changelog aus den Commit-Nachrichten erzeugt und nie von Hand bearbeitet.
MirrorNextGen steht unter der MIT-Lizenz. Mitgelieferte Fremdbestandteile behalten ihre eigenen Lizenzen: IBM Plex Sans (SIL Open Font License 1.1), Bootstrap Icons, Tabler Icons, Mantine, die Meteocons-Wettersymbole und der Player video-rtc.js von go2rtc (alle MIT). Die Lizenzen der npm- und Go-Abhängigkeiten liegen bei den jeweiligen Paketen.