...

Listas M3U: O Que São, Como Se Leem e Como Abrir a Tua

Home / Blog / Listas M3U: O Que São, Como Se Leem e Como Abrir a Tua

Formatos e Configuração · M3U

O que está dentro de uma lista M3U, o que significa cada atributo e como abrir a tua no VLC, no Kodi ou na Smart TV.

Por Fathi Bouzi  ·  Atualizado Outubro 2026  ·  ~8 min de leitura

Linhas de código coloridas num ecrã escuro

Foto: Florian Olivo / Unsplash

Uma lista M3U é um ficheiro de texto que diz ao leitor de IPTV onde está cada canal. Não contém vídeo nenhum, só nomes e endereços. Começa sempre pela linha #EXTM3U, e cada canal ocupa duas linhas: uma #EXTINF com o nome e os dados do canal, e outra com o endereço do stream. Recebes a lista do teu fornecedor como link ou como ficheiro, e abre-se em leitores como o VLC, o Kodi ou o SS IPTV. Abaixo está uma lista desmontada linha a linha, os atributos que importam e os erros que fazem uma lista não abrir.

Uma lista M3U por dentro, linha a linha

Este é um exemplo com dois canais e endereços fictícios. Uma lista real tem a mesma estrutura, só que repetida centenas ou milhares de vezes:

#EXTM3U x-tvg-url="https://exemplo.com/guia.xml"
#EXTINF:-1 tvg-id="noticias.pt" tvg-name="Canal Notícias" tvg-logo="https://exemplo.com/logos/noticias.png" group-title="Informação",Canal Notícias
https://exemplo.com/live/noticias.m3u8
#EXTINF:-1 tvg-id="desporto1.pt" tvg-name="Desporto 1" tvg-chno="10" group-title="Desporto",Desporto 1
https://exemplo.com/live/desporto1.m3u8
Linha O quê Para que serve
1 #EXTM3U Cabeçalho obrigatório. Tem de ser a primeira linha do ficheiro. O x-tvg-url é opcional e indica onde está a grelha de programação (EPG).
2 #EXTINF:-1 Início da descrição de um canal. O -1 (ou 0) é a duração: em direto não há duração.
2 atributos tvg-… e group-title Dados extra para o leitor: identificador para o EPG, nome, logótipo, grupo.
2 ,Canal Notícias Depois da última vírgula vem o nome que aparece no ecrã.
3 https://…/noticias.m3u8 O endereço do canal. É isto que o leitor abre quando escolhes o canal.

As regras de base vêm da norma HLS, publicada pela IETF como RFC 8216: o ficheiro tem de estar em UTF-8, o nome termina em .m3u8 ou .m3u (ou o servidor declara o tipo application/vnd.apple.mpegurl ou audio/mpegurl), e #EXTM3U tem de ser a primeira linha. Os atributos tvg- não fazem parte dessa norma. São uma convenção dos leitores de IPTV, e é por isso que cada leitor reconhece um conjunto ligeiramente diferente.

Os atributos que importam

Atributo O que faz Onde está documentado
tvg-id Identificador do canal. Tem de coincidir com o identificador do canal no ficheiro de EPG (XMLTV) para a grelha aparecer. Kodi, PVR IPTV Simple
tvg-name Nome do canal usado pelo leitor (pode diferir do nome visível). Kodi; SS IPTV
tvg-logo Endereço da imagem do logótipo. Kodi; SS IPTV
group-title Grupo ou categoria onde o canal aparece (Desporto, Notícias…). Kodi
tvg-chno Número do canal na lista. Kodi
tvg-shift Ajuste de horas da grelha, para quando o EPG aparece desfasado. SS IPTV
x-tvg-url No cabeçalho: endereço do ficheiro de EPG. Kodi

Se o teu leitor ignora um atributo, o canal continua a funcionar. Só perdes esse extra, por exemplo o logótipo ou o grupo. O único que costuma dar dores de cabeça é o tvg-id: quando não coincide com o EPG, o canal abre mas fica sem programação. Explicamos como resolver isso em Como configurar o EPG no IPTV.

M3U ou Xtream Codes: qual é a diferença

A mesma subscrição costuma ser entregue de duas maneiras. Uma é o link M3U, que descarrega a lista completa de uma vez. A outra são os dados Xtream Codes (servidor, utilizador e palavra-passe), que a aplicação usa para pedir os canais, os filmes e a grelha ao servidor, à medida que precisa.

Link M3U Xtream Codes
O que recebes Um endereço que devolve a lista Servidor, utilizador e palavra-passe
Leitores Quase todos (VLC, Kodi, SS IPTV…) Só os que suportam este login
Listas grandes Podem demorar a carregar Carregam por partes
Filmes e séries Misturados na lista ou à parte Organizados em secções

Se uma aplicação te pede um link e só tens dados Xtream, pede o M3U ao fornecedor. Um detalhe de segurança: muitos links M3U de fornecedores incluem o teu utilizador e a tua palavra-passe dentro do próprio endereço. Trata o link como tratas uma palavra-passe e não o publiques em fóruns nem em capturas de ecrã.

Como abrir uma lista M3U

Onde Como
VLC (computador) Menu Ficheiro → Abrir transmissão de rede, cola o link, Reproduzir. Um ficheiro .m3u também abre se o arrastares para a janela. É o melhor sítio para testar uma lista.
Kodi Extensão PVR IPTV Simple Client, com o link no campo de caminho remoto. Passo a passo em Kodi e IPTV.
Smart TV LG e outras Aplicação SS IPTV, por link ou por código. Ver SS IPTV: como carregar a tua lista.
Box Android, Fire TV, telemóvel Aplicações como IPTV Smarters ou TiviMate aceitam link M3U ou Xtream.

No VLC, os nomes do menu acima são os da versão em português de Portugal. Com o programa em inglês, o caminho é Media → Open Network Stream.

Pessoa sentada num chão de madeira com um portátil aberto no colo

Foto: Andrew Neel / Unsplash

Porque é que a tua lista não abre

Antes de culpar o leitor, abre a lista num editor de texto simples (o Bloco de Notas, no Windows) e confirma estes pontos:

  1. A primeira linha não é #EXTM3U. Às vezes há uma linha em branco ou texto antes, e alguns leitores rejeitam a lista inteira.
  2. Os acentos aparecem trocados, do tipo “Informação”. O ficheiro não está em UTF-8. Guarda-o outra vez com essa codificação.
  3. O ficheiro chama-se lista.m3u.txt. O Windows esconde extensões por defeito e o leitor não reconhece o tipo.
  4. O link abre uma página de erro no navegador. A lista expirou, o endereço mudou, ou a tua subscrição terminou.
  5. A lista abre, mas os canais não. O problema já não é a lista, são os streams. Vê IPTV não funciona.

E as “listas M3U grátis”?

Uma boa parte de quem pesquisa “lista M3U” procura listas gratuitas partilhadas em sites, grupos e canais de vídeo. Não partilhamos listas e não as recomendamos. Costumam deixar de funcionar ao fim de dias, não tens a quem pedir ajuda quando falham, e não sabes quem controla os endereços que estás a abrir. Os riscos concretos, incluindo os legais e os de segurança, estão em IPTV grátis: o que estás a arriscar.

Se preferires uma lista mantida por um fornecedor, com EPG e com alguém do outro lado quando um canal falha, é o que vendemos no IPTV Portugal Premium. A estrutura é exatamente a que viste acima.

Perguntas frequentes

M3U e M3U8 são a mesma coisa?

Para o leitor, na prática sim. A norma RFC 8216 aceita as duas extensões e exige UTF-8 em qualquer delas. O que importa é que o ficheiro esteja mesmo nessa codificação.

Posso editar uma lista M3U?

Sim, é texto. Podes apagar canais, mudar grupos ou corrigir nomes num editor de texto. Se a lista vem por link, as tuas alterações perdem-se quando o fornecedor a atualizar.

Uma lista M3U pode ter vírus?

O ficheiro em si é texto e não executa nada. O risco está nos endereços que contém e nas aplicações que algumas listas pedem para instalar fora das lojas oficiais.

Lista M3U e EPG prontos a usar

O IPTV Portugal Premium envia link M3U, dados Xtream e endereço de EPG. Usas o que o teu leitor preferir.

Planos: 3 meses €19.99 · 6 meses €34.99 · 12 meses €59.99 · 24 meses €99.99

Experimenta grátis durante 24 horas

iptvpremium.pt · Guias e tutoriais IPTV para Portugal. Exemplos com endereços fictícios. Fontes: IETF RFC 8216, documentação do Kodi PVR IPTV Simple Client e do SS IPTV, consultadas em outubro de 2026.

Artigos Relacionados

Scroll to Top