1. Überblick

English

Für die Person, die zu Hause die Boxen und die Bibliothek einrichtet und betreibt: mit einem Terminal, einem NAS oder einem PC und einem Browser. Was zu tun ist, Schritt für Schritt, und was dann passiert. Wie man die Box bedient und was die Webseite bietet, steht im Benutzerhandbuch; hier wird darauf verwiesen statt es zu wiederholen. Jedes Detail – jeder Befehl, jede Option, jede Datei – steht in den Entwickler-Dokumenten (docs/developer/, auf Englisch).

1.1 Was wo läuft

Was	Wo es läuft	Seite	Daten
Box	ein Raspberry Pi im Holzgehäuse	https://<Name der Box>.local, z. B. https://tinyjukebox.local	/srv/tinyjukebox/ auf ihrer SD-Karte
Bibliothek auf dem NAS	das Synology-Paket tinyjukebox-library	https://<nas>:8866	/var/packages/tinyjukebox-library/var/ und der freigegebene Ordner tinyjukebox
Bibliothek in Docker oder auf einem PC	das Image ghcr.io/tgd1975/tinyjukebox oder tinyjukebox-library --data ORDNER	https://<Rechner>:8866	das Volume /data oder der Ordner ORDNER
App	ein Android-Telefon: ein Telefon als Box oder die Seite der Bibliothek	–	auf dem Telefon (Benutzerhandbuch, Abschnitt 13.7)

Eine Box arbeitet für sich allein. Mit einer Bibliothek teilen sich die Boxen Alben, Tags, Sender und Titelbilder, und die Bibliothek merkt sich den Fortschritt jeder Box (Benutzerhandbuch, Abschnitt 13). Eine Box ohne Bibliothek holt neue Versionen ihrer Software von GitHub, eine Box mit Bibliothek aus der Bibliothek.

1.2 Rollen

• admin darf alles: Alben, Tags, Sender, Benutzer, Backups, Versionen.
• user darf die Box bedienen – Status, Wiedergabe, Lautstärke, Tasten – und das eigene Passwort ändern; an der Bibliothek außerdem einen Tag durch Scannen bekannt machen.

Box und Bibliothek haben jede ihre eigenen Benutzer. Benutzer und Passwörter auf der Seite: Benutzerhandbuch, Abschnitt 11.

1.3 Die Dateien einer Box

Ordner	Inhalt
/srv/tinyjukebox/albums/	ein Ordner je Album: MP3-Dateien und playlist.m3u
/srv/tinyjukebox/json/	Tags, Alben, Sender, Fortschritte, Lautstärkegrenzen; images/: die Titelbilder
/srv/tinyjukebox/ssl/	Zertifikat der Seite und users.yaml, die Benutzer
/srv/tinyjukebox/log/	tinyjukebox.log, das Log der Box
/srv/tinyjukebox/slots/, current	die Versionen der Box-Software und die, die gerade läuft
/srv/tinyjukebox/state/	welche Version läuft und warum; history.log, eine Zeile je Wechsel
/srv/tinyjukebox/identity/, sync/	der Schlüssel der Box und die Adresse ihrer Bibliothek; was sie mit der Bibliothek austauscht
/srv/tinyjukebox/spotify/	Schlüssel, Player und Anmeldung von Spotify
/srv/tinyjukebox/config/	tinyjukebox.yaml, falls es sie gibt (Abschnitt 8)

Alles gehört dem Benutzer der Box, auf unserer Box pi. Die vollständige Liste: box.md, Abschnitt 6.