Risoluzione dei problemi
I problemi più comuni e la loro soluzione. Se il tuo non c’è, apri una segnalazione su GitHub allegando il file di log.
Aggiornata per la versione 0.4.3
Documentazione
All’installazione
| Problema | Soluzione |
|---|---|
| «PC protetto da Windows» | Fai clic su «Ulteriori informazioni», poi su «Esegui comunque». L’installer non ha una firma commerciale. |
| macOS rifiuta di aprire l’app | Impostazioni di Sistema → Privacy e sicurezza → «Apri comunque». |
| «“RustMusic” è danneggiato» | Nel Terminale: xattr -cr /Applications/RustMusic.app |
| «GLIBC_2.39 not found» | Installa la versione di compatibilità glibc 2.35 (pagina Download). |
| L’AppImage non si avvia | Rendila eseguibile (chmod +x) e installa libfuse2. |
| L’interfaccia sfarfalla durante lo scorrimento (Linux) | Lascia DMA-BUF su «Auto» in Impostazioni → Aspetto → Opzioni avanzate, oppure disattivalo, poi fai clic su «Riavvia ora». |
| L’interfaccia è lenta (computer poco potente o macchina virtuale) | Scegli «Leggeri» in Impostazioni → Aspetto → Opzioni avanzate → Effetti visivi. La modifica è immediata. |
L’audio
- Niente audio in modalità esclusiva: forse un’altra applicazione sta già usando l’uscita. Chiudila, oppure torna alla modalità condivisa in Impostazioni → Audio.
- Il DAC mostra sempre la stessa frequenza: verifica che la modalità esclusiva sia attiva e che sia selezionata l’uscita giusta.
- Le altre applicazioni non hanno più audio: è l’effetto normale della modalità esclusiva su questa uscita; l’audio torna quando la riproduzione si ferma.
- Il badge non indica «Bit-perfect»: verifica una sorgente senza perdita, frequenza e canali supportati dal DAC, volume al 100 % e ReplayGain disattivato o neutro. «Esclusivo» indica solo un’uscita riservata.
- Linux, «Nessun accesso diretto a questa uscita» con un DAC USB: aggiorna RustMusic. Dalla 0.2.10 ritrova la scheda dietro l’uscita PipeWire anche quando PipeWire e ALSA la chiamano in modo diverso.
- Un brano salta o torna indietro durante la riproduzione (file su un disco di rete): corretto nella 0.2.10, la transizione ora attende che il brano sia completamente decodificato.
- All’avvio, la ripresa suonava qualche secondo di silenzio prima di ripartire: corretto nella 0.3.0, il brano riparte direttamente dalla posizione salvata.
- Un cambio di uscita o di modalità si applicava solo al brano avviato dopo: dalla 0.3.1 si applica subito, senza riavviare l’applicazione.
- Linux, modalità esclusiva: il DAC spariva dall’elenco delle uscite, che mostrava solo «Dummy Output». Corretto nella 0.3.1: resta nell’elenco, selezionato.
- Linux, nessun audio con il solo PipeWire (in particolare con il pacchetto Flatpak): corretto nella 0.3.1, RustMusic si collega al server audio in ogni caso.
Il DSD
- Il DAC mostra una frequenza PCM invece di «DSD»: attiva «DSD nativo (DoP)» e la modalità esclusiva, e verifica che il tuo DAC supporti il DoP.
- Rumore al posto della musica: il flusso DoP è stato modificato lungo il percorso. Verifica che nessun altro software applichi un equalizzatore o un effetto sull’uscita.
- Una pausa tra brani DSD: aggiorna RustMusic e controlla la riproduzione senza interruzioni in Impostazioni → Generale. Dalla 0.2.8, il DoP può proseguire senza pause sui tre sistemi; un cambio di formato può richiedere di riaprire l’uscita. La 0.2.9 corregge anche le code bloccate con DSD convertito in PCM.
La libreria
- I nuovi file non compaiono: fai clic su «Riscansiona». RustMusic non sorveglia le cartelle in modo continuo.
- Una cartella è contrassegnata «Non accessibile»: la condivisione di rete non è montata o il disco è scollegato. I suoi brani vengono conservati; ricollegala, poi riscansiona.
- Il NAS è stato rimontato con un altro nome (prima tramite il suo indirizzo, poi tramite il suo nome, o viceversa): RustMusic ritrova la stessa condivisione e propone di aggiornare la libreria; brani, playlist, preferiti e coda seguono.
- Una compilation ha solo la prima traccia: prima della 0.2.10, una compilation senza tag «artista dell’album» poteva perdere le altre tracce durante l’importazione. Aggiorna, poi avvia una nuova scansione.
- Nessuna copertina: «Recupera copertine» nel menu «Gestisci» della libreria.
- Nessun testo: metti un file .lrc con lo stesso nome accanto al brano, oppure attendi che il testo sia disponibile su LRCLIB.
- Manca un artista ospite: Impostazioni → Archiviazione & dati → «Collegamenti degli artisti» → «Ripara».
- Due artisti compaiono come uno solo («Chris Brown/Nicki Minaj»): Impostazioni → Archiviazione & dati → «Verifica gli artisti multipli». Un gruppo è stato separato per errore: «Rivedi le correzioni», poi «Annulla».
- Manca un compositore nella vista Compositori: il suo nome non è nel tag compositore; completalo nell’officina dei tag.
Radio, podcast e server
| Problema | Soluzione |
|---|---|
| Nessuna pagina Radio o Podcast | Attivale in Impostazioni → Ascolto online: sono disattivate per impostazione predefinita. |
| Una radio suona ovattata | Il suo flusso è in AAC+ (badge «AAC+»): il decoder lo riproduce solo in qualità ridotta. Se la stazione ne offre un altro, sceglilo in «Qualità del flusso» nel menu «…». |
| «La stazione non risponde più» | La stazione ha interrotto il suo flusso, oppure la rete è rimasta giù troppo a lungo. RustMusic si riconnette da solo dopo una breve interruzione; altrimenti, riavvia la stazione. |
| «Anteprima non disponibile» | Il feed del programma non risponde al momento. Riprova più tardi, oppure aggiungi il programma tramite l’indirizzo del suo feed RSS. |
| Un programma non ha un feed | Alcuni programmi non pubblicano un feed RSS pubblico: RustMusic non può seguirli. |
| Un server è «Non raggiungibile» | Verifica che sia acceso e che l’indirizzo sia corretto in Impostazioni → Archiviazione & dati. I suoi brani mantenuti offline restano riproducibili. |
| Il server DLNA non viene trovato | Un server in Docker o su un’altra rete non si annuncia: aggiungilo tramite il suo indirizzo, per esempio http://127.0.0.1:8200. |
La rete: lettori, AirPlay e DLNA
| Problema | Soluzione |
|---|---|
| Nessun lettore di rete in «Uscita audio» | Attiva «Riproduci su un lettore di rete» o «Riproduci su un dispositivo AirPlay (v1)» in Impostazioni → Rete & DLNA: queste funzioni sono disattivate per impostazione predefinita. Verifica poi che il dispositivo sia acceso e sulla stessa rete locale (non il Wi-Fi ospiti), quindi fai clic su «Cerca». |
| Dispositivi non trovati con una VPN attiva | Aggiorna RustMusic: dalla 0.3.0 la ricerca parte da ogni scheda di rete e il server DLNA non si annuncia più nel tunnel. Se un dispositivo continua a mancare, verifica che la tua VPN lasci passare il traffico della rete locale. |
| Un dispositivo AirPlay non compare | Probabilmente è protetto da password o accetta solo AirPlay 2: RustMusic gestisce solo AirPlay 1, senza password. |
| Una breve pausa tra i brani su Sonos | È previsto: i Sonos concatenano i brani con una breve pausa. Sugli altri lettori la riproduzione resta senza pause. |
| Un file DSD rifiutato dal lettore di rete | Il dispositivo dichiara di non leggere questo formato, e RustMusic lo segnala invece di inviare il file. Ascoltalo su un’uscita del computer (DSD nativo o convertito in PCM). AirPlay non supporta ancora il DSD. |
| macOS 15: nessun dispositivo trovato, server DLNA invisibile | Autorizza RustMusic in Impostazioni di Sistema → Privacy e sicurezza → Rete locale. Senza questa autorizzazione, macOS blocca in silenzio la ricerca e il server. |
| Il dispositivo non vede il server di RustMusic | «Condividi in rete» attivo, stessa rete locale, firewall autorizzato e applicazione aperta. Alcuni router filtrano il multicast tra Wi-Fi ed Ethernet: controlla l’isolamento dei client nelle impostazioni del router. |
| L’amplificatore rifiuta la pausa o l’avanzamento sul server DLNA | Corretto nella 0.3.0: il server ora dichiara di accettarli. Aggiorna RustMusic. |
| L’amplificatore si ferma dopo il primo brano di un album servito da RustMusic | Corretto nella 0.3.1: il server DLNA descrive ogni brano e il numero reale di brani di un album o di una cartella. Aggiorna RustMusic. |
| Un file non si riproduce sul dispositivo | Forse il dispositivo non supporta il suo formato o la sua frequenza. |
Il telecomando dell’amplificatore
- «Nessun amplificatore trovato»: il telecomando controlla gli amplificatori Onkyo, Pioneer, Integra, Denon, Marantz e Yamaha. Verifica che l’amplificatore sia acceso o in standby di rete e sulla stessa rete del computer, poi fai clic su «Cerca» in Impostazioni → Telecomando. Su macOS 15 serve anche l’autorizzazione di accesso alla rete locale.
- L’amplificatore è «non raggiungibile»: RustMusic riprova ogni 5 secondi e lo ritrova da solo appena risponde, anche se ha cambiato indirizzo sulla rete.
- L’amplificatore non si spegne con un clic: è voluto. Tieni premuto il pulsante di accensione poco meno di un secondo, finché non si riempie di rosso.
Log e ripristino
RustMusic scrive un registro nella sottocartella logs della cartella dati (rustmusic.log). Dalla 0.2.9 include anche l’uscita scelta, la catena audio e le conversioni, oltre agli errori. Allegalo alle segnalazioni. «Cartella dati» in Impostazioni → Archiviazione apre questa cartella.
Come ultima risorsa, «Reimposta l’applicazione» riparte da uno stato nuovo. Ricordati di esportare prima le impostazioni e le playlist.
Per approfondire
Una domanda senza risposta?
Apri una segnalazione su GitHub: ogni riscontro aiuta a migliorare RustMusic e questa documentazione.