Tune by Mozaiklabs

Risoluzione dei problemi

I problemi più comuni e cosa puoi fare. Se nulla funziona, invia una segnalazione da Tune: contiene tutto il necessario per una diagnosi.

L'interfaccia non si apre

  • Verifica che Tune sia in esecuzione: la finestra della console su Windows, sudo systemctl status tune-server con il pacchetto .deb, sudo systemctl status tune su Tune OS.
  • L'indirizzo è http://<server-address>:8888; su Tune OS, http://tune-XXXX.local oppure http://<IP-address>.
  • Tune OS appena installato: il primo avvio dura da 15 a 30 minuti, con due riavvii automatici. Una macchina che risponde già via SSH non ha necessariamente finito. L'avanzamento viene scritto in /var/log/tune-os-firstboot.log.
  • Windows, nessun accesso da un altro dispositivo: Windows Firewall blocca Tune sul profilo "Rete privata". Consenti tune-server.exe sulle reti private in Windows Firewall. Lo stesso blocco impedisce anche il rilevamento DLNA.
  • Porta già in uso: scegli un'altra porta con TUNE_PORT (vedi Configurazione). Su Windows, dalla 1.0.0-rc2, riavviare Tune dal suo collegamento mentre è già in esecuzione apre semplicemente l'istanza in corso nel browser.
  • Docker: il container si riavvia in loop (su un NAS, si arresta in modo imprevisto): la cartella montata su /data non è scrivibile dall'utente tune (uid 1000). È il caso di una cartella creata da Docker stesso, come ./data. Sostituiscila con il volume con nome tune-data:/data (vedi Per iniziare), oppure assegna quella cartella all'uid 1000: sudo chown -R 1000:1000 ./data. Poi rilancia docker compose up -d.

Un dispositivo non compare

  • Il dispositivo e il server devono trovarsi sulla stessa rete (stessa sottorete, stessa VLAN). Il rilevamento usa il multicast: SSDP (UDP 1900) e mDNS (UDP 5353).
  • Con Docker, usa network_mode: host.
  • Controlla in Impostazioni › Audio › Dispositivi ignorati: il dispositivo potrebbe essere stato nascosto.
  • Se la macchina ha più schede di rete (o una VPN), indica a Tune quale indirizzo annunciare con TUNE_ADVERTISED_IP.
  • Un LMS sulla stessa macchina occupa la porta 3483, quindi i lettori Squeezebox non vedranno Tune.

Nessun suono

Uscita locale

  • Controlla il Backend audio in Impostazioni › Audio › Uscite audio locali. Su Windows, ASIO richiede il driver del produttore del DAC.
  • Un'altra applicazione potrebbe tenere occupato il DAC in modalità esclusiva: chiudila.
  • Linux (pacchetto .deb): il servizio viene eseguito come utente tune, che deve appartenere al gruppo audio.
  • Linux: nella 1.0.0-rc1, una scansione ALSA/PipeWire bloccata poteva congelare Tune, che andava quindi riavviato a mano. Dalla 1.0.0-rc2, questo blocco non congela più il server. Se l'uscita audio si perde ancora, invia una segnalazione da Tune.
  • Macchina con un solo processore: dalla 1.0.0-rc2, Tune mantiene sempre almeno 4 thread di lavoro, per evitare i blocchi di diversi secondi che interrompevano la riproduzione locale.

Dispositivo di rete

  • Impostazioni › Audio › Diagnostica audio (livello Esperto) e il Percorso del segnale nella barra di riproduzione mostrano cosa viene inviato al dispositivo.
  • Verifica che il dispositivo accetti il formato inviato. Per il DSD, prova Auto o PCM (conversione) in Impostazioni › Dispositivi › Impostazioni per zona.
  • Interruzioni nel DSD 256/512 verso un renderer: Impostazioni › Audio › Riproduzione DSD (renderer di rete), opzione Streaming continuo. Dopo l'aggiornamento alla 1.0, verifica che questa opzione sia ancora quella che avevi scelto.

Windows: ASIO ripiega su WASAPI all'avvio

Sintomo: ASIO è selezionato, ma all'avvio di Tune compaiono solo le uscite WASAPI (ad es. "Speakers"), oppure la riproduzione si blocca. La 1.0.0-rc2 corregge le due cause note di questo ripiego: Tune ora attende la fine della ricerca dei driver ASIO prima di ripiegare su WASAPI. Se ripiega comunque, torna da solo ad ASIO alla scansione successiva dei dispositivi, non appena nulla è in riproduzione su un'uscita locale.

  • Verifica che Impostazioni › Audio › Uscite audio locali › Backend audio sia impostato su ASIO e che il driver ASIO del produttore sia installato.
  • Riavvia Tune.
  • Se Tune mostra Scansione ASIO sospesa dopo un arresto anomalo, ha disattivato la scansione dei driver ASIO per evitare un ciclo di arresti anomali. Fai clic su Riarmare la scansione ASIO, poi riavvia Tune.
  • Se il problema persiste, invia una segnalazione da Tune e indica il tuo DAC e il suo driver.

Tune OS: copertine e foto degli artisti sparite nella 1.0.0-rc1

Nella 1.0.0-rc1, Tune OS cercava la cache delle copertine in /opt/tune/data/artwork_cache, mentre le versioni precedenti l'avevano salvata in /opt/tune/artwork_cache: quasi tutte le copertine e le foto degli artisti sembravano perse. La 1.0.0-rc2 corregge il problema. All'avvio, Tune torna alla cache originale e vi copia ciò che la rc1 aveva salvato altrove, senza sovrascrivere né cancellare nulla. Basta quindi aggiornare Tune. Se avevi già copiato le immagini a mano, non c'è nulla da annullare.

Libreria

  • Una cartella aggiunta non compare: il percorso deve esistere sulla macchina su cui gira Tune ed essere leggibile dall'account con cui Tune viene eseguito. Dopo il primo avvio, modificare TUNE_MUSIC_DIRS non ha alcun effetto: usa Impostazioni › Libreria › Posizioni.
  • Le modifiche su una condivisione di rete non vengono rilevate: Tune controlla una condivisione ogni 15 minuti. Per accelerare, esegui di nuovo Scansiona la libreria.
  • L'indicatore di ReplayGain tornava allo 0 % dopo un aggiornamento o un riavvio nella 1.0.0-rc1. Dalla 1.0.0-rc2, conta i brani già analizzati di tutta la libreria.
  • Condivisione di rete non ancora pronta all'avvio: dalla 1.0.0-rc2, per una condivisione SMB che monta da sé, Tune attende il primo tentativo di montaggio prima di analizzare la libreria, poi riprova in background per circa 5 minuti. Le copertine non vengono più rimosse finché la condivisione manca.
  • Una copertina è cambiata dopo l'aggiornamento: dalla 1.0.0-rc2, l'immagine della cartella (ad es. cover.jpg o folder.jpg) ha la precedenza sulla copertina incorporata nei file. Per un cofanetto organizzato con una cartella per disco, vince l'immagine nella radice del cofanetto. Una copertina che hai caricato non viene mai sostituita.
  • Le analisi in background usano troppe risorse della macchina: riduci Impostazioni › Audio › Velocità delle analisi in background, oppure mettile in pausa da Stato del server.

Servizi di streaming

  • Deezer: "ARL rifiutato da Deezer" o sessione persa: apri deezer.com, ottieni un nuovo cookie arl e incollalo in Impostazioni › Accesso e token › Servizi di streaming.
  • TIDAL, Qobuz: disconnetti e ricollega il servizio nello stesso punto.
  • YouTube: senza Attiva la riproduzione YouTube, la ricerca funziona ma la riproduzione fallisce.
  • Spotify: nella 1.0 il catalogo può essere sfogliato ma non riprodotto. Per collegare l'account serve il Client ID della tua app Spotify (vedi Servizi di streaming).
  • Bandcamp: un brano riavviato qualche giorno dopo dalla coda, dalla cronologia o da un preferito può non essere più riprodotto, perché il suo indirizzo è scaduto. Dalla 1.0.0-rc2, l'errore viene annotato nel registro, e una zona Chromecast si ferma segnalando l'errore invece di restare muta. Riavvia il brano dalla pagina del suo album.

Inviare una segnalazione da Tune

Apri Supporto in fondo alla barra laterale.

Segnalare un bug (scheda Diagnostica)

Aperta a tutti, senza bisogno di licenza. Descrivi Cosa succede, aggiungi schermate se utile, poi fai clic su Invia al forum. Il tuo testo, la diagnostica e i log recenti del server finiscono in una discussione moderata del forum. I percorsi personali vengono rimossi dalla segnalazione, e Vedi il rapporto allegato te la mostra prima dell'invio.

Se Tune risponde con un messaggio di limite di invio, a volte anche al primo tentativo (un problema noto, segnalato), usa Copia il rapporto e incollalo in un nuovo argomento sul forum, oppure riprova più tardi.

Scrivere al supporto (scheda Ticket)

Questo modulo compare quando è registrata una licenza Tune Premium. Contiene Oggetto, Categoria, Zona interessata (facoltativa), Il tuo messaggio e Allegati (fino a 5 file). Lascia spuntato Allegare i registri e la scheda di sistema: senza di essi, una diagnosi richiede spesso più scambi. Segui le tue richieste nella scheda Ticket.

Log

  • Impostazioni › Sistema › Stato del server (livello Avanzato): Scarica i log, oppure Scarica la diagnostica (uno ZIP con log, diagnostica e configurazione, credenziali mascherate). Il Livello di log si imposta nello stesso punto.
  • File: vedi la tabella "Dove si trovano i dati" in Configurazione.

Vedi anche