Em resumo
- Xtream Codes é uma API: o app conversa com o servidor do provedor e recebe canais, guia, filmes e séries organizados. Quando puder escolher, escolha ele.
- M3U é um arquivo: uma lista de streams, nada mais. Funciona em qualquer lugar, mas o guia vem de fora e as séries ficam soltas.
- Os dois entregam os mesmos streams. O que muda é tudo em volta: o guia, as fichas, as temporadas, a atualização do catálogo.
Nesta página
Quando você recebe uma assinatura IPTV, o provedor te dá um jeito de acessá-la. Às vezes é uma URL longa terminando em .m3u, às vezes três campos para preencher, endereço, usuário, senha, às vezes os dois. São duas portas para o mesmo conteúdo, mas não abrem para a mesma experiência. Este guia explica o que cada uma contém, e o que muda uma vez dentro do app.
O que é uma lista M3U
Uma M3U é um arquivo de texto. Cada canal ocupa duas linhas: uma linha de descrição, com o nome, o logo, o grupo e às vezes um identificador de guia, depois a URL do stream. É só isso. Um arquivo de 5.000 canais tem alguns megabytes, e o app o baixa inteiro a cada atualização.
#EXTINF:-1 tvg-id="globo.br" tvg-logo="https://…/globo.png" group-title="Brasil",Globo
http://servidor:8080/live/usuario/senha/123.ts
Esse formato tem um mérito: é universal. Qualquer player de vídeo dos últimos vinte anos sabe ler. E um limite: só contém streams. Nenhum guia de programação, nenhuma ficha de filme, nenhuma estrutura de temporada. Tudo que não é stream tem que vir de outro lugar, ou ser adivinhado a partir do nome.
O que é Xtream Codes
Xtream Codes não é um arquivo, é uma API: um jeito de o app fazer perguntas ao servidor do provedor. "Quais são as categorias?" "Quais canais nesta?" "Qual é a programação deste canal hoje à noite?" "Quais episódios na temporada 2 desta série?" Cada resposta é estruturada, e o app só pede o que precisa, quando precisa.
Você digita três informações: o endereço do servidor, um nome de usuário, uma senha. O app cuida do resto. O nome vem de um software de servidor que fixou esse formato anos atrás; muitos provedores hoje usam software compatível, e o nome ficou para designar a API.
O que muda no app
| M3U | Xtream Codes | |
|---|---|---|
| Canais ao vivo | Sim | Sim |
| Guia de programação | Não no IPTV Guard (precisaria de um feed XMLTV à parte) | Servido pelo servidor, canal por canal |
| Filmes | Uma lista plana, agrupada pelo nome | Categorias, fichas, duração, ano |
| Séries | Episódios soltos, temporadas adivinhadas | Temporadas e episódios organizados |
| Informações da assinatura | Nenhuma | Vencimento, número de conexões, estado |
| Atualização | O arquivo inteiro, toda vez | Sob demanda, por categoria |
| Mudança de endereço do provedor | URL inteira nova | Só o endereço do servidor muda |
O guia. É a diferença que você vê primeiro. Com Xtream Codes, o guia vem do mesmo servidor que os canais, e está alinhado com eles. Com M3U, o guia teria que vir de um feed XMLTV separado, que nem todo provedor dá e que precisa usar os mesmos identificadores de canal que a lista; o IPTV Guard não lê esses feeds hoje, então uma M3U reproduz os canais sem guia. O guia sobre o guia vazio cobre o resto.
As séries. Com Xtream Codes, uma série é uma série: temporadas, episódios numerados, um "próximo episódio" que faz sentido. Com M3U, cada episódio é uma entrada como outra qualquer, e o app precisa reconstruir a estrutura lendo os nomes, "S02E05" e suas variantes. Funciona muitas vezes, não sempre.
A assinatura. Xtream Codes informa a data de vencimento e o número de conexões permitidas. É o que permite a um verificador dizer onde você está, e a um app avisar antes do fim. Uma M3U não diz nada.
Qual digitar
Se o provedor dá os dois, digite Xtream Codes. Os streams são idênticos, e você ganha todo o resto. Guarde a URL M3U como reserva, ou para um aparelho cujo player não conhece Xtream.
Se você só tem uma URL M3U, olhe bem para ela. Muitas se parecem com isto:
http://servidor:8080/get.php?username=abc&password=xyz&type=m3u_plus&output=ts
Essa forma é a assinatura de um servidor Xtream Codes gerando uma M3U sob demanda. As três informações estão ali: o endereço do servidor (http://servidor:8080), o usuário (abc), a senha (xyz). Você pode digitá-las diretamente como um acesso Xtream, e ter o guia e as séries que a URL M3U não dava. O verificador faz essa leitura sozinho: cole a URL M3U, e se houver um servidor Xtream por trás, ele mostra o vencimento e o número de conexões como para um acesso Xtream.
Se sua M3U não tem essa forma, é um arquivo real, hospedado em algum lugar, sem servidor Xtream por trás. Nesse caso a M3U é sua única opção, e você assiste aos canais sem guia.
O que não muda
O vídeo. Nos dois casos, o stream de um canal é o mesmo arquivo, servido pelo mesmo servidor, na mesma taxa. Nem o formato de acesso nem o app deixam um stream mais fluido do que o provedor envia. Se trava, o assunto está em outro lugar.
O que um bom player faz com cada um
Com Xtream Codes, ele deve carregar o guia em segundo plano sem travar a navegação, guardar em cache o que já pediu, e completar as fichas com uma base de filmes para pôsteres e sinopses quando o provedor não fornece.
Com M3U, ele deve reconhecer os episódios de série atrás dos nomes, agrupar os filmes por categoria, e lidar com um arquivo de vários megabytes sem congelar a interface. E quando um provedor bloqueia a API Xtream mas deixa passar a M3U, ele deve perceber e tomar o outro caminho sem pedir que você entenda por quê. É o que o IPTV Guard faz: o formato que você tem não deveria decidir o que você vê.
No IPTV Guard
O IPTV Guard aceita os dois, e faz o máximo com cada um. Com Xtream Codes, o app recebe guia, fichas e temporadas do servidor, e completa com o TMDB para pôsteres e sinopses. Com M3U, ele reconstrói filmes e séries a partir dos nomes. E se um provedor bloqueia a API Xtream mas deixa passar a M3U, o app muda sozinho para esse caminho para a lista carregar mesmo assim.
Perguntas frequentes
Meu provedor me dá os dois. Qual digito?
Xtream Codes. Você mantém os mesmos canais e ganha o guia, as temporadas das séries e um catálogo que se atualiza sozinho. A M3U continua útil como reserva ou para um player que só conhece esse formato.
Só tenho uma URL M3U. Estou perdendo algo?
Olhe a URL: se contém get.php?username=…&password=…, seu provedor na verdade tem um servidor Xtream Codes. O endereço do servidor, o usuário e a senha estão na URL. Você pode digitá-la como Xtream.
M3U ou M3U8, é a mesma coisa?
Para uma lista, sim: m3u8 só significa que o arquivo está em UTF-8. O formato é o mesmo. Já um link .m3u8 sozinho costuma ser um stream HLS, não uma lista: é um canal, não uma lista.
Um dos dois é mais fluido?
Não. O vídeo passa pelos mesmos streams nos dois casos. A fluidez depende do provedor, da rede e do player, não do formato de acesso.
Xtream Codes é um provedor?
Não, é o nome de um software de servidor que virou padrão de fato. Muitos provedores o usam ou usam software compatível. O nome designa o formato de acesso, não uma empresa.