O que significam tvg-id, group-title e tvg-logo na M3U

Os campos tvg-id, group-title e tvg-logo descrevem um canal na playlist M3U, mas cada um tem uma função. tvg-id pode ajudar a relacionar uma entrada aos dados de programação, group-title informa a categoria e tvg-logo aponta para o endereço de uma imagem. São metadados ao lado do endereço do stream: não criam um canal nem garantem que todo player IPTV mostre o guia ou o logo.

Uma entrada M3U comum tem uma linha #EXTINF seguida pelo endereço do stream. A ordem dos atributos pode variar. Este exemplo fictício mostra apenas a estrutura:

#EXTINF:-1 tvg-id="noticias-exemplo" group-title="Notícias" tvg-logo="https://example.invalid/logo.png",Notícias Exemplo
https://example.invalid/stream

Onde esses campos aparecem

Em uma playlist M3U comum, cada item tem uma linha #EXTINF com informações sobre a entrada e, na linha seguinte, o endereço da fonte. A parte antes da vírgula pode conter atributos; o texto depois da vírgula é o nome exibido na playlist. A formatação exata depende de como o provedor gerou o arquivo.

Separe três coisas: o nome do canal, os metadados e o endereço do stream. O nome ajuda a identificar o item. Os atributos acrescentam etiquetas. O URL aponta para a fonte de reprodução. Alterar um deles não corrige automaticamente os outros.

tvg-id: um identificador usado com dados de programação

tvg-id é um identificador de texto associado a uma entrada da playlist. Ele costuma ser usado para relacionar um canal a uma entrada do guia XMLTV. O feed XMLTV também pode identificar canais com os próprios IDs; quanto melhor o identificador da playlist corresponder ao do guia, mais fácil será associar o programa ao canal correto.

Não basta que os dois identificadores pareçam semelhantes. Os dados fornecidos pela fonte precisam corresponder. Variações regionais, versões diferentes de um canal ou uma alteração feita pelo provedor podem impedir a associação, mesmo quando a reprodução funciona. Por outro lado, a ausência de tvg-id não significa automaticamente que o canal não possa ser reproduzido: isso depende do player e de outros métodos possíveis de correspondência.

Se o canal toca, mas o guia está vazio ou mostra a programação de outra emissora, investigue a reprodução separadamente da correspondência do EPG. O resultado depende da playlist, do feed do guia e do player.

group-title: a categoria do canal

group-title informa o grupo ao qual o provedor associou um item, como “Esportes”, “Notícias” ou “Documentários”. É uma categoria dentro da playlist, não uma fonte separada nem parte do endereço do stream. Os grupos ajudam a organizar uma lista longa.

O provedor escolhe os nomes das categorias. Eles podem aparecer abreviados, em outro idioma ou formatados de maneira diferente em grupos parecidos. Uma categoria vazia ou inesperada pode ser um problema nos metadados da playlist, não na reprodução. Não altere o URL do stream só porque o nome do grupo parece estranho.

tvg-logo: o endereço da imagem do canal

tvg-logo aponta para um URL de imagem associado ao item. É uma referência à arte, não a imagem em si. Se o endereço estiver desatualizado, indisponível ou malformado, o logo pode não aparecer mesmo que o canal funcione. Players diferentes também podem lidar de formas distintas com imagens ausentes ou inválidas.

O logo não controla a disponibilidade do stream nem fornece dados de programação. Se a imagem estiver ausente, mas a reprodução funcionar, verifique primeiro se o provedor ainda fornece um URL atualizado. Não confunda a falta do logo com um canal quebrado.

Consulta rápida

Campo

Para que serve

O que não garante

tvg-id

Identificar um canal para relacionar dados de programação

Que todo feed XMLTV será compatível

group-title

Nomear uma categoria da playlist

Que o canal será reproduzido

tvg-logo

Fornecer o endereço de uma imagem

Que a imagem esteja disponível ou válida

Essa diferença ajuda a localizar um problema. Se o canal funciona e o guia não, verifique a fonte e a correspondência em vez de alterar o stream. O DaddyTV aceita fontes M3U e um guia XMLTV opcional; ainda assim, o tratamento exato dos metadados depende da playlist, do feed EPG e do player.

Como conferir uma entrada M3U com segurança

Se o provedor fornecer um arquivo, abra-o localmente em um editor de texto confiável. Não cole a playlist inteira em um analisador público on-line, pois os URLs podem conter dados de acesso. Para comparar os atributos, bastam algumas linhas #EXTINF, sem expor o endereço real do stream.

Confira se tvg-id está presente, se group-title tem um valor coerente e se o URL em tvg-logo parece completo. Depois, compare o identificador com a documentação ou com um exemplo de XMLTV do provedor. Não edite os valores da playlist inteira sem saber como o player os usa. Guarde uma cópia original e peça os metadados corretos ao provedor se algo estiver faltando.

Três confusões comuns

Primeiro, tvg-id não é o endereço do canal: é um identificador. Segundo, group-title não cria a programação da TV; ele informa uma categoria, mas não contém horários de programas. Terceiro, tvg-logo não é um arquivo de imagem obrigatório. O URL pode estar antigo ou indisponível. Em todos esses casos, o stream ainda pode funcionar normalmente, mesmo com metadados incompletos.

Confira cada camada separadamente: primeiro o canal, depois o grupo, a imagem e o guia. tvg-id identifica o canal, group-title indica a categoria e tvg-logo fornece o endereço da imagem. Nenhum deles substitui o URL do stream ou um feed XMLTV completo. Se o vídeo funciona, mas o guia está ausente, concentre-se na correspondência do guia. Se o canal não reproduz, investigue a fonte separadamente.

Para configurar uma fonte, consulte a página do player M3U; para um guia separado, veja também a página do player XMLTV EPG.

Para ver um resumo dos dispositivos compatíveis, acesse a página de plataformas.