Fundamentos
Lista IPTV e o formato M3U, linha por linha
Quase todo problema atribuído ao aplicativo nasce, na verdade, no arquivo de lista. Entender a estrutura do M3U transforma um erro genérico em um diagnóstico objetivo.
Resumo rápido
- Uma lista M3U é texto puro: metadados + endereço de cada fluxo.
- M3U8 é a variante em UTF-8, importante para acentuação em português.
- O atributo tvg-id é o que conecta o canal ao guia de programação.
- Erros de codificação e limite de conexões simultâneas explicam a maioria das falhas.
A anatomia de uma entrada
Toda lista começa com a linha #EXTM3U. Depois dela, cada canal ocupa duas linhas: uma de descrição e uma de endereço. A linha de descrição carrega atributos que o player lê para montar a interface — nome exibido, logo, grupo e identificador de guia.
| Atributo | Para que serve | Sintoma quando está errado |
|---|---|---|
| tvg-id | Liga o canal à sua programação no arquivo XMLTV. | Canal aparece, mas sem guia de programação. |
| tvg-name | Nome técnico usado em correspondências automáticas. | Falha no casamento com EPG de outra fonte. |
| tvg-logo | URL da imagem do canal. | Ícone genérico ou espaço vazio na grade. |
| group-title | Define a categoria em que o canal aparece. | Tudo cai em uma única lista gigante, difícil de navegar. |
Por que a acentuação quebra
Nomes como “Notícias” ou “Esportes ao Vivo” dependem da codificação do arquivo. Se a lista foi salva em ISO-8859-1 e o player espera UTF-8, você verá caracteres estranhos no lugar dos acentos. Não é falha do aplicativo, e reinstalar não resolve — o que resolve é salvar o arquivo novamente em UTF-8, que é justamente o que a extensão .m3u8 sinaliza.
Lista por link e lista por arquivo
Há duas formas de o player receber a lista. Por URL remota, o aplicativo busca o arquivo a cada abertura, então mudanças no servidor aparecem sozinhas. Por arquivo local, a lista fica congelada no aparelho: nada muda até você substituir o arquivo manualmente.
Isso tem uma consequência prática pouco comentada. Se um canal sumiu para você mas continua na origem, verifique primeiro se o seu player está usando uma cópia local antiga. Em aplicativos como o SSIPTV, as duas formas convivem e é fácil esquecer qual está ativa.
As cinco causas mais comuns de “a lista não carrega”
- Limite de conexões simultâneas. Muitos fornecimentos permitem apenas um dispositivo por vez. Uma TV esquecida ligada em outro cômodo derruba o celular.
- Link expirado. URLs com token têm validade. O arquivo continua íntegro, mas o servidor recusa a requisição.
- Formato não suportado pelo player. Reprodutores antigos de Smart TV frequentemente não lidam com certos codecs.
- Lista grande demais para o aparelho. Televisores de entrada travam ao montar milhares de itens na memória. Reduzir grupos costuma resolver.
- DNS ou bloqueio na rede. Se a mesma lista funciona no 4G e falha no Wi-Fi, o problema está na rede, não no arquivo.
Como testar a lista isoladamente
Antes de mexer na televisão, abra o arquivo no computador com um reprodutor genérico como o VLC. Se os canais abrem lá e falham na TV, o arquivo está bom e a investigação passa para o aparelho ou para o app — caminho detalhado no comparativo de players. Se falha nos dois, o problema é a lista ou a origem.
Perguntas frequentes
- O que é um arquivo M3U?
- É um arquivo de texto simples que funciona como índice de reprodução. Cada entrada tem uma linha de metadados começando com #EXTINF e, logo abaixo, o endereço do fluxo de vídeo. Não contém vídeo algum: apenas aponta para onde ele está.
- Qual a diferença entre M3U e M3U8?
- A extensão .m3u8 indica que o arquivo está codificado em UTF-8, o que preserva acentuação em nomes de canais. Estruturalmente é a mesma coisa; nomes com acento corrompidos costumam ser sintoma de arquivo salvo fora de UTF-8.
- Por que minha lista funciona em um player e não em outro?
- Normalmente por três motivos: o player não suporta o formato de transporte usado, o arquivo tem codificação diferente da esperada, ou o servidor limita conexões simultâneas por dispositivo. O arquivo pode estar perfeito e ainda assim falhar por limite de conexão.
- O que é EPG em uma lista?
- EPG é o guia de programação. Ele vem de uma fonte XMLTV separada e se liga aos canais pelo atributo tvg-id. Se o identificador não bate exatamente, o canal aparece sem programação, mesmo com a URL de EPG correta.