Ctrl K
ComunidadGuías…
GITHUB · ANALIZADO

masqueradarr

Agregador IPTV auto-hospedado que centraliza múltiples fuentes M3U/EPG en un catálogo único. Utiliza MongoDB para estado persistente, una SPA en Vue 3 y un proxy de video en Rust para resolución en tiempo real de streams autenticados o rotativos.

Ficha actualizada 27 sept 2026, 11:35 · upstream 27 sept 2026, 11:28 · release 0.1.22

Ver códigoProblemas y ayudaRepositorio ↗
00

Qué es masqueradarr

Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.

Masqueradarr es una plataforma auto-hospedada diseñada para consolidar fuentes dispersas de IPTV detrás de una identidad única de confianza. A diferencia de sus predecesores que escribían URLs estáticas, este sistema resuelve cada flujo en el momento del reproducción mediante un motor proxy en Rust (`masq-proxy`), lo que permite soportar fuentes autenticadas, tokens efímeros y espejos rotativos sin caducidad inmediata. La arquitectura separa el plano de control (Node.js/Express con MongoDB) del plano de datos (Rust), facilitando una gestión robusta de la latencia y la retransmisión.

CASOS DE USO
  • Centralización de múltiples proveedores IPTV (M3U) en una sola lista exportable para clientes externos.
  • Soporte para streams protegidos por autenticación o tokens temporales mediante proxy en vivo.
  • Gestión centralizada de guías electrónicas (EPG) con normalización de metadatos desde múltiples fuentes.
  • Observabilidad en tiempo real de consumo y rendimiento del sistema vía WebSocket.
  • Exportación de playlists M3U/XMLTV para clientes externos como Plex o Jellyfin.
PUNTOS DESTACADOS
  • Arquitectura híbrida Node.js (control) + Rust (proxy de video) para bajo consumo de recursos.
  • Resolución de streams en tiempo real ('resolve-on-demand') que evita URLs muertas en disco.
  • Base de datos MongoDB para persistencia de estado y configuración dinámica.
  • Interfaz de usuario moderna en Vue 3 con gestión de usuarios y roles integrada.
  • Soporte nativo para fuentes autenticadas y espejos rotativos sin intervención manual.
PRECAUCIONES
  • No existe ruta de actualización in-place desde TVApp2; requiere instalación fresca y reimportación de fuentes.
  • El soporte para conversión remux (TS a HLS) en dispositivos HDHomeRun está pendiente de implementación completa.
  • Dependencia de MongoDB, lo que añade una capa de infraestructura adicional frente a soluciones de archivos planos.
VISUAL

Capturas del proyecto

Imágenes reales detectadas en la documentación del repositorio.

Captura de masqueradarrmasqueradarr primary architecture: browser and IPTV clients talk to the Express control plane, which owns MongoDB and drives the Rust masq-proxy data plane out to upstream IPTV souChannel adapter taxonomy: every adapter registered in registry.ts, grouped by shape — synthetic, authenticated, and the four anonymous resolve strategies (scrape, API sentinel, macLifecycle of a built-in source: provision, sync, normalize into sourcechannels, project into playlistchannels, afterSync writes guide data, and the SPA reaches playback through theFailover groups end to end: the group modal writes three fields on each channel doc and cascades the parentGuide composition: composeM3u hands its Active channel set to composeGuide, which selects (tvg_id, epg)-linked channels, emits the channel and programme elements, merges them into The internal seams: Rust calls Node over loopback POST /api/internal/* with a shared x-masq-secret for resolve, telemetry, log, and (edge mode only) authorize.Stream request flow: streamGate authorizes, proxyRelay forwards to the sidecar, an ENTRY request resolves a grant, upstream is fetched, and manifests are rewritten while segments a
01

Perfil de infraestructura

Estimación inicial derivada del repositorio y de los servicios detectados.

CPU4 vCPUrecomendación inicial
MEMORIA2 GBRAM estimada
DISCO20 GBalmacenamiento base
COMPLEJIDADmediumnivel de operación
02

Despliegue detectado

Qué señales reales de instalación hemos encontrado.

Listo para automatizar

Desplegar mediante Docker Compose utilizando la imagen oficial `iflip71/masqueradarr` o `aio`. Se requieren al menos 4 núcleos CPU y 2 GB RAM para el proxy Rust y la base de datos. Configurar backups automáticos del volumen MongoDB y restaurar índices periódicamente. Asegurar que el puerto 3000 esté abierto para la API y 27017 para MongoDB.

✓Dockerfile
✓Compose
✓One-click
03

Stack y dependencias

Componentes inferidos a partir de manifests, configuración y documentación.

FRAMEWORKS
Next.jsReactVueNode.jsRustPHP
SERVICIOS
MongoDB
BASES DE DATOS
MongoDB
PUERTOS
300027017
05

Puede sustituir a

Relaciones detectadas por el análisis del repositorio y su categoría.

06

Experiencia real de la comunidad

Ayuda a contrastar la estimación automática con instalaciones reales.

Todavía no hay datos comunitarios para este proyecto.