Webseite und Benutzer¶

6. Webseite¶

6.1 Öffnen und anmelden¶

Handy, Tablet oder PC muss im selben WLAN sein wie die Box.
https://tinyjukebox.local im Browser öffnen (eine weitere Box hat einen eigenen Namen: Abschnitt 13.2).
Der Browser warnt beim ersten Mal vor dem Zertifikat: Die Box stellt es sich selbst aus. Die Warnung bestätigen („Erweitert“ → „Weiter zu tinyjukebox.local“ oder ähnlich).
Sprache wählen: Die Seite ist beim ersten Mal Englisch. Die Auswahl „Deutsch / English“ steht unter der Anmeldung, nach dem Anmelden oben rechts und im Tab „System“.
Mit Benutzername und Passwort anmelden.
Über der Anmeldung steht, wo man ist: „Bibliothek“, „Box“ oder die Box mit ihrem Namen, z. B. Box „antonia“. Jede Box hat ihre eigenen Farben; sie ergeben sich aus ihrem Namen (eine Box ohne Namen hat trotzdem feste Farben). So sieht man auch nach dem Anmelden, auf welcher Box man ist.
Die Sprache merkt sich der Browser, für dieses Gerät und diese Box. Auf einem anderen Gerät und auf der Seite einer anderen Box oder der Bibliothek wird sie einmal neu gewählt.
Die Anmeldung bleibt bestehen. Neu anmelden muss man sich nach 7 Tagen ohne Nutzung und auf einer offenen Seite, auf der 30 Minuten lang nichts bedient wurde (Abschnitt 11).
Nach 5 falschen Passwörtern sperrt jeder weitere Fehlversuch die Anmeldung von diesem Gerät für 30 Sekunden.

6.2 Rollen¶

Rolle	darf
`user`	fast alles ansehen und die Box bedienen: Pause, Titel, Lautstärke, Tags auflegen; in der Bibliothek neue Tags mit dem Telefon scannen; das eigene Passwort ändern
`admin`	zusätzlich alles ändern: Alben, Tags, Radiosender, Titelbilder, Kopfhörer koppeln, Lautstärke-Grenzen, Benutzer

Nur die Rolle admin sieht die Tabs „Hochladen“ und „Log“, alle Schaltflächen zum Ändern und diese Teile der Seite: im Tab „System“ „Konsistenz prüfen“ und die Karten „Hardware“, „Backup“, „Version“ und „Benutzer“; im Tab „Spotify“ die Karten „Konto“ und „Player“; in der Bibliothek die Karten „Box hinzufügen“, „Telefon hinzufügen“ und „Zugang für Boxen und Skripte“ (Tab „Boxen“), „Zugang zu den Releases“ (Tab „Versionen“) und „Die App auf Telefonen“ (Tab „Spotify“).

6.3 Tabs¶

Tab	Inhalt
Jetzt	was gerade läuft: Titelbild, Album, Titel, Stelle, Titelliste. Tasten zurück, Pause/Play, weiter, „Album von vorn“; Lautstärke mit Regler und Tasten. Liegt ein unbekannter Tag auf: Album wählen und „Verknüpfen & abspielen“.
Tags	der Tab für den Alltag: alle Tags mit dem Titelbild ihres Albums oder Senders, als Kacheln oder als Liste („Kacheln“ / „Liste“), alle oder nur die von Alben, von Radiosendern oder von Spotify („Alle“ / „Alben“ / „Radio“ / „Spotify“). Die Seite merkt sich die Auswahl. Ein Klick legt den Tag auf die Box, als läge er wirklich dort; ein zweiter Klick oder „Tag abnehmen“ nimmt ihn wieder ab.
Tag-Verwaltung	alle Tags mit Titelbild, Name, UID, Album oder Sender und Fortschritt. Hier werden Tags angelegt, benannt, verknüpft, gelöst und gelöscht.
Alben	eine Liste aller Alben zum Verwalten: Titelbild, Titel, Titelzahl, Spielzeit, Tags, der Tag, an dem sie hinzugefügt wurden, und der Ordner. Ein Klick auf eine Spaltenüberschrift sortiert danach, ein zweiter dreht die Reihenfolge um. Ein Klick auf den Titel öffnet das Album: Titel und Titelbild (beides änderbar), Titelliste, verknüpfte Tags, Probleme. „Neue Ordner suchen“ nimmt Alben auf, die direkt auf die Box kopiert wurden.
Radio	alle Radiosender: anlegen, umbenennen, Adresse ändern, Titelbild wählen, testen, löschen
Spotify	die Spotify-Einträge: aus einem Link anlegen, umbenennen, Link ändern, Titelbild wählen, testen, löschen; auf einer Box auch Konto und Player (Abschnitt 9)
Bluetooth	der gekoppelte Kopfhörer: Name, verbunden, Akku, Lautstärke, Startwert und Maximum; „Koppeln“ und „Kopplung aufheben“
Statistik	was auf dieser Box gehört wurde: je Tag (ein Klick auf eine Spaltenüberschrift sortiert die Tabelle danach, ein zweiter dreht die Reihenfolge um), je Kalendertag mit den Uhrzeiten, zwischen denen gehört wurde, über Lautsprecher oder Kopfhörer, je Radiosender; übersprungene Titel; je Version der Box-Software Starts, Fehler und Rückfälle, wie viele Tage sie installiert war und wie viele Stunden die Box mit ihr eingeschaltet war (gesamt) und davon etwas gespielt hat (aktiv); ganz unten die Tags, die nie aufgelegt wurden. Gezählt wird in der Bibliothek: Ist sie nicht erreichbar, steht das im Tab. Eine Box ohne Bibliothek zählt selbst und reicht so weit zurück wie die letzten 1000 Einträge ihres Journals.
Hochladen	ein neues Album aus MP3-Dateien anlegen
System	Zustand der Box, Sprache der Seite, „Konsistenz prüfen“, „Fortschritte zurücksetzen“, Hardware (Zustand von Tasten, LED und RFID-Leser, für die Fehlersuche), Backup (Abschnitt 11.1), Bibliothek (Abschnitt 13.2), Version (Abschnitt 13.4), eigenes Passwort ändern, Benutzer, Fortschritt je Tag
Log	die Meldungen der Box, live, mit Filter; „Als Datei speichern“

Die Tasten im Tab „Jetzt“ wirken wie die Tasten der Box.

Hilfe: „Hilfe“ oben öffnet dieses Handbuch beim Kapitel des offenen Tabs, in der Sprache der Seite; dort findet ein Admin auch die Verwaltung. Die Box bringt die Hilfe selbst mit – sie geht ohne Internet und gehört zur Version, die auf der Box läuft. Nach dem Anmelden weist ein Hinweis auf die Kurzanleitung, bis „Nicht mehr anzeigen“ angehakt ist; das merkt sich der Browser.

10. Lautstärke begrenzen¶

Lautsprecher und Kopfhörer haben je einen Startwert und ein Maximum:

	Startwert	Maximum
Lautsprecher	gilt beim Einschalten der Box	gilt immer
Kopfhörer	gilt bei jedem Verbinden	gilt immer, auch für die Tasten am Kopfhörer

Ändern (Rolle admin): Tab „Jetzt“, „ändern“ unter dem Lautstärkeregler – oder Tab „Bluetooth“, „Startwert und Maximum ändern“.

Es gilt: 0 ≤ Startwert ≤ Maximum ≤ 100.
Ein gesenktes Maximum senkt eine höhere aktuelle Lautstärke sofort.
Ein neuer Startwert wirkt beim nächsten Einschalten bzw. Verbinden.
Die Werte bleiben erhalten, auch nach dem Ausschalten.
Die Rolle user sieht die Werte, kann sie aber nicht ändern. So verstellt niemand den Gehörschutz nebenbei.
Die Tasten am Kopfhörer kann die Box nur bei Kopfhörern begrenzen, die ihre Lautstärke mit der Box abgleichen („Absolute Volume“). Die Lautstärke, die die Box selbst einstellt, ist immer begrenzt.

11. Benutzer und Passwörter¶

Eigenes Passwort ändern (jeder Benutzer): Tab „System“, „Eigenes Passwort ändern“ – mit dem aktuellen Passwort. Auf allen anderen Geräten ist danach eine neue Anmeldung nötig.
Benutzer verwalten (Rolle admin): Tab „System“, „Benutzer“ – Benutzer anlegen (Rolle user oder admin), Passwort setzen, löschen.
Ein neues Passwort meldet den Benutzer auf allen anderen Geräten ab.
Den eigenen Benutzer kann man nicht löschen. So bleibt immer ein Admin.
Die Rolle eines bestehenden Benutzers lässt sich auf der Webseite nicht ändern: Benutzer löschen und neu anlegen.
Passwörter haben mindestens 8 Zeichen.
Von selbst abgemeldet: Neben den 7 Tagen ohne Nutzung (Abschnitt 6.1) gilt: Eine offene Seite, auf der 30 Minuten lang nichts bedient wurde, meldet sich ab und sagt das auf der Anmeldeseite. Als Bedienung zählt eine Mausbewegung, ein Tippen oder eine Taste; ein laufender Upload zählt auch. Die Zeit lässt sich in der Konfiguration der Box oder der Bibliothek ändern oder abschalten (configuration.md, Abschnitt 5).
Passwort vergessen: Ein Admin setzt ein neues. Kennt kein Admin sein Passwort mehr, hilft nur der Zugang zur Box selbst (operations.md, Abschnitt 4).

11.1 Backup¶

Ein Backup ist eine Datei mit den Daten der Box: Tags, Verknüpfungen, Fortschritte, Lautstärken und die Titelbilder der Alben und Sender. Nur die Rolle admin kann eines erstellen.

Tab „System“, „Backup“: „Backup herunterladen“ speichert die Datei auf dem Gerät, an dem man sitzt. Sie ist klein.
„Backup mit MP3s herunterladen“ nimmt auch die Alben mit. Die Datei ist dann so groß wie alle Alben zusammen, und das Herunterladen dauert entsprechend.
Benutzer, Passwörter und Schlüssel sind nie in einem Backup.
Eine Box, die mit einer Bibliothek arbeitet, braucht kein eigenes Backup: Alles steht in der Bibliothek, und die sichert sich selbst (Abschnitt 13.6).

11.2 Regelmäßig sichern¶

Eine Box ohne Bibliothek – und die Bibliothek (Abschnitt 13.6) – erstellt von selbst Backups: Tab „System“, Karte „Backup“, „Regelmäßig sichern“. Es gibt zwei Zeitpläne, unabhängig voneinander: einen für die Backups ohne MP3s, einen für die mit MP3s.

Einstellung	Bedeutung
regelmäßig	Backups dieser Art entstehen von selbst.
alle … um …	wie oft – eine Zahl von Tagen, Wochen oder Monaten – und zu welcher Uhrzeit. Bei Monaten: am selben Tag des Monats wie das letzte Backup.
… Backups aufbewahren	Ältere Backups dieser Art werden gelöscht.
Ordner	wo diese Backups abgelegt werden. Leer: der vorgegebene Ordner, auf einer Box `backups` neben den Alben.

Ein Beispiel: ohne MP3s jede Woche, 52 aufbewahren – ein Jahr kleiner Backups; mit MP3s jeden Monat, 2 aufbewahren – das aktuelle und das davor, jedes so groß wie alle Alben.
„Speichern“ übernimmt die Einstellungen beider Zeitpläne. „Jetzt sichern“ und „Jetzt mit MP3s sichern“ erstellen sofort ein Backup; es landet im Ordner seiner Art und zählt für deren Anzahl.
Die Tabelle darunter zeigt die Backups beider Ordner mit ihrer Art. Jedes lässt sich herunterladen und löschen.
Unter jedem Zeitplan steht, wo seine Backups liegen, wann das letzte erstellt wurde und wann das nächste fällig ist – oder warum das letzte fehlgeschlagen ist.
Ändert man einen Ordner, bleiben die bisherigen Backups im alten Ordner liegen.
Eine Box, die mit einer Bibliothek arbeitet, zeigt diesen Teil nicht: Die Bibliothek erstellt die Backups. Die Einstellungen bleiben erhalten und gelten wieder, wenn die Box von der Bibliothek getrennt wird.
Auf einer Box liegen die Backups auf ihrer SD-Karte, wie die Daten selbst. Gegen eine kaputte Karte hilft nur ein Backup, das heruntergeladen wurde, oder ein Ordner auf einem anderen Laufwerk.

11.3 Backup zurückspielen¶

Ein Backup ersetzt die Daten der Box – oder der Bibliothek – durch die vom Tag, an dem es erstellt wurde. Nur die Rolle admin kann das: Tab „System“, Karte „Backup“, „Backup zurückspielen“.

„Backup wählen …“ und die Datei auf dem Gerät wählen, an dem man sitzt. Bei einem Backup, das ein Zeitplan erstellt hat: „Zurückspielen“ daneben in der Tabelle.
Das Backup wird gesendet und bis zum Ende gelesen; mit MP3s dauert das so lange wie ein Download. Eine Datei, die kein Backup ist, abgeschnitten ist oder zur Bibliothek statt zu einer Box gehört, wird abgelehnt – dann ändert sich nichts.
Die Seite fragt einmal: „Das ersetzt alle Daten durch die vom …“. Mit MP3s werden alle Alben gelöscht und ersetzt. Abbrechen, und nichts ändert sich.
Nach „OK“ hält die Box (oder die Bibliothek) an, legt die Daten an ihren Platz und startet neu. Die Seite lädt neu; danach erneut anmelden.
Vorher wird kein Backup erstellt. Wenn die Daten von jetzt noch gebraucht werden könnten: abbrechen und zuerst ein Backup herunterladen.
Benutzer, Passwörter, Schlüssel und wohin die Backups gehen bleiben, wie sie sind.
Ein Backup ohne MP3s lässt die Alben, wie sie sind. Nennen die Daten ein Album, dessen Ordner fehlt, sagt die Karte das danach und nennt es.
Eine Box, die mit einer Bibliothek arbeitet, bekommt bei der nächsten Synchronisierung wieder den Stand der Bibliothek. Dann besser das Backup auf der Bibliothek zurückspielen (Abschnitt 13.6).