M3U IPTV: guia técnico do formato, link a partir do Xtream, EPG XMLTV e uso em cada player

Estrutura do arquivo, linha a linha

Um M3U de IPTV é texto puro. Lido de cima para baixo, um arquivo gerado por um serviço Xtream tem esta sequência:

1. Linha 1, cabeçalho: #EXTM3U, opcionalmente com url-tvg apontando para o guia XMLTV do mesmo servidor. Players como o TiviMate leem esse atributo e configuram o EPG sozinhos.
2. Linha 2, descrição de um canal: #EXTINF:-1, depois os atributos tvg-id, tvg-name, tvg-logo e group-title, cada um entre aspas, e, após a vírgula, o nome exibido. O -1 é a duração: desconhecida, porque é ao vivo.
3. Linha 3, endereço do canal: servidor e porta, o caminho live, usuário, senha, o número interno do canal e a extensão (.ts ou .m3u8).
4. Linhas seguintes, filmes e séries: a mesma dupla de linhas, com movie ou series no caminho, extensão do arquivo (.mp4, .mkv) e um group-title do tipo “Filmes | Ação”. Em filmes, o tvg-id costuma vir vazio, porque não há guia para conteúdo sob demanda.

Nada mais. Não há criptografia nem executável; o que protege o acesso são o usuário e a senha embutidos em cada endereço. O tvg-id é a chave que liga o canal ao guia, e o group-title é o que o player usa para montar as categorias.

Derivando o link M3U do acesso Xtream

Se você tem servidor, usuário e senha (Xtream Codes), o link M3U é padronizado: o endereço do servidor com a porta, seguido de /get.php e dos parâmetros username, password, type e output, separados por &. A tabela resume o que cada parâmetro aceita:

A Soisopor envia os dois formatos na ativação. Se o seu serviço só deu Xtream, monte o link com o padrão acima. A comparação de formatos está em lista IPTV: M3U ou Xtream Codes.

output=ts ou output=m3u8: qual escolher

O parâmetro output define como o vídeo chega ao player. Com ts, o servidor envia um fluxo contínuo MPEG-TS: menor atraso, troca de canal mais rápida e menos processamento — é o padrão para Android TV, TV Box, Fire TV e para XCIPTV, TiviMate e Smarters. Com m3u8 (HLS), o vídeo vem em pedaços de alguns segundos, o que aumenta o atraso em relação ao ao vivo, mas é o único formato que alguns apps de Roku, navegadores e players de Smart TV aceitam. A regra: comece com ts; se a lista carrega e os canais não abrem, gere o link de novo com m3u8. Não misture: um link vale para um output, e trocar o parâmetro exige recarregar a playlist no app.

Como usar em cada player

Diagnóstico de problemas

• Lista vazia: usuário/senha errados ou porta faltando; teste o link no navegador — deve baixar um arquivo de texto.
• Canais não abrem, lista carrega: output incompatível; tente output=m3u8.
• Guia vazio: falta o XMLTV ou os tvg-id estão vazios (lista mal gerada).
• Séries sem temporadas: limitação do M3U; use Xtream no app.
• Carregamento lento: lista enorme; oculte grupos no player.

Mantendo a lista atualizada no player

Um link M3U vivo só é vivo se o player o recarrega. Cada app trata isso de um jeito: o TiviMate atualiza a playlist ao iniciar e em intervalos configuráveis (Configurações › Playlists › Atualizar); o XCIPTV recarrega quando você abre o app ou usa “atualizar lista” na tela inicial; o Smart IPTV e o SS IPTV baixam a lista quando você a cadastra no site e depois a cada abertura, então basta reiniciar o app. Se novos canais ou lançamentos não aparecem, force a atualização antes de pedir suporte. E não salve o link como arquivo local “para garantir”: o arquivo congela a lista no dia em que foi salvo, e você volta ao problema da lista datada.

Segurança do link

O link M3U contém usuário e senha. Não o cole em sites de “verificar lista”, não o compartilhe em grupos (derruba a sua tela) e não use a senha do e-mail no acesso. Se vazar, peça troca de senha ao suporte.

Quando usar M3U e quando não

Use M3U onde o app exige — Smart IPTV, SS IPTV, Roku, VLC, Kodi — e para listas públicas de canais livres (listas IPTV gratuitas). Em XCIPTV, TiviMate, Smarters e IBO, o Xtream direto entrega categorias, temporadas e guia sem configurar nada.

Quer ver na prática? O teste grátis da Soisopor dura 6 horas, libera o serviço completo e não pede cartão.

Perguntas rápidas