IPTV no Kodi: configurar PVR IPTV Simple Client com M3U e EPG

O Kodi não reproduz uma lista de IPTV direto na interface principal: ele usa a infraestrutura PVR (gravador de vídeo pessoal), comum a várias fontes de TV ao vivo. Para IPTV, o addon oficial mais usado é o PVR IPTV Simple Client. Este guia explica como instalá-lo e configurá-lo com uma lista M3U e um EPG XMLTV.

O que você precisa?

• O Kodi instalado no dispositivo (Windows, macOS, Linux, Android ou Android TV, por exemplo).
• Uma URL M3U fornecida pelo seu acesso IPTV.
• Se disponível, uma URL de EPG em formato XMLTV, para ver o guia de programação.

Como instalar o addon PVR IPTV Simple Client?

1. No Kodi, abra Configurações > Add-ons ou o menu equivalente, conforme o idioma da interface.
2. Escolha Instalar a partir de um repositório.
3. Acesse a categoria Clientes PVR.
4. Selecione PVR IPTV Simple Client e depois Instalar.

Esse addon é mantido pela própria equipe do Kodi, como mostra o repositório oficial no GitHub; ele não é um módulo de terceiros sem verificação.

Como configurar a lista M3U?

1. Depois de instalar, abra as configurações do addon PVR IPTV Simple Client, pelo ícone de configuração ao lado do nome ou por Configurações > Add-ons > Meus add-ons.
2. Na aba Geral, escolha o tipo de fonte (Caminho local ou URL remota) para a lista M3U.
3. Digite a URL M3U completa fornecida pelo seu acesso.
4. Confirme e ative o addon se o Kodi pedir.

Como adicionar o EPG XMLTV?

1. Na mesma tela de configurações, abra a aba EPG.
2. Escolha a fonte do EPG (Caminho local ou URL remota) e digite a URL XMLTV fornecida com o seu acesso, caso ela venha à parte da lista M3U.
3. Se precisar, ajuste a defasagem de horário nas configurações do addon quando os horários aparecerem defasados.
4. Confirme e deixe o Kodi atualizar o EPG.

Nesse addon, o EPG e a lista M3U são duas fontes distintas: uma lista de reprodução funcionando não significa que o EPG está automaticamente configurado.

Onde encontrar os seus canais no Kodi?

Assim que a lista de reprodução carrega, os canais aparecem na seção TV ao vivo do menu principal do Kodi, junto com a programação se o EPG tiver sido configurado. Nosso guia do EPG explica esse processo de forma mais geral. Se a seção não aparecer, verifique se o PVR foi ativado em Configurações > Sistema > TV ao vivo ou na tela que o Kodi mostra ao iniciar um addon PVR pela primeira vez.

Opções avançadas

O repositório oficial do addon documenta várias configurações extras úteis, conforme o acesso IPTV: agrupamento de canais por categoria, correspondência de gêneros no EPG, suporte a funções de atualização quando o fornecedor as oferece e compressão Gzip ou XZ para arquivos XMLTV grandes. Essas opções não são necessárias para uma primeira configuração funcional.

Solução de problemas

• Não aparece nenhum canal: verifique se a URL M3U foi copiada por inteiro e se o addon foi ativado depois da instalação.
• A grade do EPG continua vazia: confirme que você digitou uma URL XMLTV separada na aba EPG das configurações do addon.
• Os horários do EPG parecem defasados: ajuste a defasagem de horário nas configurações do addon.
• A reprodução está instável: o problema costuma estar na rede, e não na configuração do Kodi. Veja nosso guia de IPTV travando.

Em resumo

Para assistir IPTV no Kodi, use o addon oficial PVR IPTV Simple Client: uma URL M3U para os canais, uma URL XMLTV separada para o EPG e, por fim, os conteúdos mostrados na seção de TV ao vivo do Kodi. Para conhecer um método de configuração válido em qualquer dispositivo, veja nosso guia de instalação de IPTV, que explica os três métodos universais.