#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
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 / Tag | Nível | Tipo | Valor de exemplo | Descrição |
|---|---|---|---|---|
#EXTM3U | Padrão (Nível 1) · Obrigatório | Directive (Header) | #EXTM3U | Cabeçalho de lista; deve ser a primeiríssima linha de qualquer arquivo M3U válido. |
#EXTINF | Padrão (Nível 1) · Obrigatório | Directive (Metadata) | #EXTINF:-1 tvg-id="trt1" tvg-name="TRT 1",TRT 1 HD | Diretiva principal que indica a duração do fluxo e seus atributos de metadados. |
tvg-id | Padrão (Nível 1) · Opcional | String | trt1.tr | Identificador de canal para correspondência com a grade de programação EPG. |
tvg-name | Padrão (Nível 1) · Opcional | String | TRT 1 HD | Nome de canal alternativo usado para localização no guia de programação. |
tvg-logo | Padrão (Nível 1) · Opcional | URL (http/https) | https://stream.example.com:8080/images/trt1.png | URL direta em HTTP ou HTTPS que aponta para o logotipo ou imagem de capa. |
group-title | Padrão (Nível 1) · Opcional | String | National | Nome de categoria para organização de canais e conteúdos em grupos. |
#EXTGRP: | Padrão (Nível 1) · Opcional | Directive | #EXTGRP:National | Diretiva de grupo alternativa posicionada imediatamente após a linha EXTINF. |
Nível 2: Tags estendidas Mayk IP TV
| Campo / Tag | Nível | Tipo | Valor de exemplo | Descrição |
|---|---|---|---|---|
media-type | Estendido (Nível 2) · Opcional | Enum ("live" | "movie" | "series") | media-type="series" | Substituição explícita do tipo de mídia: 'live', 'movie' ou 'series'. |
series-id | Estendido (Nível 2) · Opcional | String / Integer | series-id="show-42" | Identificador único agrupando múltiplos episódios sob uma mesma série. |
series-name | Estendido (Nível 2) · Opcional | String | series-name="Example Series" | Título canônico da série de televisão para unificar temporadas. |
season | Estendido (Nível 2) · Opcional | Integer | season="1" | Número da temporada do episódio da série (número inteiro). |
episode | Estendido (Nível 2) · Opcional | Integer | episode="4" | Número do episódio dentro da temporada indicada (número inteiro). |
is_adult | Estendido (Nível 2) · Opcional | Integer ("0" | "1") | is_adult="1" | Indicador de controle parental: '1' marca conteúdo restrito para adultos. |
age_rating | Estendido (Nível 2) · Opcional | String | age_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 | #3 | http(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
#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.