crypto.randomUUID gibt es nur im secure context — HTTPS oder localhost, sonst nichts. Wer Flaro auf einem NAS betreibt und ihn unter http://192.168.x.x:8097 aufruft, hat die Funktion nicht, und die Geräteerkennung warf mitten in die Einrichtung „crypto.randomUUID is not a function". Das Konto liess sich nicht anlegen. Das ist nicht der Sonderfall. Ein Heimserver im eigenen Netz hat kein Zertifikat, und genau dort wird die Einrichtung durchlaufen. crypto.getRandomValues ist nicht so beschränkt und liefert denselben Zufall; daraus wird die UUID von Hand zusammengesetzt. Fällt auch das aus, bleibt Math.random — kein Zufall für Geheimnisse, aber hier geht es nur darum, zwei Browser auseinanderzuhalten, und gar keine Kennung wäre schlechter als eine schwache. Geprüft mit 20000 Durchläufen: alle entsprechen der Form von Fassung 4, keine Dublette. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Flaro Web
Die Weboberfläche für Rechner, auf denen es keine App gibt — Windows vor allem.
Aufbau
| Ordner | Was |
|---|---|
app/ |
Das Frontend (Vite, TypeScript) |
server/ |
Ein Server ohne Abhängigkeiten, der die Anfragen weiterreicht und die gebauten Dateien ausliefert |
frontend/ |
Die erste Fassung als einzelne Datei. Läuft, wird abgelöst. |
jellyfin-theme/ |
Ein Kleid für Jellyfins eigene Oberfläche — die kleine Lösung von vorher |
Warum ein eigener Server?
Er löst zwei Dinge, an denen die einzelne Datei scheitert, und zwar unabhängig davon, wie gut das Frontend geschrieben ist:
- Herkunft. Anfragen laufen über
/apiund damit über dieselbe Adresse wie die Seite. Kein CORS, auch nicht beim Streamen. - Klartext und Verschlüsselung. Läuft der Medienserver über
httpund die Seite überhttps, blockiert der Browser den Stream. Dagegen kann keine Zeile im Frontend etwas tun — ein Server davor schon.
Nebenbei bleibt der Zugangsschlüssel beim Server, statt im Browser zu liegen.
Betreiben
cd app && npm install && npm run build
cd ../server && FLARO_SERVER=http://jellyfin:8096 node index.js
Dann auf http://localhost:8080. Der Port lässt sich über PORT ändern.
Entwickeln
cd app && FLARO_SERVER=http://jellyfin:8096 npm run dev
Vite übernimmt dabei das Weiterreichen, der eigene Server wird nicht gebraucht.