Tune by Mozaiklabs

Fehlerbehebung

Die häufigsten Probleme und was Sie dagegen tun können. Wenn nichts hilft, senden Sie einen Bericht aus Tune: Er enthält alles, was für eine Diagnose nötig ist.

Die Oberfläche öffnet sich nicht

  • Prüfen Sie, ob Tune läuft: das Konsolenfenster unter Windows, sudo systemctl status tune-server beim .deb-Paket, sudo systemctl status tune unter Tune OS.
  • Die Adresse lautet http://<server-address>:8888; unter Tune OS http://tune-XXXX.local oder http://<IP-address>.
  • Frisch installiertes Tune OS: Der erste Start dauert 15 bis 30 Minuten, mit zwei automatischen Neustarts. Ein Rechner, der bereits über SSH antwortet, ist nicht unbedingt fertig. Der Fortschritt wird in /var/log/tune-os-firstboot.log protokolliert.
  • Windows, kein Zugriff von einem anderen Gerät: Die Windows-Firewall blockiert Tune im Profil „Privates Netzwerk“. Erlauben Sie tune-server.exe in der Windows-Firewall in privaten Netzwerken. Dieselbe Sperre verhindert auch die DLNA-Erkennung.
  • Port bereits belegt: Wählen Sie mit TUNE_PORT einen anderen Port (siehe Konfiguration). Unter Windows öffnet seit 1.0.0-rc2 ein erneuter Start über die Verknüpfung, während Tune bereits läuft, einfach die laufende Instanz im Browser.
  • Docker: Der Container startet immer wieder neu (auf einem NAS hält er unerwartet an): Der unter /data eingebundene Ordner ist für den Benutzer tune (uid 1000) nicht beschreibbar. Das gilt für einen Ordner, den Docker selbst angelegt hat, etwa ./data. Ersetzen Sie ihn durch das benannte Volume tune-data:/data (siehe Erste Schritte) oder übergeben Sie den Ordner der uid 1000: sudo chown -R 1000:1000 ./data. Starten Sie danach docker compose up -d erneut.

Ein Gerät wird nicht angezeigt

  • Gerät und Server müssen sich im selben Netzwerk befinden (gleiches Subnetz, gleiches VLAN). Die Erkennung nutzt Multicast: SSDP (UDP 1900) und mDNS (UDP 5353).
  • Verwenden Sie mit Docker network_mode: host.
  • Sehen Sie unter Einstellungen › Audio › Ignorierte Geräte nach: Das Gerät könnte ausgeblendet worden sein.
  • Hat der Rechner mehrere Netzwerkkarten (oder ein VPN), teilen Sie Tune mit TUNE_ADVERTISED_IP mit, welche Adresse es bekannt geben soll.
  • Ein LMS auf demselben Rechner belegt Port 3483, sodass Squeezebox-Player Tune nicht sehen.

Kein Ton

Lokaler Ausgang

  • Prüfen Sie das Audio-Backend unter Einstellungen › Audio › Lokale Audioausgänge. Unter Windows benötigt ASIO den Treiber des DAC-Herstellers.
  • Eine andere Anwendung könnte den DAC im Exklusivmodus belegen: Schließen Sie sie.
  • Linux (.deb-Paket): Der Dienst läuft als Benutzer tune, der zur Gruppe audio gehören muss.
  • Linux: In 1.0.0-rc1 konnte ein hängender ALSA/PipeWire-Scan Tune einfrieren, sodass es von Hand neu gestartet werden musste. Seit 1.0.0-rc2 friert ein solcher Hänger den Server nicht mehr ein. Wenn der Audioausgang trotzdem verloren geht, senden Sie einen Bericht aus Tune.
  • Rechner mit nur einem Prozessor: Seit 1.0.0-rc2 hält Tune immer mindestens 4 Arbeits-Threads vor, um Hänger von mehreren Sekunden zu vermeiden, die die lokale Wiedergabe unterbrachen.

Netzwerkgerät

  • Einstellungen › Audio › Audio-Diagnose (Ebene Experte) und der Signalpfad in der Wiedergabeleiste zeigen, was an das Gerät gesendet wird.
  • Prüfen Sie, ob das Gerät das gesendete Format akzeptiert. Probieren Sie bei DSD Auto oder PCM (Konvertierung) unter Einstellungen › Geräte › Einstellungen pro Zone.
  • Aussetzer bei DSD 256/512 an einen Renderer: Einstellungen › Audio › DSD-Wiedergabe (Netzwerk-Renderer), Option Kontinuierliches Streaming. Prüfen Sie nach dem Update auf 1.0, ob diese Option noch die von Ihnen gewählte ist.

Windows: ASIO fällt beim Start auf WASAPI zurück

Symptom: ASIO ist ausgewählt, aber beim Start von Tune erscheinen nur WASAPI-Ausgänge (z. B. „Lautsprecher“), oder die Wiedergabe hakt. 1.0.0-rc2 behebt die beiden bekannten Ursachen dieses Rückfalls: Tune wartet jetzt, bis die Suche nach ASIO-Treibern abgeschlossen ist, bevor es auf WASAPI zurückfällt. Fällt es trotzdem zurück, wechselt es beim nächsten Gerätescan von selbst wieder zu ASIO, sobald auf keinem lokalen Ausgang etwas spielt.

  • Prüfen Sie, ob Einstellungen › Audio › Lokale Audioausgänge › Audio-Backend auf ASIO steht und der ASIO-Treiber des Herstellers installiert ist.
  • Starten Sie Tune neu.
  • Zeigt Tune ASIO-Suche nach einem Absturz pausiert an, hat es die Suche nach ASIO-Treibern ausgeschaltet, um eine Absturzschleife zu vermeiden. Klicken Sie auf ASIO-Suche neu scharfschalten und starten Sie dann Tune neu.
  • Besteht das Problem weiter, senden Sie einen Bericht aus Tune und nennen Sie Ihren DAC und seinen Treiber.

Tune OS: Cover und Künstlerfotos in 1.0.0-rc1 verschwunden

In 1.0.0-rc1 suchte Tune OS den Cover-Cache in /opt/tune/data/artwork_cache, während frühere Versionen ihn in /opt/tune/artwork_cache abgelegt hatten: Fast alle Cover und Künstlerfotos schienen verloren. 1.0.0-rc2 behebt das. Beim Start greift Tune wieder auf den ursprünglichen Cache zurück und kopiert hinein, was rc1 anderswo abgelegt hatte, ohne etwas zu überschreiben oder zu löschen. Es genügt also, Tune zu aktualisieren. Wenn Sie die Bilder bereits von Hand kopiert hatten, müssen Sie nichts rückgängig machen.

Bibliothek

  • Ein hinzugefügter Ordner erscheint nicht: Der Pfad muss auf dem Rechner mit Tune existieren und von dem Konto lesbar sein, unter dem Tune läuft. Nach dem ersten Start hat eine Änderung von TUNE_MUSIC_DIRS keine Wirkung: Verwenden Sie Einstellungen › Bibliothek › Speicherorte.
  • Änderungen auf einer Netzwerkfreigabe werden nicht erkannt: Tune prüft eine Freigabe alle 15 Minuten. Um das zu beschleunigen, führen Sie Bibliothek scannen erneut aus.
  • Die ReplayGain-Anzeige sprang in 1.0.0-rc1 auf 0 % zurück, nach einem Update oder einem Neustart. Seit 1.0.0-rc2 zählt sie die bereits analysierten Titel der gesamten Bibliothek.
  • Netzwerkfreigabe beim Start noch nicht bereit: Seit 1.0.0-rc2 wartet Tune bei einer SMB-Freigabe, die es selbst einbindet, den ersten Einbindungsversuch ab, bevor es die Bibliothek analysiert, und versucht es danach etwa 5 Minuten lang im Hintergrund erneut. Cover werden nicht mehr entfernt, solange die Freigabe fehlt.
  • Ein Cover hat sich nach dem Update geändert: Seit 1.0.0-rc2 hat das Ordnerbild (z. B. cover.jpg oder folder.jpg) Vorrang vor dem in die Dateien eingebetteten Cover. Bei einem Box-Set mit einem Ordner pro Disc gewinnt das Bild im obersten Ordner des Box-Sets. Ein von Ihnen hochgeladenes Cover wird nie ersetzt.
  • Hintergrundanalysen beanspruchen den Rechner zu stark: Verringern Sie Einstellungen › Audio › Geschwindigkeit der Hintergrundanalysen oder pausieren Sie sie über Serverstatus.

Streaming-Dienste

  • Deezer: „ARL von Deezer abgelehnt“ oder eine verlorene Sitzung: Öffnen Sie deezer.com, holen Sie ein neues Cookie arl und fügen Sie es unter Einstellungen › Zugang und Token › Streaming-Dienste ein.
  • TIDAL, Qobuz: Trennen Sie den Dienst an derselben Stelle und verbinden Sie ihn erneut.
  • YouTube: Ohne YouTube-Wiedergabe aktivieren funktioniert die Suche, aber die Wiedergabe schlägt fehl.
  • Spotify: In 1.0 kann der Katalog durchsucht, aber nicht abgespielt werden. Um das Konto zu verbinden, brauchen Sie die Client-ID Ihrer eigenen Spotify-App (siehe Streaming-Dienste).
  • Bandcamp: Ein Titel, der Tage später aus der Warteschlange, dem Verlauf oder den Favoriten erneut gestartet wird, spielt möglicherweise nicht mehr, weil seine Adresse abgelaufen ist. Seit 1.0.0-rc2 wird der Fehler im Protokoll vermerkt, und eine Chromecast-Zone hält mit einer Fehlermeldung an, statt stumm zu bleiben. Starten Sie den Titel erneut von seiner Albumseite aus.

Einen Bericht aus Tune senden

Öffnen Sie Support unten in der Seitenleiste.

Einen Fehler melden (Reiter Diagnose)

Offen für alle, keine Lizenz erforderlich. Beschreiben Sie Was passiert, fügen Sie bei Bedarf Screenshots hinzu und klicken Sie dann auf An das Forum senden. Ihr Text, die Diagnose und die jüngsten Protokolle des Servers gehen in einen moderierten Forenthread. Persönliche Pfade werden aus dem Bericht entfernt, und Beigefügten Bericht anzeigen zeigt ihn Ihnen vor dem Senden.

Antwortet Tune mit einer Meldung zum Sendelimit, manchmal sogar schon beim allerersten Versuch (ein bekanntes, gemeldetes Problem), verwenden Sie Bericht kopieren und fügen Sie ihn in ein neues Thema im Forum ein, oder versuchen Sie es später erneut.

An den Support schreiben (Reiter Tickets)

Dieses Formular erscheint, wenn eine Tune-Premium-Lizenz registriert ist. Es enthält Betreff, Kategorie, Betroffene Zone (optional), Ihre Nachricht und Anhänge (bis zu 5 Dateien). Lassen Sie Protokolle und Systembericht anhängen angehakt: Ohne sie braucht eine Diagnose oft mehrere Runden. Verfolgen Sie Ihre Anfragen im Reiter Tickets.

Protokolle

  • Einstellungen › System › Serverzustand (Ebene Fortgeschritten): Protokolle herunterladen oder Diagnosen herunterladen (eine ZIP-Datei mit Protokollen, Diagnose und Konfiguration, Zugangsdaten maskiert). Die Protokollstufe wird an derselben Stelle festgelegt.
  • Dateien: siehe die Tabelle „Wo die Daten liegen“ unter Konfiguration.

Siehe auch