LauncherM3U. Un addon de Kodi para reproducir listas M3U con EPG

3

Una vez más aquí. Hoy vengo a dejar un pequeño artículo sobre un plugin que escribí antes de publicar Kidneys M3U: Un reproductor IPTV y YouTube para Linux y quizás para Windows. El caso es que este plugin fue antes que el programa Kidneys, ya que en principio la idea era solamente reproducir listas m3u de tv española que emitan en abierto … aun que al final me lié la manta a la cabeza. Pero bueno, creo que el plugin de vídeo LauncherM3U quedó lo suficientemente funcional como para publicarlo y que quien quiera lo modifique o mejore a su gusto. Por este motivo vamos a verlo en las siguiente líneas.

Si utilizas Kodi y usas con listas M3U (archivo local o URL remota), necesitas un addon que cargue rápido, no se quede congelado con miles de canales y muestre la programación cuando dispones de una guía EPG XMLTV. LauncherM3U (plugin.video.launcherm3u) es un addon de vídeo para Kodi pensado exactamente para eso. Cuenta con una interfaz tipo IPTV con grupos, canales, logos y ahora/siguiente, optimizada para listas grandes y con extras prácticos como favoritos, recientes, control parental con PIN y actualizaciones desde GitHub. Sé que todo esto lo hacen también los clientes PVR como IPTV Simple Client, pero la idea era hacer algo a mi gusto.

Como decía, a continuación vamos a ver qué es exactamente LauncherM3U, en qué se diferencia de un cliente PVR, qué funciones aporta la versión 1.3.1 y cómo instalar el addon en Kodi de forma correcta.

Qué es LauncherM3U y para quién está pensado

LauncherM3U es un plugin de vídeo escrito en Python para Kodi 19 Matrix o superior. Su objetivo es sencillo: abrir una lista M3U/M3U8, organizar los canales por grupos y reproducirlos con una experiencia cercana a un launcher IPTV, sin convertirte en administrador de un sintonizador PVR completo.

Es especialmente útil si:

• Tienes una lista M3U propia (archivo en el PC, NAS o USB) o una URL de lista.
• Quieres ver la guía EPG asociada (XMLTV, también comprimida en .gz).
• Manejas listas grandes (cientos o miles de canales) y necesitas caché, paginación y recargas en segundo plano.
• Prefieres un addon ligero, instalable desde ZIP, con código abierto en GitHub.

Addon de vídeo frente a cliente PVR: una distinción importante

Muchos usuarios buscan un “IPTV Simple Client para Kodi” y esperan la rejilla nativa de TV en vivo, pero:

• Un cliente PVR (como IPTV Simple) integra canales en la sección de televisión de Kodi y usa la guía EPG del sistema.
• LauncherM3U es un plugin de vídeo: la navegación y la EPG se muestran dentro del propio addon. La sensación de uso (grupos, canales, programa actual) es similar en simplicidad, pero no sustituye la API PVR.

Si tu prioridad es zapping rápido, vista previa y gestión de listas M3U sin configurar un backend PVR, LauncherM3U encaja mejor. Si necesitas la guía EPG global de Kodi en “TV en vivo”, deberás valorar un cliente PVR.

Características principales de LauncherM3U

Interfaz IPTV propia

Al abrir el addon verás un layout pensado para el salón: grupos a un lado, canales en el centro (con logo y, si hay EPG, el programa en emisión) y panel de detalle con ahora / a continuación. Un clic o OK inicia la vista previa embebida; la reproducción a pantalla completa lanza exactamente el canal activo, sin playlists confusas.

Listas M3U locales o por URL en LauncherM3U

Puedes cargar la lista desde:

• un archivo M3U local (recomendado usar el selector del propio addon), o
• una URL HTTP/HTTPS de playlist.

El parseo se hace línea a línea, con inserción por lotes en base de datos, pensado para no ahogar la memoria cuando la lista es enorme. Quizás en próximas versiones añada la posibilidad de juntar varias listas IPTV en un único listado …

Guía EPG XMLTV (también .gz)

Si activas la EPG, LauncherM3U admite fuente local o remota, incluyendo ficheros XMLTV comprimidos en .gz. Además puede aprovechar el atributo url-tvg de la cabecera M3U para asociar automáticamente la guía cuando la playlist lo declara. La interfaz muestra programa actual y siguiente, y puedes recargar sin perder la caché anterior si algo falla.

Rendimiento: SQLite, caché y listas grandes

El núcleo del addon usa caché SQLite, descargas con ETag/Last-Modified, publicación de la caché y lista incremental en la UI (no materializa todos los canales de golpe). La recarga puede ejecutarse en segundo plano, y hay opciones de recarga programada y poda de EPG antigua para no hinchar la base de datos.

Para listas grandes, valores orientativos:

Ajuste	Sugerencia
Canales por página	100–200
Horas de validez de la caché	12–24
Mostrar programa actual en lista	Activado si el EPG no es desmesurado

Favoritos, recientes y búsqueda en LauncherM3U

Marca canales como favoritos, vuelve a los recientes y localiza emisoras con la búsqueda integrada. El menú contextual del canal concentra acciones frecuentes sin salir de la interfaz.

Control parental con PIN

En hogares compartidos importa el control parental. Launcher M3U permite bloquear canales con un PIN (mínimo 4 dígitos). Al reproducir un canal bloqueado se solicita el código; tras validarlo hay una sesión de unos 30 minutos para no interrumpir el zapping. Desde ajustes puedes activar el control parental, cambiar el PIN o limpiar bloqueos.

Cabeceras HTTP, audio, subtítulos y streams HLS/DASH

Algunas listas o CDNs exigen User-Agent, Referer u otras cabeceras. El addon permite configurarlas de forma global. También ofrece selector de pistas de audio y subtítulos, y puede apoyarse en InputStream Adaptive cuando el stream es HLS/DASH (si tienes ese addon instalado).

Actualizaciones desde GitHub Releases

Desde la versión 1.3.1, Launcher M3U comprueba GitHub Releases del repositorio oficial. Puedes buscar actualizaciones a mano (con opciones para instalar ahora, abrir la página del release o posponer) o activar la descarga e instalación automática del ZIP de update. Solo se aceptan paquetes del repo oficial, para reducir riesgos de fuentes no confiables.

Cómo instalar LauncherM3U en Kodi (desde ZIP)

La forma recomendada de instalar un addon desde ZIP en Kodi es usar el paquete de release, no el botón “Code → Download ZIP” del repositorio (ese archivo es el código del proyecto, no el addon empaquetado, y suele fallar la instalación).

Pasos recomendados

1. Entra en la página de Releases y descarga el assetplugin.video.launcherm3u-x.y.z.zip (por ejemplo plugin.video.launcherm3u-1.3.1.zip).
2. En Kodi, activa si hace falta Orígenes desconocidos (Ajustes del sistema → Add-ons).
3. Ve a Add-ons → Instalar desde un archivo ZIP y elige el ZIP descargado.
4. Si una instalación anterior falló, cierra Kodi por completo y reintenta: el instalador a veces deja el estado inconsistente tras un ZIP incorrecto.

Instalación copiando la carpeta de LauncherM3U

También puedes copiar la carpeta plugin.video.launcherm3u a la ruta de addons de tu plataforma:

• Linux: ~/.kodi/addons/
• Windows: %APPDATA%\Kodi\addons\
• Android: Android/data/org.xbmc.kodi/files/.kodi/addons/

Después, en Mis add-ons → Add-ons de vídeo → LauncherM3U, actívalo y configura la lista.

Primer uso: configurar M3U y EPG

• Abre LauncherM3U.

• Configura la lista desde Ajustes o con el botón Archivo de la interfaz.
• (Opcional) Activa la EPG XMLTV e indica fichero o URL.
• Navega por grupos y canales; usa vista previa o pantalla completa.
• Recargar actualiza datos en segundo plano; si la descarga falla, se conserva la caché previa siempre que sea posible.
• Usa el menú contextual para favoritos, bloqueo con PIN, audio o subtítulos.

Si notas iconos o texturas antiguas, o cambias a menudo de lista, la sección de limpieza de caché (descargas, base de datos, thumbnails o limpieza completa) ayuda a dejar el addon en estado limpio sin reinstalar Kodi entero.

Requisitos técnicos

• Kodi 19 Matrix o posterior (Python 3).
• Opcional: InputStream Adaptive para aprovechar mejor HLS/DASH.
• Conexión a Internet si usas listas o EPG remotas y para comprobar updates en GitHub.

Licencia del proyecto: GPL-2.0-or-later. El código y las releases están en GitHub, lo que facilita auditar el addon, reportar issues y actualizar con paquetes firmados por el flujo de Releases.

Por qué destaca LauncherM3U

Hay muchos players de listas, pero Launcher M3U concentra varias decisiones de producto que importan en el día a día:

1. Enfoque en listas grandes (streaming de parseo, SQLite, UI incremental).
2. EPG usable dentro del addon, con soporte .gz y url-tvg.
3. UX de salón: preview, pantalla completa del canal activo, favoritos y recientes.
4. Hogar: control parental con PIN.
5. Mantenimiento: limpieza de caché y updates automáticos desde el repo oficial.

Si buscas un addon Kodi para listas M3U que no te obligue a montar un PVR completo, es una opción sólida, documentada y en evolución activa (versión actual de referencia: 1.3.1).

Preguntas frecuentes (FAQ)

¿LauncherM3U es lo mismo que IPTV Simple Client?

No. IPTV Simple es un cliente PVR. LauncherM3U es un plugin de vídeo con interfaz propia y EPG integrada en el addon.

¿Puedo usar una lista M3U8 o solo M3U?

Sí: el flujo está orientado a playlists M3U/M3U8 y a la reproducción de los streams que referencian (incluyendo escenarios HLS con InputStream Adaptive cuando aplica).

¿Dónde descargo el ZIP correcto?

En GitHub Releases, el archivo plugin.video.launcherm3u-….zip. Evita el ZIP genérico del botón Code de GitHub.

¿Las actualizaciones de LauncherM3U se instalan solas?

Puedes activar Descargar e instalar actualizaciones automáticamente en los ajustes del addon. En la comprobación manual también puedes elegir Instalar ahora.

¿Sirve LauncherM3U para Android TV, Windows y Linux?

Sí, siempre que ejecutes un Kodi compatible (19+). La ruta de addons cambia según el sistema, pero el ZIP de instalación es el mismo.

Conclusión

LauncherM3U es un addon de Kodi para reproducir listas M3U con una experiencia IPTV clara: grupos, canales, logos, EPG XMLTV, favoritos, control parental y un motor de caché pensado para listas grandes. Si quieres instalarlo hoy, descarga el ZIP oficial desde GitHub Releases, instálalo desde archivo en Kodi y configura tu playlist en pocos minutos.