Kidneys M3U: Un reproductor IPTV y YouTube para Linux y quizás para Windows

2

Una vez más aquí. Hoy vengo a dar una actualización a un pequeño problema llamado KidneysM3U que publiqué hace como un año. Este programa buscaba ofrecer a los usuarios una forma sencilla de filtrar y ordenar listas m3u, pero como Youtube y sus cosas siempre andan actualizándose, ya no funcionaba todo lo bien que debería. Por esa razón, en mi ratejos libres, he ido dándole un lavado de cara a Kidneys M3U, tanto a su interfaz como a la forma en la que obtiene los vídeos de Youtube y procesa las listas IPTV. Además de corregir algunas cosas que en su día me dejé en el tintero.

Este programa no deja de ser algo que he realizado por que mientras trabajo me gusta reproducir vídeos de Youtube o ver canales IPTV (legales) en el ordenador. Y la verdad es que nunca había encontrado ningún programa que me resultase útil y que fuese gratuito. Pero bueno, quiero aclarar que si buscas una solución gratuita para gestionar listas IPTV masivas y disfrutar de un reproductor versátil que integre reproducción de vídeo, contenidos en streaming y YouTube sin sobrecargar tu sistema, Kidneys M3U te puede ofrecer una interesante solución de código abierto para todo aquel que quiera.

Kidneys M3U

Tengo que decir que en mi casa solo tengo sistemas Linux, y solo lo he probado una vez en una máquina virtual de Windows. Por eso me parece importante aclarar que esto se ha desarrollado para ofrecer el máximo rendimiento tanto en entornos Linux (con soporte nativo para Ubuntu, Debian, XFCE o GNOME). En Windows, con las pocas pruebas que he realizado, esta aplicación también resuelve de raíz los problemas más comunes de los reproductores convencionales: bloqueos al cargar archivos pesados, fallos en las guías EPG y complicaciones al manejar sesiones de vídeo.

Kidneys M3U hace uso del motor multimedia de VLC y de herramientas de procesamiento de streaming como FFmpeg y yt-dlp. Para garantizar que la aplicación funcione a la perfección desde el primer minuto, es imprescindible configurar correctamente estos componentes en el sistema operativo antes de lanzar la aplicación y comenzar a utilizarla.

En las siguiente líneas vamos a repasar sus características principales, arquitectura técnica, opciones de configuración y todo lo necesario para instalarla y que así cualquiera pueda sacarle el máximo partido.

¿Qué es Kidneys M3U?

Como decía, Kidneys M3U es una aplicación de escritorio diseñada para filtrar, organizar, gestionar y reproducir listas IPTV (M3U/M3U8) y contenido de YouTube desde una interfaz unificada.

A diferencia de otros reproductores multimedia que se congelan al intentar procesar archivos con decenas de miles de enlaces, Kidneys M3U utiliza procesamiento en segundo plano y multihilo. Esto significa que puedes buscar patrones, filtrar canales o cargar guías de programación mientras la interfaz sigue respondiendo de manera fluida y sin interrupciones.

Principales ventajas

• Procesamiento asíncrono real: El filtrado y parseo de listas no bloquea la interfaz de usuario (al menos en todas las pruebas realizadas).
• Integración nativa con YouTube: Búsquedas, listas de reproducción, reproducción de Shorts y soporte de sesión sin anuncios ni barreras.
• Soporte avanzado de Guía EPG (XMLTV): Mapeo inteligente de canales, parrilla de programación a 6 horas y descarga de logos en caché local.
• Rendimiento optimizado para listas gigantes: Probado con éxito en archivos de más de 2 millones de líneas gracias a su sistema de listado virtual.
• Organizador visual M3U: Editor gráfico integrado con función Drag & Drop (arrastrar y soltar) para reordenar listas sin necesidad de consola.

Filtrado y gestión de listas IPTV M3U / M3U8 con Kidneys M3U

Uno de los puntos fuertes de Kidneys M3U radica en su motor de lectura de listas. Permite trabajar de forma indistinta con archivos situados en el almacenamiento local o con URLs remotas de paneles IPTV.

Flujo habitual de trabajo:

[Entrada M3U / URL] ➔ [Patrón de Búsqueda] ➔ [Sobrescribir / Añadir] ➔ [Lanzar Reproductor]

1. Búsqueda y filtrado inteligente

Puedes aplicar filtros por país, nombre de canal o etiquetas específicas (como tvg-name o group-title). Los comentarios del archivo y los elementos basura se ignoran automáticamente. Además, el encabezado #EXTM3U (donde suele alojarse la dirección de la guía EPG) se preserva durante todo el filtrado para no perder la programación.

2. Pestañas y categorización automática

Cuando el archivo M3U contiene la etiqueta group-title, el reproductor organiza los canales mediante un sistema dinámico:

• Pocos grupos: Genera pestañas superiores de navegación rápida (por ejemplo: Deportes, Cine, Noticias).
• Muchos grupos: Habilita un menú desplegable interactivo para evitar la saturación visual.

3. Recuperación de enlaces IPTV (MPEG-TS y HLS)

Kidneys M3U integra reglas de resiliencia en la reproducción. Si un contenedor tipo .mkv o .mp4 procedente de un panel IPTV se interrumpe porque el servidor redirige el tráfico a otro formato, la aplicación reintenta la conexión automáticamente bajo el protocolo MPEG-TS, garantizando una emisión estable.

Sistema de EPG integrado: parrilla TV y miniaturas

El soporte de guía electrónica de programación (EPG) en Kidneys M3U no se limita a mostrar texto plano. La aplicación efectúa una asociación inteligente entre el listado M3U y las guías XMLTV (tanto locales en .xml/.xml.gz como remotas).

Mapeo inteligente de canales

Si la lista no incluye un identificador directo tvg-id, el sistema activa algoritmos de reserva para asociar el canal mediante tvg-name o comparando el nombre del canal con la etiqueta <display-name> del XMLTV.

Características de la EPG:

• Parrilla en tiempo real: Acceso mediante la tecla G o el menú principal a una vista de programación para las siguientes 6 horas.
• Recarga automática: La guía se actualiza en segundo plano cada 30 minutos sin interrumpir la reproducción.
• Gestión eficiente de logos: Las imágenes de canal (tvg-logo o <icon>) se descargan en una carpeta de caché local (epg_cache/). Para listas extremadamente masivas, existe la opción de desactivar la visualización de logos para acelerar el renderizado al instante.

Integración con YouTube: búsquedas, shorts y sesiones

El módulo de YouTube da a Kidneys M3U algo interesante, y por lo que empecé en su día a programar esta aplicación. Este módulo nos permitirá consumir contenidos de la plataforma sin depender de pesados navegadores web.

Experiencia de uso en YouTube desde Kidneys M3U

1. Búsqueda avanzada: Filtra directamente por Vídeos, Shorts, Playlists o Canales (los canales si los va a abrir en el navegador web por defecto del sistema). Permite delimitar resultados por fecha de publicación y duración.
2. Cola de reproducción sin interrupciones: Puedes buscar nuevos vídeos y añadirlos a la lista lateral mediante un clic secundario o la combinación Ctrl + Enter sin detener la reproducción actual.
3. Gestión de cookies y sesión: Compatible con la exportación de sesión vía browser-cookie3 o mediante archivos cookies.txt. El programa detecta de forma autónoma el estado de la sesión (OK o Caducada) y limpia tokens defectuosos para evitar bloqueos por parte de la plataforma.
4. Reanudación del punto de reproducción: Si cierras la aplicación o cambias de contenido, Kidneys M3U guarda el segundo exacto en el que te quedaste (tanto en vídeos de YouTube como en películas o series VOD), permitiéndote continuar más tarde.

Reproductor multimedia y rendimiento técnico

Basado en el motor de VLC embebido (python-vlc), el reproductor está preparado para ofrecer la máxima calidad sin comprometer los recursos del procesador.

Funcionalidad	Detalles de implementación
Decodificación	Decodificación por software optimizada (avcodec-hw=none) para prevenir fallos visuales o ruido en gráficas NVIDIA con VA-API.
Audio y doblaje	Gestión de pistas múltiples de audio para flujos IPTV/HLS y salidas configurables para ALSA y PulseAudio.
Subtítulos	Detección de subtítulos incrustados en emisiones IPTV/VOD y descarga automática de subtítulos oficiales y generados en YouTube.
Modo pantalla completa	Ocultamiento automático de controles e interfaz tras 3 segundos de inactividad.
Bandeja del sistema	Minimizado directo a la bandeja (system tray) para continuar escuchando emisiones de fondo sin ocupar espacio en la barra de tareas.

Atajos de teclado de Kidneys M3U

Todos los atajos de teclado se pueden encontrar en el menú superior de la aplicación. Para una navegación rápida y cómoda sin tocar el ratón, el reproductor incluye entre otros los siguientes atajos universales:

• Espacio / Clic en Vídeo: Reproducir / Pausar.
• F1 / Esc: Entrar o salir del modo pantalla completa.
• M: Activar o desactivar silencio (Mute).
• ← / →: Retroceder o avanzar 2 segundos en la reproducción.
• G: Abrir la parrilla de programación EPG.
• Ctrl + S / Ctrl + D: Añadir o quitar el canal activo de la lista de Favoritos.

Instalación y requisitos del sistema

Kidneys M3U está pensado y diseñado para ser ligero e independiente. En sistemas Linux, la instalación se realiza mediante paquete .deb o ejecutando el script principal en Python dentro de un entorno virtual aislado (.venv).

Requisitos previos e infraestructura del sistema

Antes de iniciar el proceso, repasamos los componentes clave que utiliza Kidneys M3U para funcionar:

Componente	Uso en Kidneys M3U	Linux (Ubuntu/Debian)	Windows (10/11)
Python 3.10+	Lenguaje ejecutor e interfaz gráfica (Tkinter)	Incluido o via apt	Instalador oficial
VLC Media Player	Motor de reproducción embebido (python-vlc)	vlc + python3-vlc	VLC 64-bit
FFmpeg	Procesado de descargas y conversión de flujos	ffmpeg	Binario en variable PATH
Node.js / Deno	Desafíos de extracción de YouTube (yt-dlp)	nodejs / deno	Node.js LTS

Método 1: Instalación de Kidneys M3U en Linux (Ubuntu / Debian / Mint)

En entornos Linux cuentas con dos formas de instalación: mediante el paquete nativo .deb (ideal para la mayoría de usuarios) o compilando/ejecutando desde el código fuente.

Opción A: Instalación mediante paquete .deb (recomendado)

Si usas Ubuntu, Linux Mint o Debian, la forma más rápida y limpia es instalar el archivo ejecutable .deb:

1. Descarga el paquete kidneysm3u_latest_amd64.deb desde la sección de Releases del repositorio.
2. Abre una terminal en la carpeta donde guardaste el archivo.
3. Ejecuta el siguiente comando para instalar la aplicación y resolver sus dependencias automáticamente:

sudo apt update
sudo apt install ./kidneysm3u_latest_amd64.deb

4. ¡Listo! Ya puedes lanzar la aplicación buscando Kidneys M3U en el menú de inicio de tu sistema o escribiendo kidneysm3u en la consola.

Opción B: Instalación desde el código fuente (modo desarrollo / otras distros)

Si usas distribuciones basadas en Arch Linux, Fedora, o prefieres ejecutar el código directamente, sigue estos pasos:

Paso 1: Instalar las dependencias del sistema operativo

Abre la terminal y ejecuta:

sudo apt update
sudo apt install python3 python3-pip python3-venv python3-tk vlc python3-vlc ffmpeg nodejs -y

Paso 2: Clonar el repositorio y ejecutar el gestor de arranque

Clona el proyecto y lanza el script run_app.py, el cual creará un entorno virtual aislado (.venv), instalará las librerías de Python requeridas y pondrá en marcha la interfaz:

Bash

git clone https://github.com/tu-usuario/kidneysm3u.git
cd kidneysm3u
python3 run_app.py

Nota para usuarios de GNOME Desktop: Si utilizas Ubuntu Desktop con la interfaz GNOME por defecto, instala la extensión AppIndicator para asegurar que el icono de la bandeja del sistema se visualice correctamente al minimizar la app:

sudo apt install gnome-shell-extension-appindicator

Método 2: Instalación de Kidneys M3U en Windows

Como he dicho líneas más arriba, solo he podido probar este programa (con éxito) en una máquina virtual con Windows 11. La instalación en Windows requiere un par de pasos adicionales para asegurarnos de que el sistema localice los ejecutables de VLC y FFmpeg.

1º Instalar Python 3

1. Descarga el instalador oficial de Python 3.10 (o posterior) desde python.org.
2. CRUCIAL: Durante el proceso de instalación, asegúrate de marcar la casilla «Add Python to PATH» antes de hacer clic en Install Now.

2º Instalar VLC Media Player (64-bits)

1. Descarga e instala VLC Media Player desde la web oficial de VideoLAN.
2. Asegúrate de instalar la versión de 64 bits si tu sistema operativo y tu versión de Python son de 64 bits (debe coincidir la arquitectura para que python-vlc pueda enlazar la librería libvlc.dll).

3º Instalar y configurar FFmpeg

1. Descarga el paquete compilado de FFmpeg (archivo Zip) desde fuentes oficiales como gyan.dev.
2. Extrae la carpeta comprimida en la raíz de tu disco duro, por ejemplo en C:\ffmpeg.
3. Añade la carpeta bin a las variables de entorno de Windows:
   • Busca en el menú inicio «Editar las variables de entorno del sistema».
   • Haz clic en Variables de entorno.
   • En Variables del sistema, selecciona Path y pulsa Editar.
   • Haz clic en Nuevo y añade la ruta: C:\ffmpeg\bin.
   • Guarda los cambios pulsando Aceptar.

4º Poner en marcha Kidneys M3U

1. Descarga el código fuente de Kidneys M3U o clónalo mediante Git.
2. Abre PowerShell o el Símbolo del sistema (CMD) en la carpeta de la aplicación.
3. Ejecuta el script de arranque inteligente:

PowerShell

python run_app.py

El script creará automáticamente el entorno virtual (.venv), instalará paquetes como yt-dlp, requests, pillow o psutil, e iniciará la aplicación sin complicaciones.

Resolución de problemas frecuentes en Kidneys M3U

1. Error: «VLC library not found» en Windows

• Causa: Generalmente ocurre si instalaste Python de 64 bits y VLC de 32 bits (o viceversa).
• Solución: Desinstala VLC e instala explícitamente la versión VLC 64-bit.

2. Error 413 o fallos al buscar/descargar en YouTube

• Causa: YouTube exige con frecuencia desafíos JavaScript que la librería yt-dlp debe resolver en tiempo real.
• Solución: Instala Node.js o Deno en tu equipo. yt-dlp detectará automáticamente el motor JavaScript del sistema y resolverá los retos sin fallos.

3. La pantalla se queda en negro en canales IPTV

• Causa: El enlace del servidor IPTV no está entregando señal o ha cambiado de formato.
• Solución: Kidneys M3U intentará retransmitir como flujos MPEG-TS. Si la emisión tampoco abre al pegar la URL directamente en VLC nativo, significa que la fuente de la lista está fuera de servicio o requiere autenticación/token actualizado.

Conclusión

Siguiendo esta guía deberías tener Kidneys M3U plenamente integrado en tu equipo. Disfrutarás de un centro de control ligero, fluido y capaz de procesar listas M3U masivas y contenidos de YouTube sin bloqueos de interfaz ni ralentizaciones.

Si buscas un reproductor que respete tus datos locales, no registre tus URLs ni tokens en servidores externos, gestione de forma nativa tus listas M3U por grandes que sean y te proporcione una experiencia unificada con YouTube Kidneys M3U te puede resultar útil (para mi caso de uso lo ha sido).

Todo el código de esta aplicación se encuentra publicado en el repositorio de GitHub en el que he alojado este proyecto.