#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 normas
Especificação de lista de reprodução M3U e #EXTINF
Saiba como o Mayk IP TV analisa listas M3U e M3U Plus em Portugal, mapeia metadados e classifica canais em direto, filmes e séries.
Cabeçalho do ficheiro e codificação
O ficheiro de lista de reprodução M3U deve principiar com #EXTM3U na primeira linha. Os ficheiros devem ser codificados em UTF-8 com terminações LF ou CRLF. Todos os URL devem ser absolutos em HTTP ou HTTPS.
Nível 1 Etiquetas #EXTINF padrão
Os metadados são configurados na linha #EXTINF através de atributos entre aspas duplas. tvg-id associa o guia EPG, tvg-name o nome de recurso, tvg-logo o logótipo e group-title a categoria.
Classificação automática de conteúdos
O Mayk IP TV classifica os URL com /movie/ como filmes (VOD) e os URL com /series/ e padrões como S01E01 ou S01.E01 como episódios de séries. As restantes emissões são tidas como TV em direto.
Nível 2 Etiquetas expandidas
Os criadores de listas podem fornecer media-type="live|movie|series", series-name, season e episode para indicar expressamente o género de conteúdo sem estar dependente de caminhos.
Dimensão do catálogo e desempenho
Listas extensas não comprimidas com mais de 40 MB sobrecarregam a memória da Smart TV. Recomenda-se ativar compressão HTTP gzip ou disponibilizar a API Xtream Codes.
Nível 1: Etiquetas #EXTINF padrão
| Campo / Etiqueta | Nível | Tipo | Valor de exemplo | Descrição |
|---|---|---|---|---|
#EXTM3U | Padrão (Nível 1) · Obrigatório | Directive (Header) | #EXTM3U | Cabeçalho da lista de reprodução; tem de ser a primeiríssima linha de todo o ficheiro 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 os respetivos atributos de metadados. |
tvg-id | Padrão (Nível 1) · Opcional | String | trt1.tr | Identificador de canal para correspondência com o guia eletrónico 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 direto em HTTP ou HTTPS para a imagem do logótipo ou cartaz do conteúdo. |
group-title | Padrão (Nível 1) · Opcional | String | National | Nome de categoria para agrupar os canais e conteúdos por temáticas. |
#EXTGRP: | Padrão (Nível 1) · Opcional | Directive | #EXTGRP:National | Diretiva de grupo alternativa posicionada imediatamente após a linha EXTINF. |
Nível 2: Etiquetas expandidas Mayk IP TV
| Campo / Etiqueta | Nível | Tipo | Valor de exemplo | Descrição |
|---|---|---|---|---|
media-type | Expandido (Nível 2) · Opcional | Enum ("live" | "movie" | "series") | media-type="series" | Substituição expressa do tipo de multimédia: 'live', 'movie' ou 'series'. |
series-id | Expandido (Nível 2) · Opcional | String / Integer | series-id="show-42" | Identificador único que congrega múltiplos episódios sob a mesma série. |
series-name | Expandido (Nível 2) · Opcional | String | series-name="Example Series" | Título canónico da série de televisão para agregar temporadas. |
season | Expandido (Nível 2) · Opcional | Integer | season="1" | Número da temporada do episódio da série (número inteiro). |
episode | Expandido (Nível 2) · Opcional | Integer | episode="4" | Número de ordem do episódio na respetiva temporada (número inteiro). |
is_adult | Expandido (Nível 2) · Opcional | Integer ("0" | "1") | is_adult="1" | Indicador de controlo parental: '1' assinala conteúdo reservado a adultos. |
age_rating | Expandido (Nível 2) · Opcional | String | age_rating="18+" | Classificação etária mínima recomendada (ex.: '18+') para os filtros de proteção. |
Regras de classificação
| Tipo | # | Valor de exemplo |
|---|---|---|
| TV em direto | #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 excerto M3U ou resposta JSON Xtream abaixo para verificar a conformidade com o Mayk IP TV.
Lista de verificação de compatibilidade M3U
- Assegure-se de que a primeira linha é #EXTM3U e a codificação é UTF-8.
- Coloque sempre todos os valores dos atributos entre aspas duplas.
- Estruture filmes com /movie/ e séries com /series/ e a marcação SxxEyy.
- Indique endereços HTTP/HTTPS válidos e diretos para todos os logótipos.
- Evite separadores decorativos na lista e adote o atributo group-title.