Häufige Fragen

Allgemein

Ist Tunetorch wirklich kostenlos?

Ja. Die selbstgehostete Plattform mit allen Grundfunktionen ist und bleibt kostenlos. Das optionale Pro-Abo erlaubt mehr Benutzerkonten und macht die Pflege bequemer: mit automatischen Infos aus dem Internet, mehr Farbschemata, einem eigenen Server-Namen und dem Umzug einer ganzen Bibliothek in einer Datei. Keine Audiofunktion hängt davon ab, und deine Musik bekommst du auch ohne Pro jederzeit wieder heraus.

Was bedeutet „selbstgehostet“?

Der Server läuft auf deiner eigenen Hardware, etwa auf einem Raspberry Pi, einem NAS oder einem kleinen Heimserver. Deine Musik und deine Daten bleiben dort.

Brauche ich technisches Wissen?

Für die Einrichtung genügt Docker. Die Installationsanleitung führt dich Schritt für Schritt durch, und die Beispiel-Konfiguration kannst du fast unverändert übernehmen.

Läuft das auf einem Raspberry Pi?

Ja, genau dafür ist Tunetorch gebaut. Scan, Import und Export gehen sparsam mit dem Speicher um und machen nicht zu viel gleichzeitig. So bleibt die Oberfläche auch bei großen Läufen bedienbar.

Welche Daten sammelt Tunetorch?

Keine. Es gibt weder Tracking noch Telemetrie, und deine Daten bleiben auf deinem Server. Nach draußen verbindet sich der Server nur für drei Funktionen, die du selbst auslöst und die alle Pro voraussetzen: die Internet-Bildsuche, die MusicBrainz-Anreicherung und die Lizenzprüfung. Dazu kommt eine, die du selbst einschaltest: Nutzt du das CD-Rippen, prüft der Server gelesene CDs gegen die AccurateRip-Datenbank. Dabei geht nur die Kennung der CD hinaus, und die Prüfung lässt sich getrennt abschalten. Ohne Pro und ohne CD-Rippen spricht dein Server mit niemandem. Was genau wohin geht, steht unter Sicherheit & Datensicherung.

Musik

Welche Formate werden unterstützt?

MP3, FLAC, AAC/M4A, OGG, Opus, WAV, AIFF und WMA. Für die Wiedergabe wandelt Tunetorch bei Bedarf auf dem Server nach Opus um, je nach gewählter Qualitätsstufe. Das Original bleibt dabei unverändert.

Wie bekomme ich meine Sammlung hinein?

Du kannst hochladen, eine bestehende Sammlung einmal importieren, einen Ordner einhängen und scannen lassen oder CDs direkt am Server rippen. Einen Vergleich der Wege findest du unter Bibliothek befüllen.

Wo wird meine Musik gespeichert?

Nur auf deinem eigenen Server, im Datenverzeichnis oder in deinem eingehängten Musikordner. Nichts davon landet in einer Cloud.

Verändert Tunetorch meine Dateien?

Einen eingehängten Musikordner liest Tunetorch immer nur, dort ändert sich nichts. Beim Upload und beim Sammlungs-Import legt Tunetorch eine eigene Kopie an und entfernt daraus die Tags (die Metadaten stehen dann in der Datenbank). Deine ursprüngliche Sammlung bleibt unverändert.

Warum sind manche Titel lauter als andere?

Das ist in gewachsenen Sammlungen normal. Tunetorch gleicht das mit der Lautheits-Normalisierung auf −16 LUFS aus, bei lauten und leisen Titeln. Gemessen wird beim Upload, und fehlende Werte holt der Server beim ersten Abspielen nach (in App, Browser und beim Casting). Wer nicht warten will, bis jeder Titel einmal dran war, lässt den Wartungs-Task „Lautheit messen“ einmal laufen. Das lohnt sich vor allem bei einem eingehängten Ordner, weil beim Einlesen nicht gemessen wird.

Geräte

Funktioniert die Wiedergabe im Hintergrund?

Auf Android zuverlässig mit der Android-App, die unabhängig vom Browser weiterspielt. Die PWA kann das auch, hängt dabei aber vom Energiesparmodus des Systems ab. Dort helfen Akku-Ausnahmen für den Browser.

Kann ich Musik offline hören?

In der Android-App ja. Titel, Alben oder alle Titel eines Interpreten lassen sich dauerhaft herunterladen, außerdem speichert die App schon gehörte Titel automatisch zwischen. Ohne Netz schaltet sich der Offline-Modus von selbst ein. Siehe App, PWA & Offline.

Kann ich auf meine Lautsprecher streamen?

Ja, über DLNA/UPnP, siehe Casting im Heimnetz. Casting ist ab Werk aus und muss kurz eingerichtet werden.

Gibt es eine iOS-App?

Keine eigene. Auf iOS installierst du Tunetorch als PWA über Teilen → Zum Home-Bildschirm. Dafür muss dein Server über HTTPS erreichbar sein.

Konten

Können mehrere Personen denselben Server nutzen?

Ja. Jedes Konto hat eigene Playlists, Favoriten, Einstellungen und Statistiken. Rechte vergibst du einzeln, siehe Benutzer & Rechte.

Kann ich Musik für Kinder einschränken?

Ja. Du kannst ein Konto als eingeschränkt markieren. Es sieht dann nur Musik, die ausdrücklich freigegeben ist, nach Genre, Interpret oder einzelnen Titeln. Die Freigabe pflegt ein zugeordneter Betreuer, nicht der Admin. Die Einschränkung prüft der Server selbst, sie lässt sich also nicht umgehen.

Ich habe das Admin-Passwort vergessen.

Ist ein anderes Konto der Besitzer des Servers, setzt er das Passwort in der Benutzerverwaltung neu — Admin-Konten darf nur er ändern. Sonst setzt du es auf dem Server zurück:

docker exec -it tunetorch tt admin-reset <Benutzername>

Das Konto hat danach wieder das voreingestellte Passwort, und beim nächsten Anmelden verlangt Tunetorch sofort ein neues. Einzelheiten unter Admin-Passwort zurücksetzen.

Betrieb

Wie sichere ich meine Daten?

Sichere regelmäßig das Datenverzeichnis (/app/data). Darin steckt alles: Datenbank, Musikdateien, Cover, Schlüssel. Eine Anleitung steht unter Sicherheit & Datensicherung.

Wie aktualisiere ich Tunetorch?

Mit docker compose pull und docker compose up -d. Änderungen an der Datenbank spielt Tunetorch beim Start selbst ein, deine Daten bleiben erhalten. Steht so eine Änderung an, legt der Server vorher eine Kopie der Datenbank an. Geht dabei etwas schief, spielst du sie mit tt db-einspielen zurück (siehe Sicherheit & Datensicherung). Ein eigenes Backup ersetzt das nicht, denn die Kopien liegen im selben Verzeichnis und enthalten nur die Datenbank.

Ich habe einen Fehler gefunden. Was nun?

Melde ihn bitte über das Kontaktformular (Rubrik Fehlermeldung) oder auf dem Discord-Server. Hilfreich sind die Tunetorch-Version (steht im Server-Status), was du gemacht hast und was dann passiert ist. Bei Problemen mit der Wiedergabe kannst du zusätzlich das Debug-Protokoll als Datei anhängen.

Etwas funktioniert nicht wie erwartet.

Die häufigsten Fälle mit Ursache und Lösung stehen unter Fehlerbehebung.