LinuxTutorial

Cómo solucionar las carátulas de Navidrome y Psysonic en DankMaterialShell (Linux)

Corrige el error Unsupported image format en DMS con CachyOS, Arch Linux, Fedora, Debian o Ubuntu.

Ilustración de Linux

Cómo solucionar las carátulas de Navidrome y Psysonic en DankMaterialShell (Linux)

¿DankMaterialShell muestra el nombre de la canción y el artista, pero deja vacía la portada del álbum? Si escuchas tu biblioteca de Navidrome mediante Psysonic en Linux, puede que el problema no esté en tu servidor ni en la aplicación: puede faltar soporte para formatos de imagen en Qt.

En mi equipo con CachyOS, Dux Shell (DMS) 2.0.0 y Quickshell 0.3.2, lo solucioné instalando un paquete y reiniciando DMS. Aquí explico cómo diagnosticar el mismo síntoma y qué instalar según tu distribución.

Psysonic reproduciendo música con la carátula visible en el panel Media de DankMaterialShell

Resultado real: DMS mostrando la carátula y los colores dinámicos del álbum desde Psysonic.

El problema: controles funcionales, carátula ausente

Psysonic mostraba correctamente la portada dentro de su propia interfaz. El panel Media de DMS reconocía el reproductor, el título, el artista, el álbum y la duración, pero en lugar de la carátula aparecía un icono musical genérico.

DMS obtiene los metadatos de reproducción mediante MPRIS, una interfaz de comunicación entre reproductores y el escritorio Linux. Una de sus propiedades es mpris:artUrl, que indica dónde encontrar la portada. No importa que la música venga de un servicio en línea o de un servidor Navidrome: lo importante es que el reproductor publique una imagen que el escritorio pueda leer.

1. Comprobar que Psysonic publica la carátula

Instala playerctl si no lo tienes y comprueba los reproductores disponibles:

bash
playerctl -l

Con música sonando en Psysonic, consulta sus metadatos:

bash
playerctl -p psysonic metadata
playerctl -p psysonic metadata mpris:artUrl

En mi caso devolvía una ruta local parecida a esta:

text
file:///home/usuario/.local/share/dev.psysonic.player/cover-cache/servidor.example/album/ID/800.webp

Si aparece una ruta file:// a un archivo .webp, Psysonic está anunciando una portada. Eso todavía no garantiza que DMS pueda decodificarla.

Comprobar el archivo en Fish (shell predeterminada en algunas instalaciones de CachyOS):

fish
set ART (playerctl -p psysonic metadata mpris:artUrl)
set FILE (string replace 'file://' '' -- "$ART")
file "$FILE"
xdg-open "$FILE"

Equivalente en Bash o Zsh:

bash
ART="$(playerctl -p psysonic metadata mpris:artUrl)"
FILE="${ART#file://}"
file "$FILE"
xdg-open "$FILE"

En mi equipo, el archivo era una imagen WebP de 800 × 800 píxeles y se abría correctamente en el navegador. Por tanto, la imagen original no estaba dañada.

2. Identificar el error en los registros de DMS

Ejecuta:

bash
journalctl --user -b --no-pager | grep -iE 'dms|quickshell' | grep -iE 'image|artwork|cover|webp|mpris|failed' | tail -40

En mi instalación aparecían mensajes similares a:

text
QML QQuickImage at @Widgets/MediaArtwork.qml: Error decoding:
file:///home/usuario/.cache/dms/imagecache/art_...: Unsupported image format

También aparecía:

text
WARN quickshell.colorquantizer: Failed to load image

Estos mensajes demostraban que DMS intentaba cargar la imagen desde su propia caché, pero el componente de Qt no conseguía interpretarla. No era necesario cambiar Navidrome ni convertir manualmente todas las portadas.

3. La solución en CachyOS y Arch Linux

Instala los formatos adicionales de imagen de Qt 6:

bash
sudo pacman -S qt6-imageformats

Reinicia DMS:

bash
dms restart

Vuelve a reproducir una canción desde Psysonic y abre DMS → Media.

Resultado en mi CachyOS: apareció la carátula inmediatamente, junto con el fondo dinámico que adopta los colores de la imagen.

qt6-imageformats fue la solución confirmada en mi equipo. El paquete añade plugins de formatos de imagen para Qt; en otras versiones de DMS o entornos, la causa de una carátula ausente puede ser diferente.

4. Comandos equivalentes para otras distribuciones

Si utilizas DMS en otra distribución y observas el mismo error de decodificación, puedes probar el paquete correspondiente:

DistribuciónComando
CachyOS / Arch / EndeavourOS / Manjarosudo pacman -S qt6-imageformats
Fedorasudo dnf install qt6-qtimageformats
Debian / Ubuntusudo apt update && sudo apt install qt6-image-formats-plugins

Después:

bash
dms restart

Los nombres de paquetes se verificaron en los repositorios oficiales. La reparación práctica se probó únicamente en CachyOS; no se garantiza que todas las instalaciones tengan exactamente la misma causa.

5. ¿Y si todavía no funciona?

  1. Confirma que playerctl -p psysonic metadata mpris:artUrl devuelve una URL.
  2. Abre el archivo original con xdg-open para descartar una imagen ausente o dañada.
  3. Revisa journalctl --user -b buscando Unsupported image format.
  4. Comprueba que el paquete de formatos de imagen está instalado y reinicia DMS.
  5. Si el error persiste, inspecciona el archivo específico que DMS menciona en el registro con file /ruta/al/archivo. No asumas que todas las imágenes de su caché están dañadas.

No recomiendo borrar toda la caché de DMS ni modificar los metadatos MPRIS como primer paso: en este caso no hizo falta.

Conclusión

Navidrome y Psysonic sí pueden mostrar carátulas en el dashboard nativo de DankMaterialShell. No es una función exclusiva de Spotify, Apple Music o YouTube Music.

En mi instalación el reproductor enviaba correctamente mpris:artUrl, pero DMS fallaba al decodificar la imagen. Bastó con:

bash
sudo pacman -S qt6-imageformats
dms restart

Sin scripts adicionales, sin modificar Navidrome y sin reemplazar Psysonic.


Entorno de la prueba: CachyOS · Dux Shell 2.0.0 · Quickshell 0.3.2 · Psysonic conectado a Navidrome. Prueba realizada el 1 de noviembre de 2026.

Referencias:

  • Arch Linux, paquete qt6-imageformats: https://archlinux.org/packages/extra/x86_64/qt6-imageformats/
  • Fedora, paquete qt6-qtimageformats: https://packages.fedoraproject.org/pkgs/qt6-qtimageformats/qt6-qtimageformats/
  • Debian, paquete qt6-image-formats-plugins: https://packages.debian.org/trixie/qt6-image-formats-plugins
  • Ubuntu, paquete qt6-image-formats-plugins: https://packages.ubuntu.com/en/noble/qt6-image-formats-plugins
EL

Edward Lopez

IT Consultant y entusiasta del self-hosting. Me gusta entender cómo funcionan las cosas y compartir lo aprendido.

SIGAMOS LA CONVERSACIÓN

Preguntas, ideas y hallazgos.

0

Tu experiencia también cuenta.

Inicia sesión para participar en esta conversación.

Unirme

La conversación empieza contigo.

Busca en títulos, resúmenes y contenido.