Uma lista M3U que não carrega geralmente indica falha em uma de duas etapas: o navegador não conseguiu ler a fonte ou a resposta não continha itens de lista utilizáveis. Identifique a etapa antes de mudar o arquivo ou a URL. Se os nomes dos canais já aparecem, a importação deu certo; siga para a ajuda de reprodução de canais. Uma lista legível não garante que todos os endereços de mídia nela funcionem.
Lista M3U não carrega: relacione o sintoma à verificação
| O que você vê | O que conferir | Próximo passo útil |
|---|---|---|
| Os nomes aparecem, mas o vídeo não inicia | A mídia selecionada, em vez da importação | Investigar a reprodução |
| A URL abre um site ou uma página de login | Se o link retorna o texto da lista | Copie a URL bruta ou o link para player externo publicado pela fonte |
| O arquivo baixado é importado; a mesma URL falha | Acesso remoto, HTTPS e permissões do navegador | Compare a requisição da URL com a cópia local |
| O arquivo de texto não tem itens utilizáveis | Estrutura e endereços completos das transmissões | Confira uma lista válida no editor M3U |
| Um manifesto HLS baixado falha | Caminhos relativos e URL original da fonte | Examinar o manifesto |
Identifique o método de importação
Importar por URL e por arquivo testa coisas diferentes
Uma URL de lista faz o iiPTV solicitar texto a um servidor remoto. A importação local lê o texto de um arquivo escolhido no dispositivo. Quando uma lista M3U não carrega, comparar esses caminhos separa um problema de transporte de um problema no texto; nenhum deles muda a autorização para assistir. Se uma cópia baixada e autorizada é importada, mas a URL falha, investigue primeiro o acesso remoto. Se ambos falham com o mesmo conteúdo, examine o texto e os limites atuais de importação.
Guarde uma cópia sem alterações antes de editar. A URL do provedor pode conter um token privado de acesso; o suporte não precisa do endereço completo nem de uma captura sem ocultação do campo de importação.
O endereço de uma página não é uma lista bruta
Abra a fonte em outra aba. Texto real de lista ou um arquivo para download é um primeiro indício útil. Página de login, prévia de repositório, página inicial do provedor, erro HTML ou resposta de acesso negado não são conteúdo M3U. Algumas páginas de erro retornam um status HTTP de sucesso; por isso, o status sozinho não confirma uma lista válida.
Para arquivos no GitHub, copie o endereço bruto, não um caminho de repositório com /blob/. O guia de listas do GitHub explica essa diferença. Em outros servidores, use o link documentado para players externos. Não tente adivinhar um endereço acrescentando .m3u à página inicial de um site.
Lista M3U não carrega: confira o acesso remoto
Quando uma URL M3U não funciona
Confirme que a fonte original ainda existe e que o dispositivo consegue acessar o servidor. O responsável pode mover um arquivo, remover uma versão antiga, mudar um token de acesso ou tirar o serviço do ar temporariamente. Se houver um novo endereço documentado, copie-o e tente uma vez. Repetir a importação não recupera um arquivo removido.
Procure um link expirado, login obrigatório ou regra de acesso específica de região ou aplicativo. O iiPTV não implementa login em contas de provedores nem cabeçalhos de requisição personalizados. Uma URL que funciona no aplicativo do próprio provedor pode não ter sido destinada a um importador no navegador.
CORS explica algumas falhas que só ocorrem no navegador
Uma lista M3U que abre em uma aba, mas não carrega no importador, pode indicar um problema de acesso entre origens. Um script do navegador precisa que o servidor remoto permita a leitura da resposta; navegar diretamente até o endereço é outra operação. A documentação de CORS da MDN explica os cabeçalhos de resposta envolvidos.
Se o console identificar CORS, peça à fonte um método de acesso permitido. Quando o acesso do navegador falha, o importador pode tentar pelo Worker de mídia HTTPS do iiPTV. Uma cópia baixada e autorizada ajuda a isolar o problema de importação, mas não remove restrições da mídia dentro dela.
Use recursos HTTPS reais
Navegadores bloqueiam requisições HTTP diretas de listas em uma página HTTPS como conteúdo misto. O iiPTV envia essas requisições automaticamente pelo Worker de mídia HTTPS; a fonte ainda precisa estar acessível a partir dele. Trocar http por https só funciona se o servidor realmente fornecer o mesmo recurso com segurança.
Um erro de rede também pode significar tempo esgotado, falha de TLS ou DNS, perda de conexão ou servidor indisponível. Uma mensagem genérica não identifica CORS com certeza. Registre o que aparece antes de concluir a causa.
Lista M3U não carrega: examine o texto
Confira os itens, não apenas o nome do arquivo
A importação aceita arquivos de texto .m3u, .m3u8 e .txt. A extensão ajuda a identificar um arquivo, mas trocar a extensão de um download HTML para .m3u não o transforma em uma lista. Confira o conteúdo em um editor de texto: procure endereços de mídia e informações legíveis dos itens, em vez de marcação HTML, resposta vazia ou dados binários.
O guia do formato M3U traz um exemplo explicado. Uma lista de canais costuma começar com #EXTM3U, seguida de metadados #EXTINF e um endereço para cada item. Texto UTF-8 evita muitos problemas de exibição nos nomes. Preserve cada endereço completo, incluindo caminho e parâmetros necessários. Quando a lista estiver legível, o editor M3U permite conferir nomes, grupos e endereços antes de exportar uma cópia corrigida; ele não conserta uma página HTML de login.
Caminhos relativos precisam da base original
Se a lista M3U não carrega de um arquivo local, procure caminhos como streams/news.m3u8, em vez de endereços completos. A importação remota pode resolver esse caminho em relação ao endereço da lista. Um arquivo local não fornece a URL original, então o mesmo item pode ser ignorado ou falhar na validação. Use URLs de mídia completas e autorizadas em uma cópia local permitida ou importe a lista remota original.
Um manifesto HLS isolado também pode conter segmentos relativos. O analisador HLS identifica manifestos mestres e de mídia e seus recursos declarados. Use a URL original do manifesto para reproduzir: um arquivo baixado não leva consigo sua base web. Caminhos de disco local não viram transmissões web quando são renomeados.
Respeite os limites de tamanho e quantidade de itens
O iiPTV aceita até 5 MiB e 10.000 itens por importação. Se a entrada ultrapassa esses limites, use uma lista documentada menor ou uma cópia reduzida e autorizada. Renomear o arquivo não reduz seu tamanho, e dividi-lo sem critério pode separar os metadados de um item do endereço correspondente.
Lista M3U não carrega: tente com uma comparação controlada
Teste a demonstração incluída no mesmo navegador. Se a importação dela funcionar, concentre-se na resposta da fonte ou no conteúdo do arquivo. A demonstração verifica aquele exemplo controlado; não comprova acesso a outro provedor. Corrija uma variável por vez para saber qual alteração afetou o resultado.
Se a importação continuar falhando, registre as versões do navegador e do sistema, a entrada por arquivo ou URL, o tamanho aproximado, o resultado da demonstração e o erro visível. Envie essa descrição com dados sensíveis ocultados pela página de Contato. Quando os canais aparecerem, encerre a investigação da importação e teste a reprodução. Volte ao player M3U quando tiver uma fonte corrigida pronta.