Mayk IP TV

Especificações técnicas e padrões

Especificação de lista M3U e tags #EXTINF

Saiba como o Mayk IP TV analisa listas M3U e M3U Plus, mapeia metadados e classifica automaticamente canais, filmes e séries.

Cabeçalho do arquivo e codificação

O arquivo de lista M3U deve começar obrigatoriamente com #EXTM3U na primeira linha. O arquivo deve ser codificado em UTF-8 com quebras de linha LF ou CRLF. Todas as URLs devem ser absolutas em HTTP ou HTTPS.

Nível 1 Tags #EXTINF padrão

Os metadados são definidos na linha #EXTINF usando atributos entre aspas duplas. tvg-id associa o guia EPG, tvg-name serve como nome alternativo, tvg-logo informa o logotipo e group-title a categoria.

Classificação automática de mídia

O Mayk IP TV classifica URLs contendo /movie/ como filmes (VOD) e URLs com /series/ e padrões como S01E01 ou S01.E01 como episódios de séries. As demais transmissões são tratadas como TV ao vivo.

Nível 2 Tags estendidas

Geradores de listas podem adicionar media-type="live|movie|series", series-name, season e episode para determinar o tipo de conteúdo diretamente, sem depender de convenções de rota.

Tamanho do catálogo e desempenho

Listas planas não comprimidas com mais de 40 MB sobrecarregam a memória da Smart TV. Recomenda-se ativar a compressão HTTP gzip ou usar a API do Xtream Codes.

Nivel 1: Tags #EXTINF padrão

Campo / TagNívelTipoValor de exemploDescrição
#EXTM3UPadrão (Nível 1) · ObrigatórioDirective (Header)#EXTM3UCabeçalho de lista; deve ser a primeiríssima linha de qualquer arquivo M3U válido.
#EXTINFPadrão (Nível 1) · ObrigatórioDirective (Metadata)#EXTINF:-1 tvg-id="trt1" tvg-name="TRT 1",TRT 1 HDDiretiva principal que indica a duração do fluxo e seus atributos de metadados.
tvg-idPadrão (Nível 1) · OpcionalStringtrt1.trIdentificador de canal para correspondência com a grade de programação EPG.
tvg-namePadrão (Nível 1) · OpcionalStringTRT 1 HDNome de canal alternativo usado para localização no guia de programação.
tvg-logoPadrão (Nível 1) · OpcionalURL (http/https)https://stream.example.com:8080/images/trt1.pngURL direta em HTTP ou HTTPS que aponta para o logotipo ou imagem de capa.
group-titlePadrão (Nível 1) · OpcionalStringNationalNome de categoria para organização de canais e conteúdos em grupos.
#EXTGRP:Padrão (Nível 1) · OpcionalDirective#EXTGRP:NationalDiretiva de grupo alternativa posicionada imediatamente após a linha EXTINF.

Nível 2: Tags estendidas Mayk IP TV

Campo / TagNívelTipoValor de exemploDescrição
media-typeEstendido (Nível 2) · OpcionalEnum ("live" | "movie" | "series")media-type="series"Substituição explícita do tipo de mídia: 'live', 'movie' ou 'series'.
series-idEstendido (Nível 2) · OpcionalString / Integerseries-id="show-42"Identificador único agrupando múltiplos episódios sob uma mesma série.
series-nameEstendido (Nível 2) · OpcionalStringseries-name="Example Series"Título canônico da série de televisão para unificar temporadas.
seasonEstendido (Nível 2) · OpcionalIntegerseason="1"Número da temporada do episódio da série (número inteiro).
episodeEstendido (Nível 2) · OpcionalIntegerepisode="4"Número do episódio dentro da temporada indicada (número inteiro).
is_adultEstendido (Nível 2) · OpcionalInteger ("0" | "1")is_adult="1"Indicador de controle parental: '1' marca conteúdo restrito para adultos.
age_ratingEstendido (Nível 2) · OpcionalStringage_rating="18+"Classificação indicativa de idade mínima (ex.: '18+') para filtros parentais.

Regras de classificação

Tipo#Valor de exemplo
TV ao vivo#3http(s)://... | media-type="live"
Filme (VOD)#2/movie/... | media-type="movie"
Episódio de série#1/series/... + S01E01 / S01.E01 | media-type="series"

Modelos de exemplo

TV ao vivo (M3U / #EXTINF)
#EXTM3U
#EXTINF:-1 tvg-id="trt1.tr" tvg-name="TRT 1 HD" tvg-logo="https://stream.example.com:8080/images/trt1.png" group-title="Ulusal",TRT 1 HD
https://stream.example.com:8080/live/demo_user/demo_pass/101.m3u8
#EXTINF:-1 tvg-id="atv.tr" tvg-name="ATV HD" tvg-logo="https://stream.example.com:8080/images/atv.png" group-title="Ulusal",ATV HD
https://stream.example.com:8080/live/demo_user/demo_pass/102.m3u8
Filme (VOD) & Episódio de série (M3U / #EXTINF)
#EXTM3U
#EXTINF:-1 tvg-logo="https://stream.example.com:8080/images/movie202.png" group-title="Sinema",Example Movie (2026)
https://stream.example.com:8080/movie/demo_user/demo_pass/202.mp4
#EXTINF:-1 group-title="Dizi",Example Series - S01E01 - Pilot
https://stream.example.com:8080/series/demo_user/demo_pass/30301.mp4
#EXTINF:-1 media-type="series" series-name="Custom Show" season="1" episode="2" group-title="Dizi",Custom Show - S01E02
https://stream.example.com:8080/series/demo_user/demo_pass/30302.mp4

Verificador de formato interativo

Cole o seu trecho M3U ou resposta JSON Xtream abaixo para verificar a conformidade com o Mayk IP TV.

Lista de verificação de compatibilidade M3U

  • Garanta que a primeira linha seja #EXTM3U e a codificação seja UTF-8.
  • Sempre coloque todos os valores dos atributos entre aspas duplas.
  • Estruture filmes com /movie/ e séries com /series/ e o padrão SxxEyy.
  • Utilize endereços HTTP ou HTTPS válidos e diretos para os logotipos.
  • Evite linhas decorativas separadoras e use o atributo group-title.