Solución de problemas
Los problemas más habituales y su solución. Si el tuyo no aparece, abre una incidencia en GitHub y adjunta el archivo de registro.
Actualizado para la versión 0.4.3
Documentación
En la instalación
| Problema | Solución |
|---|---|
| «Windows protegió su PC» | Haz clic en «Más información» y luego en «Ejecutar de todas formas». El instalador no tiene firma comercial. |
| macOS no deja abrir la app | Ajustes del Sistema → Privacidad y seguridad → «Abrir igualmente». |
| «“RustMusic” está dañado» | En el Terminal: xattr -cr /Applications/RustMusic.app |
| «GLIBC_2.39 not found» | Instala la versión de compatibilidad glibc 2.35 (página Descargas). |
| La AppImage no arranca | Hazla ejecutable (chmod +x) e instala libfuse2. |
| La interfaz parpadea al desplazarse (Linux) | Deja DMA-BUF en «Auto» en Ajustes → Apariencia → Opciones avanzadas, o desactívalo, y luego haz clic en «Reiniciar ahora». |
| La interfaz va lenta (equipo modesto o máquina virtual) | Elige «Ligeros» en Ajustes → Apariencia → Opciones avanzadas → Efectos visuales. El cambio es inmediato. |
El sonido
- Sin sonido en modo exclusivo: puede que otra aplicación ya esté usando la salida. Ciérrala, o vuelve al modo compartido en Ajustes → Audio.
- El DAC muestra siempre la misma frecuencia: comprueba que el modo exclusivo está activado y que está seleccionada la salida correcta.
- Las demás aplicaciones no tienen sonido: es el efecto normal del modo exclusivo en esta salida; vuelven a sonar al detener la reproducción.
- La insignia no muestra «Bit-perfect»: comprueba que la fuente sea sin pérdida, que el DAC acepte la frecuencia y los canales, que el volumen esté al 100 % y que ReplayGain esté desactivado o neutro. «Exclusivo» solo indica una salida reservada.
- Linux, «No hay acceso directo a esta salida» con un DAC USB: actualiza RustMusic. Desde la 0.2.10, encuentra la tarjeta detrás de la salida PipeWire aunque PipeWire y ALSA la llamen de forma distinta.
- Una canción salta o retrocede durante la reproducción (archivos en un disco de red): corregido en la 0.2.10, el encadenamiento ahora espera a que la canción esté completamente decodificada.
- Al arrancar, la reanudación reproducía unos segundos de silencio antes de seguir: corregido en la 0.3.0, la canción se retoma directamente en la posición guardada.
- Un cambio de salida o de modo solo se aplicaba a la canción siguiente: desde la 0.3.1, se aplica al instante, sin reiniciar la aplicación.
- Linux, modo exclusivo: el DAC desaparecía de la lista de salidas, que solo mostraba «Dummy Output». Corregido en la 0.3.1: se queda en la lista, seleccionado.
- Linux, sin sonido solo con PipeWire (sobre todo con el paquete Flatpak): corregido en la 0.3.1, RustMusic se conecta al servidor de sonido en todos los casos.
El DSD
- El DAC muestra una frecuencia PCM en lugar de «DSD»: activa «DSD nativo (DoP)» y el modo exclusivo, y comprueba que tu DAC es compatible con DoP.
- Ruido en lugar de música: el flujo DoP se ha modificado por el camino. Comprueba que ningún otro programa aplica un ecualizador o un efecto a la salida.
- Una pausa entre pistas DSD: actualiza RustMusic y comprueba la reproducción sin pausas en Ajustes → General. Desde la 0.2.8, el DoP puede encadenarse sin pausas en los tres sistemas; un cambio de formato puede requerir reabrir la salida. La 0.2.9 también corrige las colas bloqueadas con DSD convertido a PCM.
La biblioteca
- No aparecen archivos nuevos: haz clic en «Volver a escanear». RustMusic no vigila las carpetas de forma continua.
- Una carpeta aparece como «Inaccesible»: el recurso compartido de red no está montado o el disco está desconectado. Sus canciones se conservan; vuelve a conectarlo y luego vuelve a escanear.
- El NAS se ha montado de nuevo con otro nombre (por su dirección y luego por su nombre, o al revés): RustMusic reconoce el mismo recurso compartido y propone actualizar la biblioteca; canciones, playlists, favoritos y cola se conservan.
- Un recopilatorio solo tiene su primera pista: antes de la 0.2.10, un recopilatorio sin la etiqueta «artista del álbum» podía perder sus otras pistas al importarse. Actualiza y luego lanza un nuevo escaneo.
- Sin carátula: «Obtener carátulas» en el menú «Gestionar» de la biblioteca.
- Sin letra: coloca un archivo .lrc con el mismo nombre junto a la canción, o espera a que esté disponible en LRCLIB.
- Falta un artista invitado: Ajustes → Almacenamiento y datos → «Enlaces de artistas» → «Reparar».
- Dos artistas aparecen como uno solo («Chris Brown/Nicki Minaj»): Ajustes → Almacenamiento y datos → «Comprobar artistas múltiples». Un grupo se ha separado por error: «Revisar correcciones» y luego «Deshacer».
- Falta un compositor en la vista Compositores: su nombre no está en la etiqueta compositor; complétalo en el taller de etiquetas.
Radio, pódcasts y servidores
| Problema | Solución |
|---|---|
| No hay página Radio ni Pódcasts | Activa la radio y los pódcasts en Ajustes → Escucha en línea: están desactivados por defecto. |
| Una emisora suena apagada | Su flujo es AAC+ (insignia «AAC+»): el decodificador solo lo reproduce en calidad reducida. Si la emisora ofrece otro, elígelo en «Calidad del flujo» del menú «…». |
| «La emisora ya no responde» | La emisora ha cortado su flujo, o la red ha caído demasiado tiempo. RustMusic se reconecta solo tras un corte breve; si no, vuelve a poner la emisora. |
| «Vista previa no disponible» | El feed del programa no responde por ahora. Inténtalo más tarde, o añade el programa por la dirección de su feed RSS. |
| Un programa no tiene feed | Algunos programas no publican un feed RSS público: RustMusic no puede seguirlos. |
| Un servidor está «Inaccesible» | Comprueba que está encendido y que la dirección es la correcta en Ajustes → Almacenamiento y datos. Sus canciones guardadas sin conexión siguen pudiéndose reproducir. |
| No se encuentra el servidor DLNA | Un servidor en Docker o en otra red no se anuncia: añádelo por su dirección, por ejemplo http://127.0.0.1:8200. |
La red: reproductores, AirPlay y DLNA
| Problema | Solución |
|---|---|
| Ningún reproductor de red en «Salida de audio» | Activa «Reproducir en un reproductor de red» o «Reproducir en un dispositivo AirPlay (v1)» en Ajustes → Red y DLNA: estas funciones están desactivadas por defecto. Comprueba luego que el dispositivo está encendido y en la misma red local (no la wifi de invitados) y haz clic en «Buscar». |
| Dispositivos no encontrados con una VPN activa | Actualiza RustMusic: desde la 0.3.0, la búsqueda parte de cada tarjeta de red y el servidor DLNA ya no se anuncia dentro del túnel. Si un dispositivo sigue sin aparecer, comprueba que tu VPN deja pasar el tráfico de la red local. |
| Un dispositivo AirPlay no aparece | Seguramente está protegido con contraseña o solo acepta AirPlay 2: RustMusic solo admite AirPlay 1, sin contraseña. |
| Una breve pausa entre canciones en Sonos | Es lo esperado: los Sonos encadenan con una breve pausa. En los demás reproductores, la reproducción sigue sin pausas. |
| Un archivo DSD rechazado por el reproductor de red | El dispositivo declara que no reproduce ese formato, y RustMusic lo indica en lugar de enviar el archivo. Escúchalo en una salida del ordenador (DSD nativo o convertido a PCM). AirPlay todavía no admite el DSD. |
| macOS 15: ningún dispositivo encontrado, servidor DLNA invisible | Autoriza RustMusic en Ajustes del Sistema → Privacidad y seguridad → Red local. Sin ese permiso, macOS bloquea en silencio la búsqueda y el servidor. |
| El dispositivo no ve el servidor de RustMusic | «Compartir en la red» activado, misma red local, cortafuegos autorizado y aplicación abierta. Algunos routers filtran el multicast entre wifi y Ethernet: revisa el aislamiento de clientes en los ajustes del router. |
| El amplificador rechaza la pausa o el avance en el servidor DLNA | Corregido en la 0.3.0: el servidor indica ahora que los acepta. Actualiza RustMusic. |
| El amplificador se detiene tras la primera canción de un álbum servido por RustMusic | Corregido en la 0.3.1: el servidor DLNA describe cada canción y el número real de canciones de un álbum o de una carpeta. Actualiza RustMusic. |
| Un archivo no se reproduce en el dispositivo | Puede que el dispositivo no admita su formato o su frecuencia. |
El mando del amplificador
- «No se encontró ningún amplificador»: el mando controla los amplificadores Onkyo, Pioneer, Integra, Denon, Marantz y Yamaha. Comprueba que el amplificador está encendido o en reposo de red y en la misma red que el ordenador, y haz clic en «Buscar» en Ajustes → Mando. En macOS 15 también hace falta el permiso de acceso a la red local.
- El amplificador está «inaccesible»: RustMusic lo intenta de nuevo cada 5 segundos y lo recupera solo en cuanto responde, incluso si ha cambiado de dirección en la red.
- El amplificador no se apaga con un clic: es intencionado. Mantén pulsado el botón de encendido algo menos de un segundo, hasta que se llene de rojo.
Registro y restablecimiento
RustMusic escribe un registro en la subcarpeta logs de su carpeta de datos (rustmusic.log). Desde la 0.2.9, también incluye la salida elegida, la cadena de audio y las conversiones, además de los errores. Adjúntalo a tus incidencias. «Carpeta de datos» en Ajustes → Almacenamiento abre esa carpeta.
Como último recurso, «Restablecer aplicación» vuelve a un estado de fábrica. Recuerda exportar antes tus ajustes y playlists.
Para profundizar
¿Una pregunta sin respuesta?
Abre una incidencia en GitHub: cada comentario ayuda a mejorar RustMusic y esta documentación.