Neste artigo
Este artigo faz parte do guia Kodi: o que é, para que serve e como instalar (guia 2026).
Para ver IPTV no Kodi, instale o addon oficial PVR IPTV Simple Client a partir do repositório do Kodi, indique-lhe o URL da lista M3U do seu serviço e, se tiver, o URL do guia XMLTV, e ative-o. Os canais passam a aparecer na secção TV do Kodi, com guia de programação, como num leitor dedicado. A documentação oficial está na Kodi Wiki.
Se ainda não tem o Kodi, veja Kodi: o que é e como instalar.
O que precisa
- Kodi instalado e atualizado (versão estável).
- URL M3U do seu serviço (ou ficheiro .m3u). Veja URL da lista M3U.
- URL do EPG (XMLTV), se o serviço o fornecer.
- Opcional: pasta ou URL de logótipos dos canais.
Passo 1: instalar o addon
- Definições (roda dentada) › Addons.
- Instalar a partir do repositório › Clientes PVR.
- Escolha PVR IPTV Simple Client › Instalar.
Em algumas plataformas (por exemplo, certas distribuições Linux), os clientes PVR vêm em pacotes separados do sistema; a Kodi Wiki explica os casos.
Passo 2: adicionar a lista M3U
- Em Addons › Os meus addons › Clientes PVR › PVR IPTV Simple Client, escolha Configurar.
- Em Geral (ou "M3U"), escolha a localização: Caminho remoto (endereço de internet) para um URL, ou Caminho local para um ficheiro.
- Cole o URL M3U no campo correspondente.
- Mantenha a opção de cache ativa se a lista for grande e não mudar com frequência.
Passo 3: adicionar o guia (EPG)
- No separador EPG, escolha Caminho remoto e cole o URL XMLTV.
- Se os horários aparecerem desfasados, ajuste o desvio do EPG (em horas) ou, melhor, confirme o fuso horário do Kodi em Definições › Interface › Regional (Europa/Lisboa).
- Se a sua lista M3U já indicar o EPG no cabeçalho (atributo url-tvg), o addon pode usá-lo automaticamente.
Passo 4: ativar e ver
- Volte à página do addon e escolha Ativar (se ainda não estiver ativo).
- Reinicie o Kodi, se necessário.
- No menu principal, abra TV: canais, guia e gravações (se configuradas) aparecem aí.
Opções úteis
| Opção | Para quê |
|---|---|
| Logótipos (Channel logos) | Mostrar logótipos a partir de uma pasta ou URL |
| Catch-up | Ver programas anteriores, se o serviço o suportar e a lista tiver a informação |
| Grupos | Mostrar só os grupos de canais que lhe interessam |
| Várias instâncias | Versões recentes permitem configurar mais do que uma lista |
| Atualização da lista | Definir de quanto em quanto tempo a lista é recarregada |
Os nomes das opções podem variar entre versões do addon; a Kodi Wiki tem a referência atualizada.
Erros comuns
| Problema | Causa provável | Solução |
|---|---|---|
| Separador TV não aparece | Addon não ativado | Ativar o PVR IPTV Simple Client |
| "Nenhum canal" | URL M3U errado ou conta sem acesso | Testar o URL no VLC |
| Guia vazio | URL XMLTV errado, ou IDs que não correspondem | Confirmar URL; associação tvg-id na lista |
| Horários desfasados uma hora | Fuso horário | Europa/Lisboa nas definições do Kodi |
| Canais demoram a abrir | Lista muito grande, box modesta | Ocultar grupos; ativar cache |
| Kodi lento depois da lista | EPG de muitos dias | Reduzir dias de EPG nas definições de TV |
PVR Simple Client ou leitor dedicado?
O Kodi com o PVR IPTV Simple Client é excelente se já usa o Kodi para a sua biblioteca de filmes e música e quer tudo num só sítio. Se só quer televisão em direto com o mínimo de configuração, um leitor dedicado é mais simples. Comparamos em Melhores aplicações IPTV.
Perguntas frequentes
O PVR IPTV Simple Client é oficial?
Sim, é um addon do repositório oficial do Kodi, documentado na Kodi Wiki.
O Kodi aceita login Xtream Codes?
O PVR IPTV Simple Client trabalha com listas M3U. Peça ao seu fornecedor o URL M3U correspondente aos seus dados Xtream.
Porque é que o guia de programação não aparece no Kodi?
Normalmente porque o URL XMLTV não foi configurado, está errado, ou os identificadores dos canais na lista não correspondem aos do guia.
Posso gravar programas no Kodi?
O Kodi tem funções de gravação através dos clientes PVR, mas depende do cliente e do serviço. Com o PVR IPTV Simple Client, consulte as opções atuais na Kodi Wiki.
Em resumo
O PVR IPTV Simple Client transforma o Kodi num leitor de televisão em direto: instale-o a partir do repositório oficial, cole o URL M3U e o URL XMLTV do seu serviço, ative-o e abra a secção TV. Se algo falhar, teste o URL no VLC, confirme o fuso horário e reduza o tamanho do guia em boxes modestas.
Ainda não configurou o Kodi em português? Veja os ajustes para Portugal antes de ligar o IPTV.
Kodi em Portugal
