iiPTV

Player M3U para arquivos e links de listas

Abra sua lista, confira as entradas e reproduza uma fonte compatível sem se cadastrar.

Abrir sua lista

Arraste um arquivo de lista ou cole uma URL M3U. Depois de importar, escolha um canal.

.m3u, .m3u8 ou .txt · até 5 MiB

Prepare sua lista antes de importar

O player usa os nomes, grupos e endereços que já estão no arquivo. Para alterar esses registros, guarde o original, use uma ferramenta de edição de listas e depois importe a cópia revisada.

Como o player M3U lê uma lista

Um player M3U lê um catálogo de texto com endereços de mídia. O formato M3U estendido costuma começar com #EXTM3U, seguido de metadados e URLs. A importação monta a lista de canais; o arquivo não contém o vídeo dos canais. Confira o exemplo mínimo abaixo antes de escolher uma fonte real.

#EXTM3U
#EXTINF:-1 group-title="Demo",My channel
https://example.com/channel.m3u8

Exemplo apenas para ilustrar o formato. example.com não é uma fonte de canal em funcionamento.

Ilustração conceitual de um player M3U lendo entradas ordenadas de uma lista e selecionando uma fonte de mídia.
Ilustração de um catálogo de texto que aponta para mídia; nenhum pacote de canais está incluído.

Entenda as entradas dos canais

#EXTINF descreve uma entrada. O nome vem depois da vírgula e group-title informa o grupo. A linha seguinte aponta para a mídia. O player M3U exibe esses nomes e grupos para você buscar ou filtrar após a importação. O nome é um metadado descritivo, sem garantir a disponibilidade do canal.

Use URLs completas em arquivos locais

Listas remotas resolvem caminhos de mídia relativos a partir da URL final da fonte. Arquivos enviados não têm um endereço público de base e precisam de endereços de mídia HTTP ou HTTPS completos. Endereços executáveis e credenciais de autenticação básica embutidas são recusados.

Abra um arquivo ou link de lista

Envie uma lista .m3u, .m3u8 ou .txt, ou cole uma URL que retorne o texto da lista. Arquivos locais ficam no navegador. Importações remotas usam conexão direta quando possível e o gateway de mídia quando HTTP ou restrições do navegador exigem. No GitHub, use o link do arquivo bruto em vez da página do repositório.

Confira a lista antes de reproduzir

O player M3U mostra a quantidade de entradas, os nomes e os grupos separadamente da reprodução de vídeo. Uma importação bem-sucedida significa que o catálogo foi lido, sem garantir que todas as fontes funcionem. O limite é de 5 MiB e 10.000 entradas. Protocolos incompatíveis são identificados na interface.

Quando usar uma lista local

Um arquivo local oferece ao player M3U uma cópia que você já controla. É útil para testar a leitura sem baixar o catálogo novamente ou quando o servidor do texto bloqueia o acesso pelo navegador. Escolha o arquivo e confira a quantidade de entradas importadas antes de selecionar a mídia.

Importar um arquivo local não torna as transmissões locais. O player continua solicitando cada endereço selecionado ao servidor original. A lista processada, incluindo links privados de mídia, fica em cache neste navegador para visitas futuras. Guarde uma cópia segura do original e limpe o player quando quiser remover esse cache.

Quando usar o link direto de uma lista

A importação por URL busca o catálogo atual no endereço publicado. Use uma URL direta de texto, em vez de uma página de compartilhamento ou visualização do repositório. Prefira HTTPS; HTTP e solicitações bloqueadas pelo navegador podem usar o gateway de mídia. Trocar apenas o esquema da URL não faz a fonte passar a oferecer HTTPS.

O player resolve endereços relativos remotos com base na URL final da resposta, inclusive após um redirecionamento verificado. Se o provedor mover o arquivo, obtenha o link publicado atualizado. Restrições de acesso, endereços expirados e respostas HTML são problemas diferentes do formato da lista.

Diferencie um catálogo de um manifesto HLS

Um catálogo de canais lista entradas independentes. Um manifesto HLS descreve variantes da transmissão ou segmentos de mídia em sequência. O player M3U trata uma entrada HLS reconhecida como uma única fonte, sem transformar cada segmento em um canal de TV. A extensão .m3u8 pode aparecer nos dois casos.

O player pode ler um manifesto e ainda assim falhar nos recursos seguintes. Segmentos, listas de variantes e chaves necessárias também precisam estar acessíveis de forma compatível. Uma primeira resposta válida é um teste útil, mas não garante toda a reprodução. O nome do arquivo não revela os codecs nem a disponibilidade futura da fonte.

Encontre e selecione o que você quer assistir

Após a importação, o player oferece busca por nome e filtro por grupo. Busque pelo nome fornecido no arquivo e, se precisar, refine pelo grupo. Catálogos grandes são exibidos em lotes menores para manter a interface prática. Fixe um canal que você usa com frequência para deixá-lo no início sem alterar o arquivo original.

Selecione a entrada que deseja abrir. O player não inicia todas as fontes durante a importação. Use Reproduzir quando o navegador exigir uma ação sua. Ao trocar de entrada, a conexão de mídia ativa é substituída. Limpe o catálogo ao terminar, principalmente em um dispositivo compartilhado.

Use o player adequado para a fonte

Aplicativos nativos podem oferecer suporte a mais protocolos, codecs e formas de autenticação. O player web aceita User-Agent e Referer pelo gateway de mídia, mas uma fonte que funciona em um app nativo ainda precisa de um formato compatível e de um servidor acessível para reproduzir no navegador.

Investigue o problema específico: uma fonte MP4 com H.264/AAC compatível ou HLS aceito pelo navegador é diferente de RTMP, RTSP ou conteúdo com DRM. O iiPTV não converte codecs nem desbloqueia mídia protegida. Peça à fonte uma forma de acesso compatível em vez de apenas renomear a extensão do arquivo.

Se a lista ou um canal não funcionar

Primeiro, verifique se o player conseguiu ler o arquivo ou a URL. Se a importação funcionou, compare a fonte selecionada com a demonstração controlada ou outra entrada. Restrições de acesso e codecs podem exigir uma fonte compatível ou outro aplicativo. Importe um manifesto HLS avulso pela URL para que os recursos relativos tenham um endereço de base.