Tiny Jukebox – Benutzerhandbuch

Tiny Jukebox ist eine Musikbox für Kinder. Einen Tag auf die Box legen, und das Album des Tags spielt an der Stelle weiter, an der es zuletzt aufgehört hat. Bedient wird die Box mit vier Tasten; eine LED zeigt ihren Zustand. Alben, Tags und Radiosender verwaltet man auf einer Webseite. Gibt es mehrere Boxen oder eine Bibliothek im Heimnetz, teilen sich die Boxen Alben, Tags und Sender (Abschnitt 13).

Das Wichtigste auf einer Karte: Kurzanleitung. Boxen und Bibliothek einrichten und betreiben: Verwaltung.

Inhalt:

1. Begriffe
2. Die Box bedienen
3. LED
4. Pause
5. Bluetooth-Kopfhörer
6. Webseite
7. MP3-Alben
8. Radio
9. Spotify
10. Lautstärke begrenzen
11. Benutzer und Passwörter
12. Wenn etwas nicht funktioniert
13. Bibliothek

1. Begriffe

2. Die Box bedienen

2.1 Ein- und Ausschalten

In der Box liefert eine Powerbank den Strom. Auf der Rückseite: Der Schalter (links) verbindet und trennt ihn, die USB-Buchse (rechts) lädt die Powerbank.

• Einschalten: mit dem Schalter. Während des Starts leuchtet die LED rot, dann magenta. Leuchtet sie grün, ist die Box bereit.
• Ausschalten: mit dem Schalter. Das ist jederzeit erlaubt, auch während ein Album läuft. Die Box speichert die Stelle alle 5 Sekunden; beim nächsten Mal geht es höchstens wenige Sekunden früher weiter.
• Die Box spielt auch ohne WLAN. Nur die Webseite und Radiosender brauchen es.

2.2 Tags

Jeder Tag hat seinen eigenen Fortschritt. Ein Album, das zu Ende gehört wurde, beginnt beim nächsten Auflegen von vorn.

2.3 Tasten

Der Deckel: die vier Tasten mit ihren Symbolen, die LED, in der Mitte das Fenster für den Tag.

• Die Lautstärke ist begrenzt (Abschnitt 10).
• Ist das Album zu Ende, wirkt „weiter“ nicht. „zurück“ spielt den letzten Titel, „zurück“ 1 s halten das ganze Album von vorn.
• Bei einem Radiosender wirken „weiter“ und „zurück“ nicht. Den Sender wechselt man mit dem Tag.
• Jeder Tastendruck wirkt sofort. Beim Koppeln eines Kopfhörers springt ein laufendes Album deshalb um höchstens einen Titel. Wer das vermeiden will, nimmt den Tag vorher ab.

3. LED

Die Webseite zeigt dieselbe LED neben dem Logo.

4. Pause

In der Pause hält die Wiedergabe an, die Stelle wird gespeichert, und der Tag bleibt liegen. Die LED wechselt zwischen weiß und blau.

Pausieren und fortsetzen:

• Play/Pause am Kopfhörer
• ⏸ / ▶ auf der Webseite (Tab „Jetzt“)
• Die Box selbst hat keine Pause-Taste. Tag abnehmen und später wieder auflegen hat dieselbe Wirkung.

• Bei einem Album, das zu Ende ist, ändert Play/Pause nichts.
• Beim Radio beendet die Pause den Stream. Play, „weiter“ oder „zurück“ verbinden neu; das Radio läuft live weiter, eine Stelle gibt es nicht.
• Die Box pausiert von selbst, wenn die Verbindung zum Kopfhörer abbricht (Abschnitt 5.3).

5. Bluetooth-Kopfhörer

Die Box spielt über einen Bluetooth-Kopfhörer, sobald der gekoppelte Kopfhörer verbunden ist. Der Lautsprecher ist dann stumm. Grundsätze:

• Automatisch: Ist der Kopfhörer verbunden, spielt er. Sonst spielt der Lautsprecher. Ein Menü gibt es nicht.
• Nie überraschend laut: Bricht die Verbindung ab, pausiert die Box. Sie wechselt nie von selbst auf den Lautsprecher.
• Gehörschutz: Der Kopfhörer hat eine eigene Startlautstärke und eine eigene Höchstlautstärke.
• Genau ein Kopfhörer: Es ist höchstens ein Kopfhörer gekoppelt. Ein neuer ersetzt den alten.

5.1 Koppeln

1. Den Kopfhörer in den Pairing-Modus versetzen. Wie das geht, steht in seiner Anleitung (Sony WH-CH530: die mittlere Taste etwa 5 s halten, bis er „Pairing“ sagt).
2. An der Box „weiter“ und „zurück“ zusammen 5 s halten. Danach können die Tasten losgelassen werden.
3. Die LED blinkt schnell blau, solange die Box sucht (höchstens 60 s).
4. Ergebnis:
   • 2 s weiß: Der Kopfhörer ist gekoppelt und verbunden.
   • 3 s schnell rot blinkend: nichts gefunden, oder das Koppeln ist fehlgeschlagen. Der bisherige Kopfhörer bleibt gekoppelt.

Weitere Regeln:

• Die Box sucht nur Audio-Geräte (Kopfhörer, Lautsprecher) im Pairing-Modus. Findet sie mehrere, nimmt sie das mit dem stärksten Signal – in der Regel das direkt neben der Box.
• Die Box selbst ist nie sichtbar. Ein fremdes Handy kann sich nicht mit ihr koppeln.
• Derselbe Kopfhörer lässt sich erneut koppeln, z. B. nach einem Werksreset des Kopfhörers.
• Die Suche lässt sich nicht abbrechen; sie endet nach 60 s von selbst. Wiedergabe und Tasten laufen währenddessen normal weiter.
• Koppeln und Kopplung aufheben geht auch auf der Webseite: Tab „Bluetooth“, Rolle admin.

5.2 Im Alltag

• Kopfhörer einschalten genügt. Er verbindet sich von selbst mit der Box. Nach dem Einschalten der Box und wenn er die Verbindung verliert, sucht die Box ihn auch selbst, eine Minute lang.
• Verbindet er sich, während ein Album läuft, geht es auf dem Kopfhörer weiter (etwa 1 s zurück), und der Lautsprecher verstummt.
• Die Webseite zeigt neben der LED ein Kopfhörer-Symbol, solange er verbunden ist.
• Soll ein zweiter Kopfhörer benutzt werden, muss er neu gekoppelt werden. Der erste verbindet sich danach nicht mehr.

5.3 Verbindung weg

Akku leer, außer Reichweite, ausgeschaltet oder Kopplung aufgehoben:

• War schon vor dem Abbruch pausiert, bleibt es auch nach dem Wiederverbinden pausiert.
• „lauter“ und „leiser“ an der Box ändern in dieser Pause nur die Lautstärke des Lautsprechers. Sie setzen nicht fort.

5.4 Tasten am Kopfhörer

5.5 Lautstärke des Kopfhörers

• Der Kopfhörer startet bei jedem Verbinden mit seiner Startlautstärke, nie mit der Lautstärke vom letzten Mal.
• Die Werte lassen sich ändern (Abschnitt 10).
• Die Prozentwerte beziehen sich auf den Kopfhörer: Wie laut 75 % sind, hängt vom Modell ab. Die Höchstlautstärke einmal mit dem Kopfhörer am Ohr einstellen.

5.6 Hinweise zu Kopfhörern

• Handy in der Nähe: Viele Kopfhörer halten zwei Verbindungen gleichzeitig (Multipoint) und spielen, was zuletzt Ton geschickt hat. Ist der Kopfhörer auch mit einem Handy verbunden, können dessen Töne die Box übertönen. Dann den Kopfhörer am Handy trennen.
• Begrenzung in der App des Kopfhörers: Manche Kopfhörer begrenzen die Lautstärke selbst (Sony: „Max Volume Control“ in der App „Sound Connect“). Das wirkt zusätzlich zur Grenze der Box. Ein Werksreset des Kopfhörers setzt es zurück.
• LE Audio: Die Box nutzt klassisches Bluetooth. Eine Einstellung wie „LE Audio Priority“ in der App des Kopfhörers muss ausgeschaltet sein.
• Akkustand: Die Webseite zeigt ihn im Tab „Bluetooth“, wenn der Kopfhörer ihn meldet.

6. Webseite

6.1 Öffnen und anmelden

1. Handy, Tablet oder PC muss im selben WLAN sein wie die Box.
2. https://tinyjukebox.local im Browser öffnen (eine weitere Box hat einen eigenen Namen: Abschnitt 13.2).
3. 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).
4. 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“.
5. 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

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

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.

7. MP3-Alben

Ein Album ist ein Ordner mit MP3-Dateien auf der Box; liegt es dort, spielt es ohne WLAN. Es setzt fort, wo es aufgehört hat – jeder Tag mit seinem eigenen Fortschritt (Abschnitt 7.4). Alben auf die Box bringen, Tags verknüpfen und Titelbilder ändern braucht die Rolle admin; ein Album von vorn beginnen lassen und den Fortschritt ansehen darf auch die Rolle user.

7.1 Ein neues Album auf die Box bringen

1. Tab „Hochladen“.
2. Den Titel des Albums eingeben. Der Ordner auf der Box bekommt denselben Namen.
3. Wer mag, wählt ein Titelbild (JPEG, PNG oder WebP). Es lässt sich auch später setzen.
4. MP3-Dateien in das Feld ziehen, oder „Dateien wählen“ bzw. „Ordner wählen“.
5. Die Reihenfolge prüfen. Sie folgt der Titelnummer in den Dateien, sonst dem Dateinamen (2 vor 10), und lässt sich vor dem Anlegen ändern.
6. Optional unter „Mit Tag verknüpfen“ einen Tag wählen.
7. „Album anlegen“.

Grenzen: nur MP3-Dateien, höchstens 500 MB je Datei und 500 Dateien je Album; auf der Box müssen danach 200 MB frei bleiben. Ein abgebrochener Upload steht unter „Unfertige Uploads“ und verfällt nach einer Stunde.

Titel und Titelbild ändern: Tab „Alben“, Album öffnen. Den Titel oben überschreiben – er ist gespeichert, sobald das Feld verlassen wird. „Titelbild ändern“ nimmt ein neues Bild (JPEG, PNG oder WebP) und ersetzt das bisherige. Ein Album ohne Titelbild zeigt das Bild aus seinen MP3-Dateien, falls sie eines enthalten.

Ein Album löschen: Tab „Alben“, Album öffnen, „Album entfernen“ – mit „Dateien ebenfalls löschen“ verschwinden auch die MP3-Dateien. Das geht nur, wenn kein Tag mit dem Album verknüpft ist und es nicht gerade spielt.

Zeigt ein Album Probleme (LED blinkt rot): Album öffnen. Dort stehen die Probleme, und „Playlist aus den MP3-Dateien neu erzeugen“ schreibt die Titelliste neu.

7.2 Einen Tag verknüpfen

Ein Tag spielt, womit er verknüpft ist: ein Album, einen Radiosender (Abschnitt 8) oder einen Eintrag von Spotify (Abschnitt 9). Das Verknüpfen geht bei allen dreien gleich.

Neuer Tag:

1. Tag auf die Box legen. Die LED leuchtet gelb.
2. Tab „Jetzt“: Unter „Unbekannter Tag aufgelegt“ das Album, den Sender oder den Eintrag von Spotify wählen.
3. „Verknüpfen & abspielen“. Es startet sofort.

Bekannter Tag:

• Tab „Tag-Verwaltung“, Spalte „Album / Sender“: ein anderes wählen, oder „— nicht verknüpft —“.
• Die Verknüpfung lösen geht auch im Tab „Jetzt“ („Verknüpfung lösen“ für den aufgelegten Tag) und im Album-Dialog (✕ am Tag). Der Fortschritt bleibt dabei erhalten.
• Einem Tag im Tab „Tag-Verwaltung“ einen Namen geben, z. B. „rote Katze“ – das erleichtert die Zuordnung.
• Einen Tag löschen: Tab „Tag-Verwaltung“. Sein Fortschritt geht mit verloren.

Mehrere Tags können dasselbe Album haben; jeder hat seinen eigenen Fortschritt.

Gibt es eine Bibliothek, lässt sich ein neuer Tag auch ohne Box anlegen: mit dem Telefon (Abschnitt 13.5).

7.3 Titelbilder

Ein Tag zeigt das Titelbild seines Albums, Senders oder Spotify-Eintrags, in den Tabs „Tags“, „Tag-Verwaltung“ und „Jetzt“. Ein Tag hat kein eigenes Bild: zwei Tags mit demselben Album zeigen dasselbe Titelbild, und ein Tag ohne Verknüpfung zeigt keines.

• Titelbild eines Albums: Tab „Alben“, das Album öffnen, „Titelbild ändern“ (Abschnitt 7.1).
• Titelbild eines Senders: Tab „Radio“, auf das Bild vor dem Sender klicken (Abschnitt 8).
• Titelbild eines Spotify-Eintrags: Es kommt von Spotify; im Tab „Spotify“ auf das Bild vor dem Eintrag klicken, um ein anderes zu wählen (Abschnitt 9).

7.4 Fortschritt

• Tab „System“, „Fortschritt je Tag“: die gespeicherte Stelle jedes Tags.
• „Fortschritte zurücksetzen“ setzt alle Alben auf den Anfang.
• Ein einzelnes Album beginnt von vorn mit „zurück“ 1 s halten an der Box oder „Album von vorn“ im Tab „Jetzt“.

8. Radio

Ein Tag kann statt eines Albums einen Internet-Radiosender spielen; dafür braucht die Box WLAN. Der Sender spielt, solange der Tag liegt; einen Fortschritt gibt es nicht. Sender anlegen und ändern braucht die Rolle admin; einen Tag verknüpft man mit einem Sender wie mit einem Album (Abschnitt 7.2).

1. Tab „Radio“, „Neuen Sender anlegen“: Name und Adresse eingeben.
2. „Testen“ spielt die Adresse eine Minute lang, auch bevor sie gespeichert ist. Das geht nur, solange kein Tag auf der Box liegt; wird einer aufgelegt, endet der Test.
3. „Anlegen“.
4. Tab „Tag-Verwaltung“: dem Tag den Sender zuordnen.

• Adresse: der Stream selbst (z. B. https://…/stream.mp3) oder eine Playlist, die ihn nennt (.m3u, .pls, .m3u8). Sie beginnt mit http:// oder https://.
• Abbruch: Ist der Stream nicht erreichbar oder bricht er ab, verbindet die Box nach 1, 2, 5, 10 und dann alle 30 Sekunden neu. Die LED leuchtet so lange türkis. Der Tab „Jetzt“ zeigt „Verbindung unterbrochen – neuer Versuch“; den Grund zeigt er, wenn der Mauszeiger darauf ruht.
• Start: Bis der Sender zu hören ist, wechselt die LED grün → türkis → blau. Die Box sammelt erst zwei Sekunden des Streams, damit kurze Lücken im WLAN nicht zu hören sind.
• Wird die Adresse eines Senders geändert, der gerade spielt, startet er mit der neuen Adresse.
• Titelbild: Im Tab „Radio“ auf das Bild vor dem Sender klicken und ein Bild wählen (JPEG, PNG oder WebP). Es ersetzt das bisherige und erscheint auch im Tab „Jetzt“ und bei den Tags des Senders.
• Ein Sender, der mit Tags verknüpft ist oder gerade spielt, lässt sich nicht löschen. Erst die Verknüpfung lösen.

Beispiele:

9. Spotify

Ein Tag kann ein Album, eine Playlist, ein Hörbuch oder einen Podcast von Spotify spielen. Er spielt wie ein Album: Er setzt fort, wo er aufgehört hat, „weiter“ und „zurück“ wirken. Dafür braucht es Internet, ein Spotify-Premium-Konto für den Key und ein eigenes Spotify-Konto für die Box. Konto, Player und Einträge einrichten braucht die Rolle admin; einen Tag verknüpft man mit einem Eintrag wie mit einem Album (Abschnitt 7.2).

Einmal je Box, Tab „Spotify“, Karten „Konto“ und „Player“:

1. Der Key: auf developer.spotify.com, Dashboard → „Spotify Soloist API Key“, angemeldet mit einem Premium-Konto. Unter „Konto“ einfügen und speichern. Die Box holt den Player von Spotify; „Player“ zeigt dann „Bereit“.
2. „Verbinden“, dann die Box innerhalb von fünf Minuten in der Spotify-App eines Handys im selben WLAN auswählen – angemeldet mit dem Spotify-Konto der Box. Die App zeigt sie unter „Geräte“ (das Lautsprecher-Symbol unter einem geöffneten Titel), mit ihrem Namen in der Bibliothek, sonst mit ihrem Hostnamen. Nach ein paar Sekunden meldet die App womöglich, dass die Verbindung nicht klappt: Die Box hat die Anmeldung übernommen und spielt noch nicht. „Konto“ zeigt „Verbunden seit …“.

Dann für jeden Eintrag:

3. In der Spotify-App: „Teilen“ → „Link kopieren“. Tab „Spotify“, „Neuen Eintrag anlegen“: den Link einfügen. Name und Titelbild kommen von Spotify; einen Podcast benennt man selbst.
4. „Testen“ spielt ihn eine Minute lang – nur solange kein Tag aufliegt.
5. Tab „Tag-Verwaltung“: dem Tag den Eintrag zuordnen.

• Ein eigenes Konto: Ein Spotify-Konto spielt immer nur an einem Ort. Die Box hat ein eigenes Konto (ein Familien-Abo hat sechs), damit ein Tag auf der Box niemandem die Musik anhält.
• Das Handy hat keinen Einfluss, solange ein Tag spielt: Was es auf der Box ändert, macht die Box rückgängig. Musik, die anderswo mit dem Konto der Box startet, pausiert die Box; „Play“ holt sie zurück.
• Fortsetzen: Spotify beginnt immer beim ersten Titel; die Box springt leise zum gespeicherten. Bei einer langen Playlist dauert das einige Sekunden; die LED leuchtet so lange türkis.
• Spotify-Lautsprecher: Ist „Spotify-Lautsprecher, solange kein Tag aufliegt“ eingeschaltet (Karte „Lautsprecher“), kann die Spotify-App des Kontos der Box auf der Box spielen, solange kein Tag aufliegt. Die Tasten der Box steuern es, ein Tag gewinnt. Die Lautstärke bleibt immer die der Box.
• Der Player von Spotify läuft 90 Tage nach seinem Build ab. Die Box sucht ab 30 Tagen davor selbst einen neuen; „Jetzt aktualisieren“ fragt sofort bei Spotify.
• Key und Anmeldung bleiben auf der Box: Sie sind nicht in der Bibliothek und nicht im Backup.

9.1 Adventskalender

Ein Adventskalender von Spotify mit 24 Figuren: Jede Figur ist ein Tag und gehört zu einem Türchen. Auf die Box gelegt, spielt sie ihren Kalender – ab dem 1. Dezember, Türchen für Türchen. Es gibt zwei Arten:

Einrichten (Rolle admin):

1. In der Spotify-App: „Teilen“ → „Link kopieren“ des Albums oder der Playlist.
2. Tab „Spotify“, „Neuen Adventskalender anlegen“: den Link einfügen, Art und Jahr wählen. „Erst ab seinem Tag“ ist eingeschaltet: Türchen 17 spielt ab dem 17. Dezember. Ausgeschaltet spielt jede Figur sofort – für einen Kalender vom Vorjahr.
3. Tab „Tag-Verwaltung“: jeder Figur ihr Türchen zuordnen („Türchen 1“ bis „Türchen 24“ unter dem Namen des Kalenders). Scannen mit dem Handy geht wie bei jedem Tag (Abschnitt 13.5).
4. Tab „Spotify“, „Die 24 Türchen“: zeigt die Figur jedes Türchens, die Türchen ohne Figur und wann jedes aufgeht.

• Eine Figur eines späteren Türchens spielt nichts, die LED blinkt gelb. Bleibt sie über Mitternacht liegen, startet sie von selbst, sobald ihr Tag beginnt. Ein offenes Türchen bleibt offen – auch nach dem Dezember und auch, wenn die Box ohne Internet war.
• Die Tasten wirken wie bei jedem Spotify-Eintrag. Bei einem Kapitel beendet „weiter“ es und „zurück“ springt an seinen Anfang – sie führen nie zu einem anderen Türchen.
• Auf dem Handy (Abschnitt 13.7) spielen die Figuren nach denselben Regeln, nach dem Datum des Handys.

10. Lautstärke begrenzen

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

Ä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.

• 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“.

1. „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.
2. 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.
3. 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.
4. 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).

12. Wenn etwas nicht funktioniert

Fehlersuche für Administratoren: Verwaltung, Abschnitt 9.

13. Bibliothek

Die Bibliothek ist ein Programm im Heimnetz, zum Beispiel auf dem NAS. Sie hält alle Alben, Tags, Radiosender und Titelbilder. Jede Box holt sich von dort, was ihr fehlt – und spielt auch ohne die Bibliothek, was sie schon hat. Eine Box ohne Bibliothek funktioniert wie bisher.

13.1 Was sich für die Box ändert

• Alle Boxen kennen dieselben Tags. Ein Tag, der an einer Box oder in der Bibliothek verknüpft wurde, spielt auf jeder Box.
• Alben kommen bei Bedarf. Liegt ein Tag auf einer Box, die das Album noch nicht hat, holt die Box es. Die LED wechselt dabei grün → türkis → blau, und die Box spielt, sobald der erste Titel da ist.
• Der Fortschritt gehört zur Box. Derselbe Tag spielt im Kinderzimmer an einer anderen Stelle weiter als in der Küche.
• Ohne WLAN geht nichts verloren. Was an einer Box geändert wird, gilt dort sofort und erreicht die Bibliothek, sobald die Box sie wieder erreicht. Ändern beide denselben Tag, gilt der Stand der Bibliothek.
• Der Platz auf der SD-Karte regelt sich selbst. Wird er knapp, löscht die Box die Dateien des Albums, das am längsten nicht gehört wurde. Die Bibliothek hat es weiter, und die Box holt es wieder, wenn der Tag aufgelegt wird.

13.2 Eine Box mit der Bibliothek verbinden

Rolle admin, Tab „System“, Abschnitt „Bibliothek“:

1. Die Adresse der Bibliothek eintragen, z. B. https://nas:8866.
2. Beim ersten Mal das Bootstrap-Passwort eintragen. Es wurde bei der Installation der Bibliothek festgelegt.
3. „Speichern“, dann die Box aus- und einschalten.

Danach zeigt der Abschnitt „verbunden“, und die Box erscheint auf der Seite der Bibliothek. Was die Box vorher schon hatte, wandert in die Bibliothek; Alben, die es dort schon gibt, werden erkannt und nicht doppelt angelegt. „Noch nicht bestätigt“ zählt die Änderungen, die die Bibliothek noch nicht übernommen hat. Bei „Diese Box“ steht der Name der Box; mit „Umbenennen“ daneben bekommt sie einen anderen, z. B. „Kinderzimmer“. Unter diesem Namen zeigt die Bibliothek sie.

Eine neue Box: Die Seite der Bibliothek zeigt dafür eine Zeile – Tab „Boxen“, Abschnitt „Box hinzufügen“, „Kopieren“. Raspberry Pi OS Lite (64 Bit) mit dem Raspberry Pi Imager auf die SD-Karte der neuen Box schreiben. Im Imager der Box einen eigenen Hostnamen geben, z. B. kueche; die Seite der Box ist dann https://kueche.local. Über SSH anmelden und die Zeile dort ausführen. Sie fragt nach dem Passwort des Benutzers admin der Seite der neuen Box und nach dem Bootstrap-Passwort, richtet alles ein und startet die Box einmal neu. Danach ist die Box verbunden und erscheint von selbst im Tab „Boxen“. Eine Box ohne Bibliothek wird genauso eingerichtet, aber mit einer anderen Zeile, von GitHub (curl -fsSL https://github.com/tgd1975/tinyjukebox/releases/latest/download/install.sh | sudo bash).

Verbindung lösen: „Verbindung zur Bibliothek lösen“ im selben Abschnitt. Die Box behält alles, was auf ihrer SD-Karte liegt – Tags, Alben, Sender, Fortschritte – und arbeitet danach für sich allein. Die Bibliothek wird dabei nicht gefragt; sie darf ausgeschaltet sein oder gar nicht mehr existieren. Vorher sagt die Seite, was verloren geht: Änderungen, die die Bibliothek noch nicht übernommen hat, kommen dort nicht mehr an, und Alben, die nicht vollständig auf der SD-Karte liegen, lassen sich nicht mehr holen. Mit „Abbrechen“ wartet man, bis die Box abgeliefert und geholt hat. Die Bibliothek zeigt die Box weiter, bis sie dort entfernt wird (Tab „Boxen“). Wieder verbinden geht wie beim ersten Mal, mit Adresse und Bootstrap-Passwort.

13.3 Die Seite der Bibliothek

Die Seite der Bibliothek sieht aus wie die einer Box, ohne „Jetzt“ und „Bluetooth“. Sie hat eigene Benutzer: Wer sich an einer Box anmelden kann, kann es dort nicht von selbst; ein Admin der Bibliothek legt die Benutzer in ihrem Tab „System“ an. Alben, Tags, Sender und Titelbilder verwaltet man dort wie in den Abschnitten 7 bis 9.

Im Tab „Alben“ ist ein Album mit „defekt“ markiert, wenn eine seiner MP3-Dateien kaputt ist: weil die Bibliothek die Datei nicht lesen kann oder weil eine Box beim Abspielen Fehler in ihr fand. Der Albumdialog nennt die Dateien. Ersetzt man die Datei, verschwindet die Markierung. Ist die Datei in Ordnung und war die Meldung einer Box falsch, entfernt ein Administrator die Meldung dort mit „Meldungen verwerfen“.

Diese Tabs hat nur die Bibliothek; den Tab „Statistik“ hat sie für alle Boxen:

13.4 Version der Box

Eine Box, die dafür eingerichtet ist, holt neue Versionen selbst aus der Bibliothek und probiert sie beim nächsten Einschalten aus. Funktioniert die neue Version nicht, läuft nach wenigen Sekunden wieder die vorige. Tab „System“, Abschnitt „Version“ (Rolle admin):

Notfall-Modus. Läuft keine der beiden Versionen der Box, wechselt die Box von selbst in den Notfall-Modus. Sie spielt nichts und zeigt keine Seite; alle 10 Minuten sucht sie eine Version, die sie installieren kann. Ein Administrator beendet ihn auf der Konsole: tinyjukebox-slot update --now installiert eine Version und startet sie, tinyjukebox-slot use a|b wechselt zu einer der beiden Versionen. tinyjukebox-slot status sagt, warum die Box im Notfall-Modus ist.

Ausgelassene Daten. Findet die Box einen beschädigten Eintrag oder einen, den eine neuere Version geschrieben hat und den diese Version nicht kennt, arbeitet sie ohne ihn und listet ihn im Abschnitt „Version“ unter „Ausgelassene Daten“ auf. Gelöscht wird davon nichts. In der Bibliothek zeigt der Tab „Boxen“ eine solche Box mit einem Hinweis.

Wechselt die LED zwischen rot, weiß, magenta und gelb, ist die Bibliothek zu alt für die Version der Box. Die Box spielt dann nichts. Abhilfe: die Bibliothek aktualisieren, an der Box „Zurück zur vorigen Version“, oder die Verbindung zur Bibliothek lösen (Abschnitt 13.2).

Eine Box ohne Bibliothek holt neue Versionen selbst: Einmal am Tag sieht sie bei GitHub nach, ob es ein neues Release gibt. „Quelle“ im Abschnitt „Version“ sagt, woher die Versionen kommen. Solange eine Box mit einer Bibliothek verbunden ist, kommt nichts von GitHub.

• Ein neues Release installiert die Box nicht sofort, sondern nach einer Wartezeit von drei Tagen: Folgt in der Zeit eine Korrektur, lädt sie nur diese. Der Abschnitt zeigt unter „Neu“ die Version und den Tag, an dem sie von selbst installiert wird. „Jetzt installieren“ wartet nicht.
• Installiert wird im Hintergrund; die neue Version startet beim nächsten Einschalten der Box.
• Mit „Updates: nachfragen“ lädt die Box nichts von selbst. Sie zeigt Administratoren oben auf jeder Seite „Version … ist verfügbar“, bis jemand antwortet: „Installieren“, oder „Überspringen“ – dann fragt sie erst beim nächsten Release wieder. „Was ist neu“ zeigt, was sich geändert hat. Mit „aus“ fragt die Box GitHub gar nicht.
• Bei der Anfrage erfährt GitHub die Adresse des Haushalts, sonst nichts: keinen Namen, keine Version, nichts davon, was gehört wurde.

13.5 Neue Tags mit dem Telefon scannen

Ein Android-Telefon mit NFC kann einen Tag lesen. So kommt ein neuer Tag in die Bibliothek, ohne dass man ihn auf eine Box legt.

1. Auf dem Telefon in Chrome die Seite der Bibliothek öffnen und anmelden.
2. Tab „Tag-Verwaltung“, unten bei „Neuen Tag anlegen“: „Tag scannen“. Beim ersten Mal fragt Chrome, ob die Seite NFC verwenden darf.
3. Den Tag an die Rückseite des Telefons halten. Die Seite zeigt den Tag mit seiner UID; ein neuer ist mit „neu“ markiert und der Bibliothek schon hinzugefügt.
4. Als admin gleich dort den Namen eintragen, das Album oder den Sender wählen. Das geht auch später in der Tabelle darüber, auf jedem Gerät.
5. Weitere Tags einfach nacheinander an das Telefon halten. „Scannen beenden“ hört auf.

Kann das Telefon oder sein Browser keine Tags lesen, sagt die Seite beim Tippen auf „Tag scannen“, woran es liegt. Auf einem iPhone geht es nicht.

Meldet die Seite, dass Chrome ihr kein NFC erlaubt, wurde die Frage von Chrome mit „Blockieren“ beantwortet oder NFC ist in Chrome für Websites ausgeschaltet. Erlauben: links neben der Adresse auf das Symbol tippen, dann „Berechtigungen“ und „NFC-Geräte“. Fehlt der Eintrag dort: Chrome-Menü, „Einstellungen“, „Website-Einstellungen“, „NFC-Geräte“ – der Schalter muss an sein, und die Seite der Bibliothek darf nicht unter „Blockiert“ stehen.

• Die Boxen kennen den neuen Tag kurz darauf.
• Auf anderen geöffneten Seiten ändert sich nichts von selbst; der neue Tag steht im Tab „Tag-Verwaltung“, sobald man ihn öffnet.
• Scannen darf jeder angemeldete Benutzer, verknüpfen nur die Rolle admin.
• Der Tag wird nur gelesen. Auf einen Tag wird nie etwas geschrieben.
• Lesen können nur Chrome auf einem Android-Telefon und die App (Abschnitt 13.7). Auf dem PC fehlt der Knopf. Das Telefon muss entsperrt und die Seite im Vordergrund sein.

13.6 Backups der Bibliothek

Die Bibliothek hat im Tab „System“ dieselbe Karte „Backup“ wie eine Box (Abschnitt 11.1). Ihr Backup enthält den Katalog, die Fortschritte und Einstellungen aller Boxen, die Statistik und die Titelbilder der Alben und Sender, auf Wunsch auch die Alben.

Zusätzlich sichert sich die Bibliothek selbst, unter „Regelmäßig sichern“ (Abschnitt 11.2):

• Die Ordner sind Ordner auf dem NAS, z. B. /volume1/tinyjukebox/backups. Leer: der vorgegebene Ordner backups in der Freigabe tinyjukebox. Die Bibliothek muss in den Ordner schreiben dürfen.
• Jedes Backup mit MP3s belegt noch einmal so viel Platz wie alle Alben.
• Ein Backup wird wie auf einer Box zurückgespielt (Abschnitt 11.3). Die Boxen übernehmen den Katalog des Backups bei ihrer nächsten Synchronisierung.

13.7 Die App: ein Telefon als Box

Die App für Android-Telefone und -Tablets macht ein Telefon zur Box: Einen Tag an die Rückseite halten, und das Album spielt, dort, wo es aufgehört hat – auf diesem Telefon. Die Seite der Bibliothek bringt sie auch mit („Experte“).

Installieren. Auf der Seite der Bibliothek, Tab „Boxen“, Abschnitt „Telefon hinzufügen“: den Link zur App auf dem Telefon öffnen oder die Kamera des Telefons auf seinen QR-Code richten. Der Browser warnt einmal wegen des Zertifikats der Bibliothek, und Android fragt einmal, ob der Browser Apps installieren darf. Eine neue Version wird genauso installiert, über die alte.

Koppeln. Die App zeigt zuerst „Mit der Bibliothek koppeln“. Auf der Seite, Tab „Boxen“, „Telefon hinzufügen“: „Koppeln“ (als admin). Ein QR-Code erscheint, gültig einmal und 10 Minuten lang. In der App: „QR-Code scannen“ und die Kamera darauf richten. Das Telefon muss im Heimnetz sein. Danach steht es in der Tabelle der Boxen, als Telefon, mit dem Namen seines Modells – „Umbenennen“ gibt ihm einen Namen („Annas Telefon“).

Hören (einfacher Modus). Der Bildschirm ist die Box:

• Einen Tag an die Rückseite des Telefons halten: Sein Album spielt, dort, wo es auf diesem Telefon aufgehört hat. Tag wegnehmen: Stopp. Jedes Telefon hat seine eigenen Fortschritte, wie jede Box.
• Darunter stehen die Tags als Kacheln: eine antippen statt eines Tags; noch einmal antippen zum Aufhören.
• Das Band oben zeigt das Licht der Box (Abschnitt 3): grün bereit, blau spielt, weiß/blau Pause, grün → türkis → blau das Album wird geladen, gelb Tag ohne Album.
• Tasten: zurück (halten: Album von vorn), Abspielen/Pause, weiter – auch am Kopfhörer und auf dem Sperrbildschirm; „zurück“ halten geht aber nur in der App selbst.
• Der Bildschirm bleibt an und wird nach 30 Sekunden dunkel; eine Berührung holt ihn zurück. Geht der Bildschirm doch aus, spielt die Musik weiter; wieder an, sucht die App 2 Sekunden lang den Tag und hört auf, wenn er weg ist.
• Alben werden beim ersten Spielen geladen und bleiben auf dem Telefon (anfangs höchstens 4 GB). Bei den Großeltern spielt ohne Bibliothek, was zu Hause gespielt wurde.
• Lautstärke: die Tasten des Telefons. Auf der Seite der Bibliothek, beim Telefon im Tab „Boxen“, setzt „Lautstärke“, mit wie viel die App höchstens spielt, für Lautsprecher und Kopfhörer.
• Ein Tag von Spotify spielt in der Spotify-App des Telefons, dort, wo er aufgehört hat. Dafür muss die App einmal bei Spotify registriert sein und die Spotify-App auf dem Telefon mit einem dort eingetragenen Konto angemeldet; der Tab „Spotify“ der Bibliothek sagt, wie. Sonst sagt die App, dass der Tag auf einer Box spielt.

Experte. Der Knopf „Experte“ fragt nach der Anmeldung der Seite und zeigt dann die Seite der Bibliothek, wie im Browser; „Tag scannen“ in der „Tag-Verwaltung“ nimmt das NFC des Telefons. „Einstellungen der App“ zeigt den Namen, die Alben auf dem Telefon und ihre Grenze, die Versionen und „Kopplung lösen“. „Abmelden“ – auch nach 30 Minuten ohne Berührung – und „Einfacher Modus“ führen zurück zur Box, damit ein Kind nicht auf der Seite bleibt.

Tipps. Damit ein Kind in der App bleibt, sie mit der Bildschirmfixierung von Android anheften (Einstellungen des Telefons, „Sicherheit“). Ein verlorenes Telefon: auf der Seite, Tab „Boxen“, entfernen – sein Schlüssel gilt dann nicht mehr. Daten der App löschen oder sie neu installieren macht ein neues Telefon; „Alte Box übernehmen“ holt seine Fortschritte zurück.