
Introducción
Como usuario veterano de Debian 13 (Trixie), convivo a diario con esa frontera tan particular entre la estabilidad histórica del proyecto y la incorporación constante de nuevas bibliotecas, toolkits gráficos y drivers. En este terreno, la reproducción de vídeo deja de ser una simple cuestión de “doble clic” para convertirse en un ejercicio de ingeniería práctica: Qt 6, stacks multimedia basados en FFmpeg, aceleración por hardware mediante VA-API y resoluciones de nombres en streaming son piezas que deben encajar con precisión quirúrgica.
En mi caso, tras varias pruebas con distintos reproductores y algunos episodios frustrantes con enlaces URL que no se resolvían correctamente, terminé recalando en un puerto seguro: Haruna, un frontend moderno para MPV pensado específicamente para el ecosistema de KDE.
Lo que empezó como una simple prueba se convirtió en una migración definitiva, y de ahí nace esta crónica técnica: un recorrido completo por qué es Haruna, qué ofrece y cómo lo he desplegado con éxito en Debian 13 para reproducir desde archivos locales hasta vídeo en 4K desde la web.
¿Qué es Haruna?
Haruna no es un reproductor tradicional que implemente por sí mismo toda la lógica multimedia. Es, ante todo, una interfaz gráfica de código abierto construida sobre libmpv, la biblioteca que expone el potente motor del reproductor MPV.
Este enfoque tiene ventajas evidentes:
- Eficiencia extrema en consumo de recursos.
- Acceso a todas las capacidades avanzadas del motor MPV.
- Soporte inmediato para codecs modernos y flujos HLS/DASH.
- Posibilidad de heredar scripts y configuraciones profesionales.
Desarrollado en C++ y QML, Haruna se integra de forma natural en escritorios KDE Plasma: respeta los temas, el escalado HiDPI, las tipografías y el comportamiento de las ventanas. Para quien, como yo, busca coherencia visual y solidez técnica en un entorno Linux de producción, este detalle es decisivo.
Características que marcan la diferencia
Tras semanas de uso intensivo, estas son las funciones que terminaron por convencerme:
▶️ Integración nativa con yt-dlp
Haruna puede abrir enlaces directamente desde Internet. Basta pegar una URL y el programa invoca el extractor para convertirla en un flujo reproducible, sin pasar por descargas manuales.
📑 Gestión de capítulos y metadatos
Cuando el archivo o el stream los incluye, Haruna muestra una barra lateral con capítulos, permitiendo saltos rápidos entre secciones: ideal para conferencias técnicas o cursos grabados.
⚙️ Control total de MPV
Desde la interfaz se pueden definir parámetros avanzados, activar scripts externos y modificar opciones equivalentes a la línea de comandos de MPV, lo que lo convierte en una herramienta válida incluso para usuarios avanzados.
🚀 Aceleración por hardware inteligente
Detecta automáticamente los perfiles disponibles: VA-API en gráficas Intel o AMD, NVDEC en sistemas NVIDIA, o decodificación por CPU cuando es necesario. En mi portátil con Radeon Vega, VA-API descarga por completo al procesador incluso con vídeo 4K.
📂 Listas de reproducción dinámicas
Arrastrar carpetas completas, navegar sin salir de pantalla completa y reorganizar el orden de reproducción es trivial, algo que en sesiones largas de trabajo se agradece enormemente.
El proceso de instalación: construyendo los cimientos en Debian 13
Para que Haruna funcione sin fricciones en Trixie, no basta con instalar el paquete principal: conviene asegurarse de que todo el stack multimedia y gráfico está alineado.
🧱 Paso 1: instalar el núcleo del reproductor
Empiezo actualizando índices y desplegando Haruna junto a su motor:
$ sudo apt install haruna mpv libmpv2
Esto garantiza que el backend multimedia esté presente y listo para trabajar.
🌐 Paso 2: el cerebro de red (yt-dlp y FFmpeg)
Para que las URLs funcionen especialmente en plataformas de streaming es imprescindible contar con un extractor moderno y un FFmpeg completo:
$ sudo apt install yt-dlp ffmpeg
Aquí se produce una de las diferencias más claras respecto a instalaciones antiguas: yt-dlp sustituye definitivamente al veterano youtube-dl.
🖼️ Paso 3: soporte QML y la integración con el escritorio
En Debian 13 he comprobado que algunos problemas de renderizado y cuadros de diálogo se deben a la ausencia de módulos QML específicos. La solución es instalar explícitamente:
$ sudo apt install qml6-module-org-kde-desktop \
qml6-module-qtquick-controls \
qml6-module-qtquick-layouts
Este paso asegura que Haruna encaje visualmente en Plasma y que los componentes gráficos se posicionen correctamente en escena.
Configuración post-instalación: afinando el sistema
Una vez lanzado por primera vez, realizo siempre dos ajustes clave.
🔗 Enlace simbólico para compatibilidad
Algunas aplicaciones todavía buscan el nombre histórico del extractor. Para evitar procesos abortados prematuramente, creo este enlace:
sudo ln -sf /usr/bin/yt-dlp /usr/bin/youtube-dl
Con ello, cualquier llamada heredada funciona sin incidentes.
🖥️ Selección del método de decodificación

Desde Preferencias → Reproducción → Aceleración por hardware, selecciono VA-API en sistemas AMD o Intel.
Esto elimina advertencias relacionadas con CUDA en equipos sin GPU NVIDIA y maximiza la fluidez de reproducción.

Resumen
Instalar Haruna en Debian 13 es, para mí, una declaración de principios técnicos: apostar por la potencia bruta de MPV sin renunciar a la elegancia de Qt 6 y a la integración plena con KDE.
Instalar módulos QML concretos, verificar extractores modernos y afinar la aceleración gráfica, pero la recompensa es clara: uno de los reproductores multimedia más fluidos y completos disponibles hoy en GNU/Linux.
Si tu sistema puede reproducir archivos locales, con Haruna y una configuración adecuada puede reproducir también Internet entero… y hacerlo con solvencia profesional.
Referencias
Descubre más desde javiercachon.com
Suscríbete y recibe las últimas entradas en tu correo electrónico.




