Kidneysm3u

Aplicación de escritorio en Python/Tkinter para filtrar, reproducir y gestionar listas M3U/M3U8 e IPTV, además de YouTube, Twitch y Kick (directos, VOD y búsqueda), con VLC embebido y yt-dlp.

Warning

Este programa no incluye enlaces a ningún canal. Sí puede apuntar a listas públicas y legales que se encuentren en internet.

Inicio rápido

python3 run_app.py

Si no existe .venv, se crea solo e instala lo de requirements.txt. La primera vez tarda más. Instrucciones por sistema: instalación.

Documentación

Tema	Contenido
Índice	Mapa de toda la documentación
Instalación	Requisitos, Ubuntu, Windows, entorno virtual y actualizar el programa
Uso	Empezar: M3U, preferencias, YouTube, Twitch, Kick y biblioteca
Listas M3U	Carga, filtro y ordenación de listas
YouTube	Búsqueda, Shorts, playlists, cookies, yt-dlp y descargas
Reproductor	Controles, atajos, PiP, grabación, lista lateral, favoritos y bandeja
Notas	Detalles técnicos, tests, monitor de CPU y problemas conocidos

Cada página enlaza al resto y vuelve a este inicio. En el programa: Ayuda → Documentación (se lee en la propia ventana).

Qué puedes hacer

IPTV y listas

• Cargar y filtrar listas M3U/M3U8 locales o por URL (archivos grandes incluidos).
• Reproducir IPTV y ficheros directos con VLC embebido (zap por número de la lista).
• Ver la guía EPG en parrilla (ahora + unas horas), con logos de canal y recarga automática.
• Ajustar el buffer IPTV (rápido, equilibrado o estable) y grabar el stream en curso (ffmpeg).

YouTube, Twitch y Kick

• YouTube — buscar y reproducir vídeos, Shorts, listas y canales; cola; subtítulos; cookies y actualización de yt-dlp.
• Twitch — URL de directo/VOD/clip, búsqueda, VODs del canal, chat en vivo, favoritos, recientes y reanudación de VOD.
• Kick — URL de directo/VOD/clip, búsqueda, VODs del canal, favoritos, recientes, cookies y ayuda con Cloudflare (curl-cffi).

Biblioteca y sesión

• Favoritos → Biblioteca… — favoritos e historial de IPTV, YouTube, Twitch y Kick en un solo sitio, con filtros por sección y fuente.
• Historial y «seguir viendo» (VOD) desde el menú Reproducir → Historial.
• Exportar e importar favoritos; recordar la última lista lateral (sin autoplay).

Más

• Ventana PiP y reproductor siempre encima.
• Descargar vídeos o solo audio (ffmpeg).
• Ordenar listas M3U desde la interfaz.
• Preferencias: tema, volumen, descargas, cookies (YouTube/Twitch/Kick), calidad por plataforma, buffer IPTV, subtítulos, modo ligero y avisos de versión.
• Comprobar actualizaciones (Ayuda → Buscar actualizaciones) e instalar el .exe o el .deb desde GitHub Releases.

Guía rápida: uso. Detalle de listas: listas M3U. YouTube a fondo: YouTube.

Contribuir

Issues y pull requests son bienvenidos. Lee CONTRIBUTING.md, el código de conducta y SECURITY.md para vulnerabilidades.

Licencia

MIT License

---

Desarrollado con Python, ☕ y cada vez menos 🚬 por entreunosyceros.