O que é uma lista M3U? Guia prático sobre formato e tags

Uma lista M3U é um arquivo de texto ou URL que reúne itens de mídia e informa onde um player compatível pode encontrá-los. Em listas IPTV, o formato M3U costuma usar linhas EXTINF e metadados como tvg-id, tvg-logo e group-title para descrever cada canal. Este guia explica a estrutura, mostra um exemplo e ensina a conferir e reproduzir conteúdo que você tem autorização para assistir.

Principais pontos

Uma lista M3U reúne endereços de mídia; ela não contém o vídeo nem o canal em si.
#EXTM3U inicia uma lista, enquanto #EXTINF geralmente descreve o item seguinte.
Atributos como tvg-id, tvg-logo e group-title são convenções de metadados amplamente usadas em listas IPTV.
M3U e M3U8 são formatos de lista relacionados; por convenção, M3U8 usa texto UTF-8.
Um player compatível no navegador pode abrir uma URL M3U ou um arquivo de lista enviado, mas os streams ainda precisam ser válidos e autorizados.

O que é uma lista M3U?

Na prática, o que é uma lista M3U? É um índice de texto simples que direciona um player de mídia para um ou mais itens de áudio ou vídeo. Uma entrada pode apontar para um arquivo local, um stream de rede ou outro recurso de mídia. Em geral, a lista não contém o vídeo em si; ela informa ao player o que tentar abrir.

Em IPTV, uma lista M3U normalmente contém várias entradas de canais. Cada entrada pode incluir informações descritivas, como o nome ou a categoria do canal, seguidas do endereço do stream. Um player compatível lê essas informações e mostra as entradas em uma lista navegável. A reprodução do stream depende do endereço, da sua conexão, dos recursos do player e dos seus direitos de acesso.

Você pode receber uma lista como arquivo para baixar, geralmente com extensão .m3u ou .m3u8, ou como URL. Trate URLs de listas privadas como credenciais de acesso: elas podem conter informações de acesso, então evite publicá-las ou compartilhá-las abertamente. Carregue apenas conteúdo que você tem autorização para assistir na sua região.

Como funciona o formato M3U

O formato M3U foi pensado para ser fácil de ler: abra uma lista básica em um editor de texto para conferir suas linhas. Uma lista IPTV típica começa com um cabeçalho e, em seguida, repete uma linha de descrição e um endereço de mídia. Também podem aparecer linhas em branco e comentários. Os metadados exatos variam conforme quem cria a lista e o player usado, por isso nem todos os players exibem todos os campos.

Linha ou campo	O que geralmente significa	O que um player pode fazer com ele
#EXTM3U	Cabeçalho da lista	Reconhece o arquivo como uma lista M3U estendida
#EXTINF	Informações da entrada, geralmente com duração e título	Usa o título como nome de exibição
tvg-id	Identificador opcional do canal	Pode associar uma entrada aos dados do canal em um sistema compatível
tvg-logo	Endereço opcional do logotipo	Pode exibir a imagem ao lado da entrada
group-title	Nome opcional da categoria ou do grupo	Pode organizar as entradas em seções
Endereço do stream	Localização do recurso de mídia	Tenta abrir o stream

O símbolo de cerquilha no início de uma tag indica que ela contém informações da lista, e não um endereço de stream. Em muitas listas IPTV, uma linha que começa com #EXTINF descreve a linha de endereço seguinte. Se esse endereço estiver ausente, malformado ou indisponível, a entrada pode aparecer na lista, mas não reproduzir.

Entenda a tag EXTINF e os atributos IPTV

EXTINF é a abreviação de extended information (informações estendidas). Em uma entrada IPTV comum, ela começa com um valor de duração, seguido de atributos opcionais e de um nome de exibição separado por vírgula. Entradas de canais ao vivo costumam usar -1 como duração, pois não têm um tempo de reprodução fixo. Outras listas podem usar uma duração positiva para um item de mídia com tempo definido.

tvg-id: Identificador de texto associado a um canal. Pode ajudar um software compatível a associar o canal a outros dados, mas o campo, por si só, não fornece esses dados.
tvg-logo: Endereço do logotipo de um canal. O player pode exibir a imagem se for compatível com o atributo e conseguir acessar o logotipo.
group-title: Rótulo de categoria, como “Notícias” ou “Cultura”, que o player pode usar para agrupar entradas.

Esses atributos são convenções comuns em IPTV, mas não há garantia de que todos os players os interpretem da mesma forma. A grafia e as aspas são importantes: mantenha os nomes dos atributos intactos, coloque os valores entre aspas quando indicado e evite inserir uma quebra de linha no meio de uma entrada. Se o player ignorar um logotipo ou rótulo de grupo, o stream ainda poderá funcionar.

Exemplo de M3U: como ler uma entrada da lista

Aqui está um pequeno exemplo de M3U com endereços fictícios. O domínio .invalid é reservado para exemplos, portanto estas linhas não são streams reproduzíveis. A estrutura mostra como o nome de um canal, os metadados e o endereço do stream se relacionam:

#EXTM3U
#EXTINF:-1 tvg-id="news.example" tvg-logo="https://logo.example.invalid/news.png" group-title="News",Example News
https://stream.example.invalid/live/index.m3u8
#EXTINF:-1 tvg-id="culture.example" tvg-logo="https://logo.example.invalid/culture.png" group-title="Culture",Example Culture
https://stream.example.invalid/culture/index.m3u8

A primeira linha identifica o cabeçalho da lista. A seguinte descreve a primeira entrada: -1 é a duração, os atributos tvg fornecem metadados opcionais e o texto após a vírgula é o título que o player pode exibir. O endereço na linha seguinte é o local da mídia associado a essa entrada. A próxima linha EXTINF inicia uma segunda entrada.

Listas reais podem usar nomes de atributos diferentes, omitir logotipos, incluir metadados adicionais ou apontar para um formato de stream diferente de HLS. Para ver um passo a passo prático de como montar uma lista, confira como criar uma lista M3U. Você também pode usar o editor de listas M3U para trabalhar com o texto da lista ou o conversor M3U para converter um arquivo de lista compatível.

M3U e M3U8: qual é a diferença?

M3U e M3U8 são extensões de listas bastante relacionadas. Por convenção, M3U8 indica uma lista codificada em UTF-8, que permite representar uma grande variedade de caracteres de forma consistente. Um arquivo M3U pode usar outras codificações de texto, especialmente se for antigo; por isso, acentos ou nomes de canais em alfabetos não latinos às vezes podem aparecer incorretamente quando a codificação é interpretada de outra forma.

A extensão, por si só, não indica se uma lista é válida, se um stream está acessível ou se um player é compatível com a mídia apontada. M3U8 também é bastante usada em listas de streaming HLS, mas um arquivo de lista M3U8 não é o mesmo que os segmentos de vídeo para os quais ele pode apontar. Saiba mais neste guia sobre M3U e M3U8 ou abra uma lista compatível com o player M3U8 online.

Como abrir e usar uma lista M3U

Para usar uma lista, você precisa de um player compatível e de um arquivo ou URL de lista que funcione. O processo geral é simples, embora os controles exatos variem conforme o aplicativo ou navegador:

Obtenha o arquivo ou a URL M3U de uma fonte confiável que você tenha autorização para usar. Confira se o link é de uma lista completa ou de um stream individual.
Abra um player compatível com listas M3U e escolha a opção de URL ou arquivo. Por exemplo, o XtremPlay oferece um player M3U online para assistir pelo navegador.
Insira a URL da lista ou envie o arquivo e aguarde o carregamento das entradas. Se forem solicitados dados do Xtream Codes, informe apenas as credenciais fornecidas pelo serviço que você está autorizado a usar.
Escolha uma entrada e teste a reprodução. Se uma categoria estiver vazia ou um stream não funcionar, confira os dados da lista e o endereço antes de concluir que o problema está no player.

O XtremPlay é um player IPTV gratuito para navegador, disponível em xtremplay.com. Ele aceita URLs de listas M3U e M3U8, envio de arquivos M3U e login pelo Xtream Codes usando URL do servidor, nome de usuário e senha. Conta com seções de TV ao vivo, filmes e séries, além de vários perfis de usuário. O XtremPlay não fornece canais nem assinaturas, então você precisa ter conteúdo que esteja autorizado a assistir.

Como funciona no navegador, o XtremPlay é compatível com Smart TVs, tablets, celulares e computadores, incluindo navegadores Samsung Tizen, LG webOS, Android TV e Google TV; Fire TV e Firestick pelo Silk; iPad e tablets Android; Android e iPhone; e Windows, Mac, Linux e Chromebook. Confira as instruções para usar IPTV em uma Smart TV ou assistir em diferentes dispositivos. Ele também oferece um modo compatível com controle remoto de TV, pode ser adicionado à tela inicial como um aplicativo web e conta com uma extensão opcional para Chrome. Os dados de login permanecem no navegador do usuário. O proxy integrado permite reproduzir streams HTTP no site HTTPS.

Problemas comuns com listas M3U e como verificá-los

Se você está se perguntando o que uma lista M3U deveria fazer quando não carrega, comece separando os problemas da lista dos problemas do stream. Uma lista pode abrir corretamente enquanto um ou mais streams indicados estão offline, restritos ou não são compatíveis com o player.

A lista não carrega: Confirme se a URL está completa e sem espaços adicionados ou tente enviar o arquivo original. Verifique se o link expirou ou exige acesso válido.
As entradas aparecem, mas não reproduzem: Confira o endereço do stream e sua autorização e teste a conexão de rede. A presença de uma entrada na lista não significa que a fonte esteja online no momento.
Os nomes, logotipos ou grupos não aparecem: Confira a pontuação e os atributos da linha EXTINF. Alguns players não exibem todos os campos de metadados.
O texto aparece ilegível: A lista pode estar usando uma codificação que está sendo interpretada incorretamente. UTF-8 é a convenção mais comum para arquivos M3U8.
Apenas alguns streams falham: Essas fontes podem estar indisponíveis, exigir um formato compatível ou ter restrições de acesso. Uma ferramenta de verificação de streams pode ajudar a conferir a disponibilidade, mas não concede acesso.

Para investigar melhor, use o verificador de streams e leia o guia para corrigir uma lista M3U que não funciona. Atualmente, o XtremPlay não oferece grade de EPG, gravação ou recursos de replay. Se precisar de conteúdo de exemplo para testes, a página de listas IPTV públicas e legais reúne listas públicas gratuitas; a disponibilidade e o uso permitido continuam sujeitos aos termos de cada fonte.

Conclusão: entenda sua lista antes de reproduzi-la

Uma lista M3U é um índice legível, e suas tags ajudam um player compatível a organizar os endereços de mídia que ela contém. Quando você entende como funcionam #EXTM3U, EXTINF e os atributos mais comuns, fica mais fácil identificar problemas de formatação, saber o que um player pode exibir e solucionar problemas com um stream que não abre. A lista é apenas uma referência: ela não fornece o conteúdo nem a permissão para assisti-lo.

Pronto para testar uma lista que você tem autorização para usar? Experimente o player gratuito XtremPlay em xtremplay.com pelo navegador da sua TV, tablet, celular ou computador. Carregue uma URL M3U ou envie um arquivo M3U e navegue pelas entradas em um player no navegador, sem instalar um aplicativo tradicional.

Perguntas frequentes

Para que serve uma lista M3U?

Uma lista M3U reúne itens de mídia e os endereços onde um player compatível pode encontrá-los. Listas IPTV costumam usá-la para organizar entradas de canais e seus endereços de stream.

Um arquivo M3U contém o vídeo?

Geralmente, não. Ele costuma ser um índice de texto que aponta para os endereços de mídia, em vez de um arquivo que contém o próprio vídeo.

O que significa EXTINF em uma lista M3U?

EXTINF é uma tag que fornece informações sobre a próxima entrada da lista, geralmente incluindo uma duração e um título de exibição. Listas IPTV também podem incluir atributos de metadados na linha EXTINF.

O que significam tvg-id, tvg-logo e group-title?

São atributos comuns de metadados IPTV para indicar o identificador de um canal, o endereço do logotipo e o nome da categoria. Os players podem interpretá-los ou exibi-los de maneiras diferentes, e alguns podem ignorá-los.

Qual é a diferença entre M3U e M3U8?

São formatos de lista relacionados, e M3U8 indica, por convenção, codificação de texto UTF-8. A extensão, por si só, não garante que a lista ou seus streams funcionem.

Posso reproduzir uma lista M3U no navegador?

Sim, se você usar um player para navegador compatível com URLs M3U ou envio de arquivos e os streams indicados estiverem acessíveis. O XtremPlay aceita URLs de listas M3U e M3U8 e arquivos M3U enviados; ele não fornece canais nem assinaturas.