Tune by Mozaiklabs

Solución de problemas

Los problemas más habituales y lo que puedes hacer al respecto. Si nada funciona, envía un informe desde Tune: contiene todo lo necesario para un diagnóstico.

La interfaz no se abre

  • Comprueba que Tune se está ejecutando: la ventana de consola en Windows, sudo systemctl status tune-server con el paquete .deb, sudo systemctl status tune en Tune OS.
  • La dirección es http://<server-address>:8888; en Tune OS, http://tune-XXXX.local o http://<IP-address>.
  • Tune OS recién instalado: el primer arranque dura de 15 a 30 minutos, con dos reinicios automáticos. Un equipo que ya responde por SSH no ha terminado necesariamente. El progreso se escribe en /var/log/tune-os-firstboot.log.
  • Windows, sin acceso desde otro dispositivo: el Firewall de Windows bloquea Tune en el perfil "Red privada". Permite tune-server.exe en las redes privadas en el Firewall de Windows. El mismo bloqueo impide también el descubrimiento DLNA.
  • Puerto ya en uso: elige otro puerto con TUNE_PORT (consulta Configuración). En Windows, desde la 1.0.0-rc2, volver a lanzar Tune desde su acceso directo mientras ya está en marcha simplemente abre la instancia en curso en el navegador.
  • Docker: el contenedor se reinicia en bucle (en un NAS, se detiene de forma inesperada): la carpeta montada en /data no admite escritura para el usuario tune (uid 1000). Es lo que ocurre con una carpeta creada por el propio Docker, como ./data. Sustitúyela por el volumen con nombre tune-data:/data (ver Primeros pasos), o dale esa carpeta al uid 1000: sudo chown -R 1000:1000 ./data. Después vuelve a ejecutar docker compose up -d.

Un dispositivo no aparece

  • El dispositivo y el servidor deben estar en la misma red (misma subred, misma VLAN). El descubrimiento usa multicast: SSDP (UDP 1900) y mDNS (UDP 5353).
  • Con Docker, usa network_mode: host.
  • Mira en Configuración › Audio › Dispositivos ignorados: puede que el dispositivo se haya ocultado.
  • Si el equipo tiene varias tarjetas de red (o una VPN), indica a Tune qué dirección anunciar con TUNE_ADVERTISED_IP.
  • Un LMS en el mismo equipo ocupa el puerto 3483, por lo que los reproductores Squeezebox no verán Tune.

Sin sonido

Salida local

  • Comprueba el Motor de audio en Configuración › Audio › Salidas de audio locales. En Windows, ASIO necesita el controlador del fabricante del DAC.
  • Otra aplicación puede estar reteniendo el DAC en modo exclusivo: ciérrala.
  • Linux (paquete .deb): el servicio se ejecuta con el usuario tune, que debe pertenecer al grupo audio.
  • Linux: en la 1.0.0-rc1, un escaneo ALSA/PipeWire bloqueado podía congelar Tune, que entonces había que reiniciar a mano. Desde la 1.0.0-rc2, ese bloqueo ya no congela el servidor. Si la salida de audio se sigue perdiendo, envía un informe desde Tune.
  • Equipo con un solo procesador: desde la 1.0.0-rc2, Tune mantiene siempre al menos 4 hilos de trabajo, para evitar los bloqueos de varios segundos que cortaban la reproducción local.

Dispositivo de red

  • Configuración › Audio › Diagnóstico de audio (nivel Experto) y la Ruta de la señal en la barra de reproducción muestran lo que se envía al dispositivo.
  • Comprueba que el dispositivo acepta el formato que se envía. Para DSD, prueba Auto o PCM (conversión) en Configuración › Dispositivos › Ajustes por zona.
  • Cortes en DSD 256/512 hacia un reproductor: Configuración › Audio › Reproducción DSD (reproductores de red), opción Streaming continuo. Después de actualizar a la 1.0, comprueba que esta opción sigue siendo la que elegiste.

Windows: ASIO vuelve a WASAPI al arrancar

Síntoma: ASIO está seleccionado, pero cuando Tune arranca solo aparecen salidas WASAPI (p. ej. "Altavoces"), o la reproducción se bloquea. La 1.0.0-rc2 corrige las dos causas conocidas de este cambio: Tune espera ahora a que termine la búsqueda de controladores ASIO antes de recurrir a WASAPI. Si aun así recurre a WASAPI, vuelve por sí mismo a ASIO en el siguiente escaneo de dispositivos, en cuanto no suena nada en una salida local.

  • Comprueba que Configuración › Audio › Salidas de audio locales › Motor de audio está en ASIO y que el controlador ASIO del fabricante está instalado.
  • Reinicia Tune.
  • Si Tune muestra Escaneo ASIO en pausa tras un fallo, ha desactivado el escaneo del controlador ASIO para evitar un bucle de fallos. Haz clic en Rearmar el escaneo ASIO y reinicia Tune.
  • Si el problema persiste, envía un informe desde Tune y menciona tu DAC y su controlador.

Tune OS: carátulas y fotos de artistas desaparecidas en la 1.0.0-rc1

En la 1.0.0-rc1, Tune OS buscaba la caché de carátulas en /opt/tune/data/artwork_cache, mientras que las versiones anteriores la habían guardado en /opt/tune/artwork_cache: casi todas las carátulas y fotos de artistas parecían perdidas. La 1.0.0-rc2 lo corrige. Al arrancar, Tune vuelve a la caché original y copia en ella lo que la rc1 había guardado en otro sitio, sin sobrescribir ni borrar nada. Basta, pues, con actualizar Tune. Si ya habías copiado las imágenes a mano, no hay nada que deshacer.

Biblioteca

  • Una carpeta añadida no aparece: la ruta debe existir en el equipo que ejecuta Tune y ser legible por la cuenta con la que se ejecuta Tune. Después del primer arranque, cambiar TUNE_MUSIC_DIRS no tiene ningún efecto: usa Configuración › Biblioteca › Ubicaciones.
  • Los cambios en un recurso compartido de red no se detectan: Tune revisa un recurso compartido cada 15 minutos. Para acelerarlo, vuelve a ejecutar Escanear la biblioteca.
  • El indicador de ReplayGain volvía al 0 % tras una actualización o un reinicio en la 1.0.0-rc1. Desde la 1.0.0-rc2, cuenta las pistas ya analizadas de toda la biblioteca.
  • Recurso compartido de red aún no disponible al arrancar: desde la 1.0.0-rc2, con un recurso SMB que monta él mismo, Tune espera al primer intento de montaje antes de analizar la biblioteca, y luego lo reintenta en segundo plano durante unos 5 minutos. Las carátulas ya no se borran mientras falta el recurso.
  • Una carátula ha cambiado tras la actualización: desde la 1.0.0-rc2, la imagen de la carpeta (p. ej. cover.jpg o folder.jpg) tiene prioridad sobre la carátula incrustada en los archivos. En una caja con una carpeta por disco, gana la imagen de la raíz de la caja. Una carátula que hayas subido nunca se sustituye.
  • Los análisis en segundo plano consumen demasiado del equipo: reduce Configuración › Audio › Velocidad del análisis en segundo plano, o ponlos en pausa desde Estado del servidor.

Servicios de streaming

  • Deezer: "ARL rechazado por Deezer" o una sesión perdida: abre deezer.com, obtén una nueva cookie arl y pégala en Configuración › Acceso y tokens › Servicios de streaming.
  • TIDAL, Qobuz: desconecta y vuelve a conectar el servicio en el mismo lugar.
  • YouTube: sin Activar la reproducción de YouTube, la búsqueda funciona pero la reproducción falla.
  • Spotify: en la 1.0 el catálogo se puede explorar pero no reproducir. Para conectar la cuenta, necesitas el Client ID de tu propia aplicación de Spotify (consulta Servicios de streaming).
  • Bandcamp: una pista relanzada varios días después desde la cola, el historial o un favorito puede no reproducirse, porque su dirección ha caducado. Desde la 1.0.0-rc2, el fallo queda anotado en el registro, y una zona Chromecast se detiene indicando el error en lugar de quedarse muda. Vuelve a lanzar la pista desde la página de su álbum.

Enviar un informe desde Tune

Abre Soporte en la parte inferior de la barra lateral.

Notificar un error (pestaña Diagnósticos)

Abierto a todos, sin necesidad de licencia. Describe Qué ocurre, añade capturas de pantalla si es útil y haz clic en Enviar al foro. Tu texto, los diagnósticos y los registros recientes del servidor van a un hilo moderado del foro. Las rutas personales se eliminan del informe, y Ver el informe adjunto te lo muestra antes de enviarlo.

Si Tune responde con un mensaje de límite de envíos, a veces incluso en el primer intento (un problema conocido, notificado), usa Copiar el informe y pégalo en un nuevo tema del foro, o inténtalo de nuevo más tarde.

Escribir al soporte (pestaña Tickets)

Este formulario aparece cuando hay una licencia Tune Premium registrada. Tiene Asunto, Categoría, Zona afectada (opcional), Tu mensaje y Archivos adjuntos (hasta 5 archivos). Deja marcada la casilla Adjuntar los registros y el informe del sistema: sin ellos, un diagnóstico suele requerir varias rondas. Haz el seguimiento de tus solicitudes en la pestaña Tickets.

Registros

  • Configuración › Sistema › Estado del servidor (nivel Avanzado): Descargar registros, o Descargar diagnósticos (un ZIP con registros, diagnósticos y configuración, con las credenciales ocultas). El Nivel de registro se ajusta en el mismo lugar.
  • Archivos: consulta la tabla "Dónde se guardan los datos" en Configuración.

Véase también