Uma lista M3U é um arquivo de texto que contém endereços de mídia. Ela pode incluir nomes de canais, grupos e identificadores, mas normalmente guarda referências, não o vídeo em si. Uma URL remota de lista M3U aponta para esse arquivo de texto; os itens dentro dele apontam para recursos de mídia separados. Este guia explica como ler uma lista, importá-la com cuidado e diferenciar um problema no arquivo de uma transmissão que não reproduz.
O que uma lista M3U contém
Uma lista M3U fornece ao player uma sequência de endereços de mídia. Eles podem ser URLs completas, caminhos relativos ou caminhos locais, conforme o fluxo previsto por quem criou a lista. Uma ferramenta no navegador não consegue tratar todo tipo de endereço como uma transmissão remota reproduzível. O formato do arquivo e a capacidade de acesso do player são questões separadas.
Salvar a lista não baixa os vídeos
Salvar uma lista guarda seu texto. Isso não baixa automaticamente os programas apontados pelos itens. A lista pode ocupar poucos quilobytes, enquanto a transmissão selecionada transfere mídia continuamente. Ao salvar uma cópia, guarde o endereço original da fonte: ele pode ser necessário para resolver caminhos ou obter atualizações.
Leia um exemplo prático de M3U
Este exemplo ilustra apenas a estrutura. Os endereços example.com não são canais em funcionamento.
#EXTM3U
#EXTINF:-1 tvg-id="education-example" group-title="Aprendizado",Exemplo educativo
https://example.com/live/education.m3u8
#EXTINF:-1 group-title="Arquivo",Exemplo de arquivo
https://example.com/video/archive.mp4
Cabeçalho, item e endereço
#EXTM3U inicia uma lista M3U estendida. Uma linha #EXTINF descreve o item de mídia seguinte; a próxima linha informa o endereço. O nome depois da vírgula serve como rótulo de exibição. Aqui, os dois itens apontam para tipos diferentes de mídia, mostrando por que uma mesma lista M3U pode conter fontes com requisitos de reprodução distintos.
As convenções variam conforme quem produz
Atributos IPTV como tvg-id e group-title ajudam a organizar informações, mas não garantem um comportamento universal dos players. Projetos comunitários documentam suas convenções; veja o guia de contribuição do iptv-org. A ausência de um atributo é diferente da ausência de um endereço de mídia. Não descarte um item legível só porque seus metadados opcionais são escassos.
Arquivos, URLs e caminhos relativos
Importe um arquivo de texto local
O navegador lê no dispositivo o arquivo de texto escolhido. Ele não envia a lista para uma biblioteca salva. Isso elimina a etapa inicial de baixar o arquivo remoto, mas selecionar um canal ainda exige acesso ao servidor da mídia. Uma cópia local também pode ficar desatualizada quando o autor muda a original.
Carregue uma URL de lista
Uma URL direta permite que o importador busque o texto atual da lista M3U. Uma prévia de repositório, página de download ou tela de login não é a resposta do arquivo. A fonte precisa permitir a requisição do navegador. O guia de CORS da MDN explica por que abrir um endereço em uma aba não comprova que outro site possa lê-lo.
Endereços relativos precisam de uma base
Em uma lista M3U remota, live/channel.m3u8 pode ser resolvido a partir da URL da lista. Um arquivo de texto local não tem uma base remota equivalente. Substitua os itens relativos por endereços HTTPS completos e autorizados antes de importar uma cópia local. Caminhos de disco local não substituem mídia hospedada para o navegador.
Importe e confira a lista
- Preserve a lista M3U original antes de editar.
- Abra o player M3U e escolha o método de entrada adequado.
- Importe o arquivo ou a URL direta e confira os nomes e grupos exibidos.
- Busque um item reconhecível, sem testar todos os canais de uma vez.
- Selecione esse item e pressione Reproduzir; registre importação e reprodução como resultados separados.
Uma lista M3U legível comprova apenas que os itens foram processados. Se ela aparece corretamente, mas um canal falha, passe à camada da mídia. Importar repetidamente o mesmo texto não muda o codec, as exigências de acesso nem a disponibilidade da fonte.
Entenda nomes, grupos e metadados
Os rótulos ajudam na navegação
O nome depois de #EXTINF permite identificar um item sem mostrar a URL completa da mídia. Os metadados de grupo dividem uma lista M3U em conjuntos úteis. Os autores podem usar padrões de nomes diferentes; por isso, a ausência de grupo não deve ser confundida com uma transmissão quebrada. A busca e os filtros por grupo trabalham sobre os itens importados, não sobre todo o catálogo de um provedor.
Um identificador estável pode ajudar o autor a distinguir dois itens de nome parecido. Ao editar uma cópia pessoal, mude o rótulo de exibição sem unir acidentalmente endereços de mídias diferentes. Mantenha um endereço de mídia por item e use nomes de grupos consistentes para servirem de filtro. Essas pequenas escolhas melhoram a organização da lista sem fingir que verificam as transmissões.
Metadados não autorizam a reprodução
Um identificador de canal não faz login em uma assinatura. Um logotipo não comprova propriedade, e um rótulo bem apresentado não confirma disponibilidade. Este player não busca automaticamente os logotipos de listas de terceiros. Ao criar uma lista para compartilhar, não coloque tokens privados nem dados da conta do provedor nos nomes.
Analise um exemplo de lista com falha
Considere uma lista M3U autorizada com dois itens. O primeiro usa uma URL HTTPS completa; o segundo usa clips/example.mp4. Ambos são resolvidos quando a lista é carregada do endereço web original. Você baixa o texto, importa a cópia local e o item relativo é rejeitado. Esse caso hipotético aponta para a falta de endereço-base, não para um codec MP4 incompatível.
Outro caso começa com uma página HTML copiada para um arquivo chamado channels.m3u. Renomear o arquivo não o transformou em uma lista M3U. Abra-o como texto, compare a estrutura com o exemplo e volte ao link de download publicado. Use a ajuda para carregar listas para falhas de busca ou interpretação.
Se existe um endereço real de mídia, mas a transmissão não inicia, consulte a ajuda de reprodução. O guia M3U e M3U8 também explica por que um manifesto HLS não tem a mesma função de uma lista M3U com vários canais.
Mantenha e compartilhe sua lista M3U com cuidado
Anote de onde a lista veio, quando você a obteve e quais usos a fonte permite. Atualize endereços a partir do publicador original, sem copiar substituições sem explicação. Uma data de arquivo recente é um contexto útil, não uma prova de que todos os itens funcionam.
Mantenha privadas as credenciais das suas fontes. Os itens processados, incluindo URLs de mídia, ficam em cache neste navegador após atualizar a página; use Limpar ou apague os dados do site para removê-los. Guarde seu arquivo original por conta própria. Ao relatar um problema, descreva a etapa que falhou e forneça um exemplo mínimo com os dados sensíveis ocultados, em vez de enviar uma coleção privada inteira.