Saltar a contenido

M3U & EPG Manager

Desde esta sección puedes agregar y administrar tus cuentas M3U y tus EPGs.

M3U accounts

  • "Add" - Haz clic en el botón para agregar nuevas cuentas M3U.
    • Name - Un nombre para tu cuenta M3U.
    • URL - La URL M3U (no es obligatorio si estás subiendo un archivo M3U).
    • Account Type - Selecciona "Standard" para URLs M3U directas o "Xtream Codes" para servicios basados en panel.
    • Enable VOD Scanning - Activa o desactiva el escaneo de contenido VOD (solo disponible con el tipo de cuenta Xtream Codes).
    • Upload files - Si estás subiendo un archivo M3U local (no requerido si se usa una URL M3U).
    • Max Streams - Establece un número máximo de transmisiones simultáneas permitidas para tu cuenta. Para ilimitadas, configura el valor en 0.
    • User-Agent - Si deseas definir un User-Agent específico para esta cuenta.
    • Refresh Interval (hours) - Define cada cuántas horas se actualizará la URL M3U.
    • Stale Stream Retention (days) - Las transmisiones (streams) y grupos que no se detecten durante esta cantidad de días serán eliminadas. Para eliminarlas de inmediato, configura el valor en 0.
    • VOD Priority - Define la prioridad del proveedor VOD (números más altos = mayor prioridad). Se usa cuando varios proveedores ofrecen el mismo contenido.
    • Is Active - Activa o desactiva la cuenta M3U.

    Nota

    Los archivos M3U pueden agregarse automáticamente a Dispatcharr colocando los archivos M3U dentro de la carpeta /data/m3us, siempre que la opción Auto-Import Mapped Files esté habilitada en Settings > Stream Settings.

  • Puedes hacer clic en los encabezados de columna para cambiar el orden de clasificación de las cuentas M3U existentes.

  • Actions column

    • edit icon (ícono de edición) para editar la cuenta M3U asociada.

      • Botón "Filters" - Abre el administrador de filtros "Filters Manager".
        • Haz clic en "New" para agregar filtros. Los filtros se procesan en orden y, una vez que uno coincide, no se evalúan más reglas. Puedes cambiar el orden de los filtros usando el ancla de arrastrar y soltar a la izquierda de la regla, y editarlos o eliminarlos usando los íconos a la derecha.
          • Field: Selecciona el atributo de transmisión (stream attribute) que deseas filtrar: Group, Stream Name o Stream URL.
          • Regex Pattern: Ingresa una expresión regular válida (regular expression) para hacer coincidir el campo "Field".
          • Exclude: Activa o desactiva la opción para incluir o excluir resultados según la expresión regular.
          • Case Sensitive: Activa o desactiva la sensibilidad a mayúsculas y minúsculas para la expresión regular.
        • Selecciona "Save" para agregar el filtro recién creado.
        • Agrega filtros adicionales para refinar los valores del campo seleccionado según sea necesario.

      • Botón "Groups" - Abre el administrador de grupos "Group Manager".

        • Automatically enable new groups discovered on future scans - Cuando está desactivado, los nuevos grupos detectados desde la fuente M3U se crearán pero quedarán deshabilitados por defecto. Puedes habilitarlos manualmente más tarde.
        • Filtra los grupos visibles con la barra de búsqueda en la parte superior del administrador de grupos "Group Manager".
        • Ignora transmisiones (streams) de ciertos grupos deseleccionándolos.
        • Auto Channel Sync (solo para Live Groups): Cuando está habilitado, los canales se crearán automáticamente para todas las transmisiones (streams) del grupo durante las actualizaciones de M3U, y se eliminarán cuando ya no estén presentes.
          • Start Channel #: Establece un número de canal inicial para cada grupo a fin de organizar tus canales.
          • Advanced Options (Opciones Avanzadas):
            • Force Dummy EPG: Asigna un EPG ficticio al canal que coincida con el nombre del canal.
            • Override Channel Group: Define un grupo de canal diferente al seleccionado originalmente.
            • Channel Name Find & Replace (Regex): Busca y reemplaza para renombrar tus canales. Por defecto, el nombre del canal coincide con el del stream.
            • Channel Name Filter (Regex): Solo crea canales a partir de transmisiones (streams) que cumplan con los criterios del filtro.
            • Channel Profile Assignment: Te permite elegir en qué perfil(es) incluir los canales creados (por defecto All).
            • Channel Sort Order: Define el orden de clasificación de los canales creados (por defecto, el orden del proveedor).
            • Stream Profile Assignment: Permite cambiar el perfil de transmisión para los canales creados respecto al predeterminado.

      • Botón "Profiles" - Permite agregar un segundo conjunto de credenciales para el mismo proveedor.

      Info

      Por ejemplo, supongamos que tienes tres cuentas que deseas agregar a Dispatcharr: dos de Provider-A y una de Provider-B. En lugar de agregar tres cuentas M3U por separado, puedes agregar Provider-A una sola vez y configurar un perfil "Profile" para usar el nombre de usuario y la contraseña de cada cuenta de Provider-A dentro de la misma cuenta M3U.
      1. Configura Provider-A como una cuenta M3U (Standard o Xtream Codes) en el administrador "M3U & EPG Manager".
      2. Haz clic en el ícono de edición amarillo correspondiente en la columna "Actions".
      3. Haz clic en el botón "Profiles".
      4. Haz clic en el botón "New".
      5. Los campos "Search Pattern (Regex)" y "Replace Pattern" funcionarán como una búsqueda y reemplazo dentro de tu archivo M3U.

      Ejemplo

      Ejemplo URL Search Pattern Replace Pattern
      http://provider.com/live/username1/password1/stream username1/password1 username2/password2

    • ícono de eliminación "delete icon" para eliminar la cuenta M3U asociada.

    • Ícono de actualización "refresh icon" para actualizar o sincronizar manualmente la cuenta M3U asociada.

EPGs

  • " Add EPG" - Haz clic en esta opción para agregar una nueva fuente EPG.
    • Standard EPG Source - Para agregar una fuente estándar XMLTV EPG.
      • Name - Un nombre para tu EPG.
      • URL - La URL de tu EPG.
      • Source Type - Elige XMLTV o "Schedules Direct" dependiendo del formato que use tu proveedor de EPG.
      • API Key - Clave API asociada a tu EPG, si es requerida.
      • Refresh Interval (hours) - Define cada cuántas horas se actualizará la EPG.
      • Priority - Prioridad para mapeo de EPG (números altos = mayor prioridad). Se utiliza cuando múltiples EPG contienen las mismas entradas para un canal.

      Nota

      Las EPG pueden agregarse automáticamente a Dispatcharr colocando los archivos EPG dentro de la carpeta /data/epgs, siempre que la opción Auto-Import Mapped Files esté habilitada en Settings > Stream Settings.

    • Dummy EPG Source - Para agregar una EPG personalizada "Dummy EPG"
      • Name - Un nombre para tu EPG personalizada.
      • Name Source (Requerida) - Elige si se debe analizar el nombre del canal o el nombre de la transmisión (stream) asignada al canal.
      • Title Pattern (Requerida) - Patrón Regex para extraer la información del título (por ejemplo: nombres de equipos, liga). Ejemplo: (?<league>\w+) \d+: (?<team1>.*) VS (?<team2>.*)
      • Time Pattern (Opcional) - Extrae la hora desde los títulos de los canales. Grupos requeridos: 'hour' (1-12 o 0-23), 'minute' (0-59), 'ampm' (AM/PM - opcional para 24-hour). Ejemplos: @ (?<hour>\d+):(?<minute>\d+)(?<ampm>AM|PM) for '8:30PM' o @ (?<hour>\d{1,2}):(?<minute>\d{2}) for '20:30'
      • Date Pattern (Opcional) - Extrae la fecha desde los títulos de los canales. Grupos: 'month' (nombre o número), 'day', 'year' (opcional, por defecto, año actual). Ejemplos: @ (?<month>\w+) (?<day>\d+) para 'Oct 17' o (?<month>\d+)/(?<day>\d+)/(?<year>\d+) pora '10/17/2025'
      • Title Template (Opcional) - Da formato al título del programa usando los grupos extraídos. Usa {time} (12-hour: '10 PM') o {time24} (24-hour: '22:00'). Ejemplo: {league} - {team1} vs {team2} @ {time}
      • Description Template (Opcional) - Da formato a la descripción del programa usando los grupos extraídos. Usa {time} (12-hour) o {time24} (24-hour). Ejemplo: Watch {team1} take on {team2} at {time}!
      • Upcoming Title Template (Opcional) - Título para los programas antes del inicio del evento. Usa {time} (12-hour) o {time24} (24-hour). Ejemplo: {team1} vs {team2} starting at {time}.
      • Upcoming Description Template (Opcional) - Descripción para los programas previos al evento. Usa {time} (12-hour) o {time24} (24-hour). Ejemplo: Upcoming: Watch the {league} match up where the {team1} take on the {team2} at {time}!
      • Ended Title Template (Opcional) - Título para los programas después de que el evento ha terminado. Usa {time} (12-hour) o {time24} (24-hour). Ejemplo: {team1} vs {team2} started at {time}.
      • Ended Description Template (Opcional) - Descripción para los programas posteriores al evento. Usa {time} (12-hour) o {time24} (24-hour). Ejemplo: The {league} match between {team1} and {team2} started at {time}.
      • Event Timezone (Requerida) - Zona horaria del evento en los títulos de los canales. El horario de verano (DST) se gestiona automáticamente. Todas las zonas horarias compatibles con pytz están disponibles.
      • Output Timezone (Opcional) - Permite mostrar las horas en una zona horaria diferente a la del evento. Déjalo en blanco para usar la zona horaria del evento. Ejemplo: Evento a las 10 PM ET mostrado como 9 PM CT.
      • Program Duration (minutos) (requerido) - Duración predeterminada de cada programa.
      • Categories (Opcional) - Categorías EPG para estos programas. Separa múltiples categorías con comas (por ejemplo: Sports, Live, HD). Nota: Solo se agregan al evento principal, no a los programas de relleno previos o posteriores..
      • Include Date Tag - Incluye la etiqueta en la salida del EPG con la fecha de inicio del programa (formato YYYY-MM-DD). Se añade a todos los programas.
      • Include Live Tag - Marca los programas como contenido en vivo mediante la etiqueta en la salida del EPG. Nota: Solo se agrega al evento principal, no a los programas de relleno.
      • Sample Channel Name - Prueba tus patrones y plantillas con un nombre de canal de ejemplo para previsualizar el resultado. Ingresa un nombre de canal para verificar la coincidencia del patrón y ver el formato generado.
  • Puedes hacer clic en los encabezados de columna para cambiar el orden de clasificación de las EPGs existentes.
  • Actions column
    • "edit icon" para editar la EPG asociada.
    • "delete icon" para eliminar la EPG asociada.
    • "refresh icon" para actualizar o sincronizar manualmente la EPG asociada.