O que é um arquivo M3U? M3U e M3U8 explicados

O formato é mais antigo que o IPTV. Ele nasceu para playlists de música em players de mídia, e o nome vem de “MP3 URL”. Como é só texto, qualquer programa consegue escrever e quase todo player consegue ler. Por isso os provedores de IPTV o usam para as listas de canais. Aqui você vê o que tem dentro de um arquivo M3U, como um player o lê e onde o formato chega ao limite.

O que tem dentro de um arquivo M3U?

Uma playlist M3U de um provedor de IPTV é assim, só que com milhares de itens em vez de dois:

#EXTM3U
#EXTINF:-1 tvg-id="news.example" tvg-name="Example News" tvg-logo="https://example.com/logos/news.png" group-title="News",Example News
https://stream.example.com/live/news.m3u8
#EXTINF:-1 tvg-id="sport1.example" tvg-name="Example Sport 1" tvg-logo="https://example.com/logos/sport1.png" group-title="Sport",Example Sport 1
https://stream.example.com/live/sport1.ts

Linha por linha:

• #EXTM3U abre o arquivo e avisa o player que vem uma playlist M3U estendida, com informações sobre cada item.
• #EXTINF começa um item. O -1 quer dizer que a duração é desconhecida, como num canal ao vivo. O texto depois da última vírgula é o nome que o player mostra.
• tvg-id é o ID do canal no guia de TV. É por ele que o player liga o canal aos programas.
• tvg-name é o nome que o guia de TV usa, e tvg-logo é o endereço do logo do canal.
• group-title é a categoria, como notícias ou esportes. É por ela que o player separa os canais em grupos.
• A linha embaixo de cada item é o endereço do stream em si: é dali que o player busca a imagem.

Os atributos tvg- são um costume dos softwares de IPTV, não fazem parte do formato original. Cada provedor os preenche com mais ou menos cuidado. Uma playlist sem IDs funciona mesmo assim; o guia de TV dela é ligado aos canais pelo nome.

M3U ou M3U8?

Um arquivo .m3u8 é um arquivo M3U em UTF-8. Assim, acentos e nomes de canais em qualquer idioma ficam certos. Como lista de canais, os dois funcionam igual. O ZiroTV lê os dois.

A mesma extensão tem um segundo uso. O vídeo em streaming (HLS) usa um arquivo .m3u8 para um único stream: uma lista curta de pedaços de vídeo que o player baixa um depois do outro. Então nem todo link terminado em .m3u8 é uma lista de canais. Se um player mostra um canal só, ou nenhum, para um link que deveria trazer centenas, provavelmente é um stream único.

O que é um link M3U?

É a mesma lista, só que num servidor em vez de no seu aparelho. Em vez de mandar um arquivo, o seu provedor de IPTV passa o endereço dele, normalmente no e-mail de boas-vindas ou na sua conta no site dele. Muitos provedores montam o link com os seus dados de acesso, neste formato:

http://server.example.com:8080/get.php?username=YOUR_NAME&password=YOUR_PASSWORD&type=m3u_plus&output=ts

Esse formato revela duas coisas. Primeiro, o seu usuário e a sua senha estão dentro do link. Quem tem o link pode usar a sua assinatura, então trate-o como uma senha. Segundo, o seu provedor muito provavelmente também oferece um login Xtream Codes, que entrega mais ao player do que o link M3U. O type=m3u_plus só pede a lista estendida, com grupos e logos. Xtream Codes ou M3U explica a diferença.

O link vem sempre do seu provedor, nunca de uma lista pública. O ZiroTV não fornece playlists e não ajuda a encontrar uma. Use um provedor que tenha os direitos dos canais. Quando o IPTV é legal está numa página própria.

Abrir ou criar um arquivo M3U

Abrir

Depende do que tem no arquivo. Uma playlist de músicas ou vídeos no seu computador abre num player de mídia como o VLC: um clique duplo basta, e os itens tocam em sequência. A lista de canais do seu provedor vai num player IPTV, que a organiza por grupos e mostra o guia de TV junto. Num editor de texto, você consegue ler qualquer arquivo M3U.

Criar

Para as suas próprias músicas ou vídeos, um editor de texto basta. Escreva #EXTM3U na primeira linha e, para cada item, uma linha #EXTINF com duração e nome e, embaixo, o endereço ou o caminho do arquivo. Salve em UTF-8 com a extensão .m3u ou .m3u8. Um link M3U não passa de um arquivo assim num servidor web. Não é preciso converter entre .m3u e .m3u8: basta salvar o arquivo em UTF-8.

Como um player IPTV lê uma playlist M3U

1. Ele baixa o arquivo pelo link.
2. Lê cada item: nome, endereço do stream, grupo, logo e ID no guia de TV.
3. Monta a lista de canais, separada por grupos.
4. Se você adicionou um link de EPG, ele baixa o guia de TV e liga os programas aos canais: pelo tvg-id ou, se não houver, pelo nome.
5. De tempos em tempos, baixa a lista de novo, para que canais apareçam ou sumam quando o seu provedor muda alguma coisa.

No ZiroTV, os canais aparecem assim que a lista é lida, e o guia de TV se preenche logo depois. Com que frequência a lista é baixada de novo você escolhe nas configurações: a cada abertura, todo dia ou toda semana. Uma sincronização manual baixa na hora. O guia de TV não depende dessa configuração: o ZiroTV o baixa de novo quando ele tem mais de 30 minutos.

O que uma playlist M3U não faz

• Ela não traz o guia de TV. A programação fica num arquivo EPG separado. Por isso uma playlist M3U precisa de um link de EPG ao lado. Como funciona o guia de TV no IPTV.
• Ela é uma lista única e plana. Filmes e séries, quando vêm, são só mais itens na mesma lista, sem capas, temporadas nem descrições. No ZiroTV, filmes e séries precisam de um login Xtream Codes.
• O catch-up depende das tags. No ZiroTV, um canal M3U tem catch-up e retrocesso ao vivo só quando o seu provedor escreve tags de catch-up na lista, como catchup, catchup-source ou tvg-rec. Catch-up e retrocesso ao vivo explicados.
• Ela vem de uma vez só. Uma lista com dezenas de milhares de itens precisa ser baixada e lida inteira antes de o primeiro canal aparecer. Isso demora mais do que com um login Xtream Codes, que manda a lista em partes.

Como adicionar um link M3U no ZiroTV

1. Abra o ZiroTV. Na primeira vez, o app oferece adicionar a sua primeira playlist. Depois, você abre as configurações e adiciona uma playlist por lá.
2. Escolha uma playlist M3U em vez de um login Xtream Codes.
3. Dê um nome a ela, como “Casa”, e cole o seu link no campo do endereço da playlist, substituindo o texto que já está no campo.
4. Se o seu provedor passou um link de EPG, cole-o no campo do guia de TV.
5. Confirme para o ZiroTV adicionar e sincronizar a playlist.

Digitar um link comprido com o controle remoto demora. Na TV, é melhor adicionar a playlist pelo celular: leia o QR code da tela e cole o link no celular. O ZiroTV aceita um link, não um arquivo salvo no aparelho.

Se o ZiroTV avisar que a playlist não tem canais, o link está errado, expirou ou leva a um stream único. Se avisar que o usuário ou a senha estão errados, o provedor recusou os dados de acesso do link. Resolva os dois casos com o seu provedor. Em quais aparelhos o ZiroTV funciona está na página de download.