Lista M3U: o que é e como o player interpreta cada linha
Por Equipe Guia VU Player · Atualizado em 01/10/2026 · 7 min de leitura
Uma lista M3U é só um arquivo de texto. Entender as poucas regras dele explica por que canais somem, categorias se embaralham e o guia não aparece.
Definição rápida
Anatomia de uma entrada
Um exemplo genérico, com dados fictícios:
#EXTM3U x-tvg-url="http://exemplo.invalid/guia.xml" #EXTINF:-1 tvg-id="noticias1.br" tvg-name="Notícias 1" tvg-logo="http://exemplo.invalid/n1.png" group-title="Notícias",Notícias 1 HD http://exemplo.invalid/live/usuario/senha/101.ts
| Elemento | Função no player |
|---|---|
| #EXTM3U | Cabeçalho obrigatório; pode trazer o endereço do guia (x-tvg-url) |
| #EXTINF:-1 | Início da descrição; -1 indica duração indefinida (ao vivo) |
| tvg-id | Chave que liga o canal à grade do EPG |
| tvg-name | Nome usado para busca e, às vezes, para casar o guia |
| tvg-logo | Imagem do canal |
| group-title | Categoria em que o canal aparece |
| Texto após a vírgula | Nome exibido na lista |
| Linha seguinte | Endereço da transmissão |
M3U, M3U8 e link de lista
M3U8 é o mesmo formato com codificação UTF‑8, o que preserva acentos. No mundo do streaming, “.m3u8” também é a extensão das playlists HLS, que dividem um vídeo em pedaços. Por isso você pode ver o termo nos dois sentidos: a lista de canais e o índice de segmentos de um único canal.
Na prática, o player aceita a lista como arquivo (salvo no aparelho, não atualiza sozinho) ou como link (baixado de novo a cada atualização). Link é sempre preferível.
Erros comuns e o que causam
| Erro na lista | Sintoma no player |
|---|---|
| Falta #EXTM3U no início | Lista não é reconhecida |
| Acentos quebrados | Arquivo salvo sem UTF‑8 |
| group-title ausente | Todos os canais numa categoria só |
| tvg-id vazio ou diferente do guia | Canal sem programação |
| Linha de endereço quebrada | Canal aparece, mas não abre |
Tamanho da lista e desempenho
Listas com filmes e séries em M3U podem ter dezenas de milhares de linhas. Aparelhos com pouca memória sofrem para carregar. Nesse caso, o modo Xtream costuma ser mais eficiente, porque o player busca categorias sob demanda em vez de ler tudo de uma vez. Veja a comparação em M3U ou Xtream.
Posso editar minha lista?
Tecnicamente sim: é um texto. Mas, se for um link do fornecedor, qualquer edição local se perde na próxima atualização. Para personalizar, use favoritos e ocultação de categorias no próprio player, como mostramos em favoritos e categorias.
Atributos menos conhecidos
| Atributo | Para que serve |
|---|---|
| tvg-shift | Desloca a grade de um canal em horas, sem mexer nos outros |
| tvg-chno | Número do canal para zapear pelo controle |
| catchup e catchup-days | Indicam se o canal permite assistir programas passados e por quantos dias |
| x-tvg-url | Endereço do guia, no cabeçalho da lista |
Nem todo player lê todos os atributos. Se um deles não fizer efeito no seu app, não é erro da lista: o player apenas ignora aquele campo.
Lista local x lista remota
Uma lista salva como arquivo no aparelho fica congelada no momento em que foi baixada: se o fornecedor mudar um endereço, ela para de funcionar sem aviso. Uma lista cadastrada por link é baixada novamente a cada atualização e acompanha as mudanças. Por isso o cadastro por link é sempre a recomendação padrão.
Como verificar uma lista antes de cadastrar
- Abra o link no navegador do celular ou computador.
- Confira se a primeira linha é #EXTM3U.
- Veja se as linhas #EXTINF trazem group-title e tvg-id.
- Escolha um endereço de canal e teste num player de mídia do computador.
- Só então cadastre no player da TV.
Segurança ao lidar com listas
- O link contém usuário e senha: não compartilhe prints com ele visível.
- Desconfie de listas “grátis” publicadas em fóruns: costumam cair rápido e podem apontar para endereços maliciosos.
- Prefira fornecedor com teste e suporte, que avise quando o endereço mudar.
Para entender onde a lista entra no app, veja o guia do VU Player e listas IPTV. Se precisar de uma para testar, peça o teste de 6 horas.
Player pronto, falta a lista?
Receba um acesso de teste por 6 horas e veja canais, filmes e guia funcionando no seu player.
Perguntas e respostas
Lista M3U é a mesma coisa que IPTV?
Não. É só o formato do índice de canais. O IPTV é o serviço que entrega as transmissões.
Posso abrir uma lista M3U no computador?
Sim, em qualquer editor de texto, ou em players de mídia que aceitam M3U.
Por que minha lista tem acentos estranhos?
O arquivo provavelmente não está em UTF‑8 (M3U8).