Guia

Como achar e 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. Ele é um arquivo XMLTV num endereço próprio. Veja como é esse endereço, onde achar, como adicionar no Aina e o que conferir quando o guia não mostra nada.

Atualizado em · Equipe Aina IPTV

  • Os dados de acesso Xtream Codes já trazem um, no mesmo servidor, com o mesmo usuário e a mesma senha: http://servidor:porta/xmltv.php?username=…&password=…. É o link get.php com xmltv.php no lugar. O Aina baixa sozinho, então você não precisa digitar nada.
  • Uma lista M3U muitas vezes indica o próprio guia, na primeira linha: #EXTM3U x-tvg-url="https://…/guide.xml.gz" (ou url-tvg). Algumas indicam vários, separados por vírgula, um por país; o Aina carrega todos sem você pedir.
  • Se não for o caso, o seu provedor passa um link EPG: um arquivo XMLTV que termina em .xml, ou em .xml.gz quando está compactado. Os dois funcionam.
  • Um portal MAC traz o próprio guia, que o Aina lê do mesmo jeito que um decodificador (set-top box). Para um portal que não publica guia, você pode adicionar um link em Ajustes, depois Fontes do guia de programação.

O que tem num arquivo XMLTV?

XMLTV é o formato que quase todo guia de IPTV usa: um arquivo de texto simples, muitas vezes compactado com gzip, com a lista de canais e depois a programação de cada um. Estas são as partes que importam:

As partes de um guia XMLTV que um player lê.
ParteO que ela traz
<channel id="…">Um canal e o identificador sob o qual ficam os programas dele, como meucanal.br. A lista de canais do guia é o conjunto de todos esses.
<display-name>O nome do canal, às vezes em mais de um idioma.
<programme start="…" stop="…" channel="…">Um programa, com início e fim no fuso horário dele, e o identificador do canal a que ele pertence.
<title>, <desc>, <category>O nome do programa, do que ele trata e o gênero.

Uma semana de guia de uma lista grande pode chegar a centenas de megabytes, e é por isso que os provedores compactam o arquivo. O Aina vai gravando o arquivo no armazenamento conforme baixa e lê um pedaço de cada vez, então um guia desse tamanho não deixa o celular nem o aparelho ligado à TV sem memória.

E se o seu provedor não tiver guia?

  • Peça um primeiro. Um guia feito para a sua assinatura é o que bate melhor com os canais dela, e a maioria dos provedores tem um, mesmo quando não fala nada.
  • Procure na lista. Abra a lista M3U num editor de texto e veja se a primeira linha tem x-tvg-url.
  • Monte um você mesmo. O iptv-org/epg é um projeto aberto no GitHub que gera um arquivo XMLTV a partir das programações que os sites de TV publicam, para os canais que você escolher. É uma ferramenta que você roda num computador, não um link pronto, e o arquivo que ela gera precisa ficar num endereço que os seus aparelhos consigam acessar.

Abra o link no navegador de um computador. Um link .xml que funciona mostra um texto que começa com <?xml ou <tv; um link .xml.gz baixa um arquivo. Uma página de login, um erro ou uma página em branco quer dizer que o link está errado ou expirou: peça um novo ao seu provedor. Um link xmltv.php do Xtream Codes que volta vazio normalmente quer dizer que o provedor não publica guia para essa assinatura.

  1. 1

    Comece a adicionar a lista

    No Aina, escolha Lista M3U na tela Adicione sua assinatura, ou vá em Ajustes, depois Assinaturas e depois Adicionar assinatura.

  2. 2

    Cole o link da lista

    Em URL da lista, como sempre.

  3. 3

    Cole o link do guia

    Em URL do guia (opcional): o link .xml ou .xml.gz que o seu provedor passou. Deixe em branco se a lista já indica o próprio guia.

  4. 4

    Conecte

    Toque em Conectar. Os canais chegam primeiro e o guia vem em seguida. Um guia grande pode levar um minuto.

Adicionar outro guia depois

Em Ajustes, depois Fontes do guia de programação, funciona com qualquer assinatura, inclusive Xtream Codes e portais MAC. Adicione um guia pelo endereço XMLTV dele para completar os canais que o guia do seu provedor deixa de fora, dê a cada guia o próprio horário e desative qualquer um deles. Atualizar o guia agora aplica a mudança na hora.

Como o guia encontra os seus canais

A lista M3U dá a cada canal o identificador que ele deve ter no guia, tvg-id="meucanal.br", e o guia organiza os programas em <channel id="meucanal.br">. O Aina junta os dois. Quando um canal não tem identificador, ou o guia usa outro, 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. O Aina preenche a programação quando o arquivo inteiro chega, o que num guia grande pode levar um ou dois minutos.
  • 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 veio com o fuso errado: em Ajustes, depois Fontes do guia de programação, adiante ou atrase o guia em horas ou meias horas até bater.

O que você ganha com o guia carregado

Agora e a seguir embaixo de cada canal; o guia de programação 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

Com os dados de acesso Xtream Codes, é o xmltv.php do seu servidor com o seu usuário e a sua senha, e o Aina usa sozinho. Com uma lista M3U, procure x-tvg-url na primeira linha, ou peça ao seu provedor o link .xml ou .xml.gz do guia.

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

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

Pode, qualquer link XMLTV funciona no Aina. Um guia de outra fonte só preenche os canais cujos identificadores ou nomes batem, então o guia do seu próprio provedor é o melhor ponto de partida, e um grátis pode completar o que falta ao lado dele em Fontes do guia de programação.

Não. O guia de programação vem sozinho do painel do seu provedor. Mesmo assim, você pode adicionar guias seus em Ajustes, depois Fontes do guia de programação, para os canais que ele não cobre.