Versión pública del addon M3U IPTV para Stremio. Cada usuario configura su propia lista M3U y TMDB Key desde la página web del addon — sin necesidad de tocar código ni variables de entorno.
- El usuario abre la URL del addon en el navegador
- Llena el formulario con su URL de lista M3U y su TMDB API Key
- El addon genera una URL de instalación personalizada
- Pega esa URL en Stremio → listo
Cada usuario tiene su propia configuración completamente independiente y privada.
- Formulario de configuración web incluido
- Soporte para múltiples listas M3U
- Resolución automática de IDs IMDb vía TMDB al arrancar
- Fallback: resolución al abrir desde el catálogo
- Cache por usuario en memoria (se reconstruye al reiniciar)
- Buscador en el catálogo
- Múltiples streams por título
- Integración global con Stremio y Cinemeta
El addon resuelve los IDs de IMDb directamente en Render/Railway sin necesidad de modificar tu lista M3U manualmente. Al arrancar, lanza en segundo plano un proceso que recorre todas las películas y series y consulta TMDB para obtener su ID de IMDb real (tt...). Este proceso usa un límite de ~3 consultas por segundo para no rebasar el límite gratuito de TMDB. Según el tamaño de tu lista puede tardar varios minutos. Durante ese tiempo el catálogo ya está disponible y funciona normalmente. Si la pre-carga aún no ha llegado a un título concreto, el addon lo resuelve en el momento en que abres ese título directamente desde el catálogo "Mis Películas" o "Mis Series".
addon.js ← Servidor Express con formulario y lógica del addon
configure.html ← Pagina web de configuración
parse-m3u.js ← Parser de listas M3U
railway.json ← Configuración para deploy en Railway
render.yaml ← Configuración para deploy en Render
package.json ← Dependencias
README.md ← Esta guía
Elige la plataforma que prefieras:
Solo necesitas presionar un boton y listo, el deploy en automatico.
El servicio nunca se duerme por inactividad pero el plan gratuito incluye solo $5 de crédito al mes.
O manualmente:
- Ir a https://railway.app
- New Project → Deploy from GitHub repo
- Seleccionar tu fork
- Railway detecta automáticamente Node.js y corre
npm installynpm start - En Variables agregar si quieres un puerto fijo:
PORT = 7000 - Abrir la URL que Railway genera →
/configure
En render por el Blueprint es de pago pero tambien puedes hacerlo manualmente lo cual es gratuito, el plan gratuito es ilimitado, pero el servicio duerme tras 15 minutos de inactividad.
Pasos:
- Ir a https://render.com
- New + → Web Service
- Conectar GitHub → seleccionar tu fork
Build Command:
npm install
Start Command:
npm start
- Abrir la URL que Render genera
No necesitas configurar ninguna variable de entorno en Render — todo lo maneja el formulario del addon.
Cuando termine el deploy, abre:
https://tu-addon.railway.app/
https://tu-addon.onrender.com/
Llena el formulario con tu lista M3U y tu TMDB Key, genera tu URL e instala en Stremio.
Para que los IDs de IMDb se resuelvan automáticamente:
- Crea cuenta en themoviedb.org
- Ve a Settings → API
- Copia tu API Key gratuita
- Pégala en el formulario del addon
El addon guarda en memoria la lista y los IDs resueltos de cada usuario.
- El cache dura 6 horas — después se recarga la lista automáticamente
- Si el servidor se reinicia, el cache se borra y se reconstruye al primer request
- En el plan gratuito de Render el servicio duerme tras 15 minutos de inactividad
- Railway gratis: el servicio nunca duerme — el cache dura mucho más tiempo, pero tiene un límite de $5 de crédito al mes
Si prefieres tener los IDs resueltos desde el primer segundo sin esperar la pre-carga automática del addon, puedes usar el script clean-m3u.js
para procesar tu lista manualmente antes de subirla.
Este script:
- limpia títulos automáticamente
- detecta películas y series
- busca metadata usando TMDB
- agrega IMDb IDs reales (
tvg-id="tt1234567") - guarda progreso automáticamente
- permite continuar después sin perder avance
npm install axiosAbre:
clean-m3u.jsy reemplaza:
const API_KEY = "PON_TU_TMDB_API_KEY";por tu API real:
const API_KEY = "TU_API_KEY";Coloca tu lista M3U como:
lista.m3uLuego ejecuta:
node clean-m3u.jsEl script:
- guarda progreso automáticamente
- crea backups
- permite cerrar con
CTRL + C - continúa donde quedó la próxima vez
El script detecta automáticamente:
S01E01
S02E05
etcy usa el IMDb ID correcto de toda la serie.
Antes:
#EXTINF:-1 tvg-name="Breaking Bad S01E01",Breaking Bad S01E01Después:
#EXTINF:-1 tvg-name="Breaking Bad" tvg-id="tt0903747",Breaking BadDespués de agregar los IMDb IDs a tu lista local usando clean-m3u.js, necesitarás subir el archivo .m3u a un servicio que permita acceso mediante enlace directo.
El addon descargará automáticamente la lista desde esa URL cada vez que Render inicie.
Puedes alojar tu lista M3U en:
- GitHub Releases
- Dropbox
- Google Drive
- Servidor VPS
- Hosting web
- CDN
- Servidores IPTV propios
El addon necesita una URL que descargue el archivo directamente.
Ejemplo correcto:
https://servidor.com/lista.m3uEjemplo incorrecto:
https://drive.google.com/file/d/xxxxx/viewPorque esa URL abre una página web y NO el archivo directamente.
La forma más estable y sencilla de alojar tu lista M3U es usando GitHub Releases.
- Subir tu archivo:
lista-progress.m3ua tu repositorio.
- Ir a:
Releases → Create Release-
Adjuntar el archivo
.m3u -
Publicar la release
-
Copiar el enlace directo del archivo
Ejemplo:
https://github.com/usuario/repo/releases/download/iptv/lista-progress.m3uGoogle Drive también funciona, pero debes convertir el enlace compartido en un enlace directo de descarga.
Tu enlace normal se verá así:
https://drive.google.com/file/d/FILE_ID/viewDebes extraer el FILE_ID y convertirlo a:
https://drive.google.com/uc?export=download&id=FILE_IDEn Dropbox:
- Compartir archivo
- Copiar enlace
El enlace normalmente termina en:
?dl=0Debes cambiarlo por:
?dl=1o:
?raw=1para forzar descarga directa.
Cuando Render inicie:
- descargará automáticamente la lista
- parseará películas y series
- detectará streams
- agrupará episodios
- cargará IMDb IDs
- integrará los streams directamente en Stremio
| Archivo | Descripción |
|---|---|
lista.m3u |
Lista original (nunca se modifica) |
lista-progress.m3u |
Lista procesada con IMDb IDs |
lista-backup.m3u |
Backup automático |
Solo necesitas actualizar el archivo M3U remoto.
Render descargará automáticamente la lista al reiniciar el servicio.
Para reiniciar:
- Ve a Render
- Abre tu Web Service
- Presiona:
- Manual Deploy
- Deploy latest commit
| Problema | Solución |
|---|---|
| No aparecen películas | Verifica que la URL M3U sea directa y accesible |
| Los IDs no se resuelven | Verifica tu TMDB API Key en el formulario |
| Un título no aparece globalmente | Ábrelo desde el catálogo para forzar la resolución |
| Render tarda en responder | El plan gratuito duerme tras 15 min de inactividad |
| Se agotó el credito de Railway | El plan gratuito tiene $5/mes upgrade o cambia a render |