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
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.
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:
- A primeira linha não é
#EXTM3U. Às vezes há uma linha em branco ou texto antes, e alguns leitores rejeitam a lista inteira. - Os acentos aparecem trocados, do tipo “Informação”. O ficheiro não está em UTF-8. Guarda-o outra vez com essa codificação.
- O ficheiro chama-se
lista.m3u.txt. O Windows esconde extensões por defeito e o leitor não reconhece o tipo. - O link abre uma página de erro no navegador. A lista expirou, o endereço mudou, ou a tua subscrição terminou.
- 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
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
Explora Outros Guias IPTV
- → Como Ver IPTV no PC (Windows e Mac) com VLC ou Kodi
- → SS IPTV: Como Carregar a Tua Lista na Smart TV (Link ou Código)
- → Onde Ver a Liga Portugal em 2026/27: Canais, Champions e Preços
- → IPTV vs MEO, NOS e Vodafone: Quanto Pagas e o Que Ganhas (2026)
- → Kodi e IPTV: Como Configurar com o PVR IPTV Simple Client
- → Como Ver IPTV na Apple TV (e no Chromecast)
- → Como Escolher um Fornecedor de IPTV: 9 Sinais de Alerta
- → IPTV Grátis: O Que Estás Mesmo a Arriscar
- → IPTV Não Funciona? Diagnóstico Rápido por Sintoma
- → Onde Ver Fórmula 1 e MotoGP em Portugal (e o Que Muda em 2027)
- → Como Instalar IPTV numa Box Android TV (Xiaomi, Nvidia Shield e Google TV)
- → IPTV para Portugueses no Estrangeiro: Ver RTP, SIC e TVI Fora de Portugal
- → Como Configurar o EPG (Guia TV) no IPTV: Guia Completo
- → Que Velocidade de Internet Precisa para IPTV? (Guia 2026)
- → Canais Portugueses em IPTV: RTP, SIC, TVI e Desporto (2026)
- → Como Ver IPTV no iPhone e iPad: Guia Completo iOS 2026
- → É Legal Usar IPTV em Portugal? Tudo o Que a Lei Diz em 2026
- → IPTV vs TV por Cabo: Porque Milhões Estão a Mudar em 2026
- → Como Ver Futebol em Direto com IPTV em Portugal [2026]
- → Melhores Aplicações IPTV para Firestick e Android TV [2026]
- → IPTV com Buffering? 10 Soluções Comprovadas para Parar o Lag [2026]
- → Melhor IPTV em Portugal [2026]: Serviços Testados e Classificados
- → Como Instalar IPTV numa Smart TV Samsung e LG em 2026 (Guia Completo)
- → TiviMate vs IPTV Smarters Pro: Qual é Melhor em Portugal? (2026)
- → Como Instalar IPTV no Amazon Firestick em 2026 (Guia Completo)
- → Como Instalar e Configurar o IPTV Smarters Pro em Qualquer Dispositivo
- → Como Instalar IPTV em Qualquer Dispositivo em Portugal (2026)
- → O Que é IPTV? Guia Completo Para Portugal 2026
- → VPN para IPTV em Portugal (2025): Guia Definitivo para Acabar com Cortes e Buffering
- → IBO Player: Tutorial Completo de Instalação e Configuração IPTV (2026)
- → “Authorization Failed for Above Host” IPTV Smarters Pro — 8 Soluções (2026)