# Como adicionar o guia de programação (EPG) no seu IPTV

O EPG, o guia eletrônico de programação, é o que coloca “agora” e “a seguir” ao lado de cada canal. Veja de onde ele vem, como adicionar no Aina e o que conferir quando ele não mostra nada.

Atualizado em 2026-10-06. Equipe Aina IPTV. https://ainaiptv.com/pt/guias/como-adicionar-epg/

## De onde vem o guia de programação?

- **Com os dados de acesso Xtream Codes**, você não precisa fazer nada: o Aina baixa o guia sozinho do painel do seu provedor.
- **Com uma lista M3U**, a primeira linha da lista muitas vezes indica o guia dela (`url-tvg` ou `x-tvg-url`), e o Aina carrega sem você pedir.
- **Se não for o caso**, o seu provedor passa um link EPG próprio: um arquivo XMLTV que termina em `.xml`, ou em `.xml.gz` quando está compactado. Os dois funcionam.

## Como adicionar o link EPG numa lista M3U

O app Aina está em inglês e em árabe, então os botões aparecem aqui em inglês, do jeito que você vai ver na tela.

1. **Comece a adicionar a lista**: No Aina, escolha **M3U playlist** (lista M3U) na tela **Add your subscription** (adicione sua assinatura), ou vá em **Settings** (configurações), depois **Subscriptions** (assinaturas) e depois **Add a subscription** (adicionar uma assinatura).
2. **Cole o link da lista**: Em **Playlist URL** (link da lista), como sempre.
3. **Cole o link do guia**: Em **Guide URL (optional)** (link do guia, opcional): o link `.xml` ou `.xml.gz` que o seu provedor passou.
4. **Conecte**: Toque em **Connect** (conectar). Os canais chegam primeiro e o guia vem em seguida. Um guia grande pode levar um minuto.

## Como o guia encontra os seus canais

Um guia XMLTV organiza os programas por identificadores de canal, e a lista M3U dá a cada canal o identificador que ele usa no guia (`tvg-id`). O Aina junta as duas coisas. Quando um canal não tem identificador, ou o guia não usa esse identificador, o Aina tenta pelo nome do canal, então um guia de outra fonte ainda consegue preencher boa parte da sua lista.

## Por que o guia de programação aparece vazio ou errado?

- **O guia não cobre esses canais.** Cada guia é publicado para um conjunto de canais: peça ao seu provedor o guia feito para a sua assinatura.
- **Os identificadores e os nomes não batem.** Os canais que o guia chama de outro jeito ficam vazios. O guia do seu próprio provedor é o que bate melhor.
- **O guia acabou.** Um guia cobre alguns dias pela frente. Se o provedor para de atualizar, a programação termina onde o arquivo termina.
- **Ainda está carregando.** Uma semana de guia de um provedor grande pode ter centenas de megabytes. O Aina vai gravando no armazenamento conforme chega e preenche a programação quando termina.
- **Os horários estão errados.** O guia informa o fuso horário de cada programa, e o Aina mostra tudo no seu: esteja você em São Paulo, Manaus ou Lisboa, um canal de outro país aparece no seu horário. Se todos os programas estão adiantados ou atrasados pelas mesmas horas, o guia do provedor está errado, e só o provedor pode corrigir.

## O que você ganha com o guia carregado

Agora e a seguir embaixo de cada canal; o [guia de programação](https://ainaiptv.com/pt/guia-de-programacao-epg/) com o que está passando agora e hoje à noite, com busca por programa; uma semana por canal; e os programas que já passaram (Catch-up) onde o seu provedor guarda um arquivo.

## Perguntas e respostas

### O que é XMLTV?

O formato de arquivo que quase todo provedor IPTV usa para o guia: uma lista de canais e de programas, com horário de início e de fim, título e descrição.

### Um guia .xml.gz é diferente de um .xml?

Só por estar compactado, o que deixa o download bem menor. O Aina lê os dois.

### Preciso de link EPG se uso Xtream Codes?

Não. O guia de programação vem sozinho do painel do seu provedor.

## Leia também

- [Guia de programação (EPG)](https://ainaiptv.com/pt/guia-de-programacao-epg/)
- [Como adicionar uma lista M3U](https://ainaiptv.com/pt/guias/como-adicionar-lista-m3u/)
- [Player de listas M3U](https://ainaiptv.com/pt/player-m3u/)
- [Glossário IPTV](https://ainaiptv.com/pt/guias/glossario-iptv/)