Listas M3U e guias XMLTV, explicados
A maioria dos serviços de TV ao vivo e sintonizadores descreve seus canais com dois arquivos: uma lista M3U (os canais) e um guia XMLTV, muitas vezes chamado de EPG (o que está passando). Veja o que há em cada um, como o ChannelSplice os usa e como resolver os problemas mais comuns.
O que é uma lista M3U
Uma lista M3U é um arquivo de texto simples, que costuma terminar em .m3u ou .m3u8, com uma lista de canais. Cada canal tem uma linha que o descreve e outra com o endereço da transmissão:
#EXTM3U url-tvg="https://example.com/guide.xml.gz"
#EXTINF:-1 tvg-id="harbor.news" tvg-logo="https://example.com/harbor.png" group-title="News",Harbor News
https://example.com/live/harbor-news.m3u8
#EXTINF:-1 tvg-id="summit.sports" tvg-chno="12" group-title="Sports",Summit Sports
https://example.com/live/summit-sports.m3u8
O ChannelSplice lê estas partes de cada canal:
- O nome depois da vírgula (ou
tvg-name). group-title: o grupo em que ele aparece. Você escolhe quais grupos cada tela mostra.tvg-id: o id do canal no guia. É isso que liga um canal aos programas dele.tvg-logo: o logo, etvg-chno: o número do canal (subcanais como 5.1 mantêm o seu).- Dados para ver o que você perdeu, quando o provedor guarda os últimos dias de um canal (
catchup,catchup-source,catchup-days): aí você pode voltar no guia e ver um programa desde o início.
O que é um guia XMLTV (EPG)
O guia é um arquivo separado no formato XMLTV, terminado em .xml ou .xml.gz (compactado; os dois funcionam). Ele lista os canais por id, e cada programa com início e fim, título, descrição e, muitas vezes, o episódio, a classificação e uma imagem. O ChannelSplice transforma isso no guia de TV das suas telas: agora e a seguir, a linha do tempo, lembretes, a busca no que está passando e a página Esportes.
De onde vem o guia:
- Um login de provedor traz o próprio guia. Nada a adicionar.
- Um link de lista: adicione o endereço do guia ao lado dele na página da sua conta. Deixe em branco e o ChannelSplice usa o guia que a lista indica na primeira linha (
url-tvgoux-tvg-url), se ela indicar. - Um sintonizador HDHomeRun usa o guia gratuito da SiliconDust.
Adicione-os ao ChannelSplice
- Na página da sua conta, escolha Playlists I add here, depois Add a playlist, Playlist link (M3U).
- Cole o endereço da lista, e o do guia se você tiver.
- Marque as telas a que ela se destina. Test na lista testa os dois endereços pelo seu navegador, direto com seu provedor.
Seus endereços são criptografados no seu navegador com sua frase-senha antes de serem salvos, então o ChannelSplice não consegue lê-los. Cada tela baixa a lista e o guia sozinha, guarda e só baixa de novo quando eles mudam. Passo a passo para uma TV: Fire TV e Android TV.
Por que o guia está vazio, e como resolver
- Sem endereço de guia. A lista não indica um guia e nenhum foi adicionado: adicione o endereço do guia na lista.
- Os ids não batem. Os canais encontram os programas pelo
tvg-id. Um canal sem id, ou com um id que o guia não usa, fica sem programas. O ChannelSplice também compara o nome do canal com os nomes do guia, o que preenche muitos, mas não todos. - O guia acabou. "O guia acabou: a fonte não foi atualizada" quer dizer que o arquivo não tem programas daqui em diante. O provedor precisa atualizá-lo.
- Um guia grande. Guias grandes demoram um pouco mais na primeira vez. Depois ficam guardados na tela.
- Um provedor que pede um player específico pode recusar o guia também: defina o User-Agent dele na lista (Only if your provider asks).
O ChannelSplice Server, um programa gratuito para um computador em casa, vai além para quem tem várias listas ou guias: junta listas numa programação, liga os canais aos dados de guia certos, dá a um canal com guia vazio os programas do mesmo canal de outro dos seus guias e avisa quando um guia está para acabar.
Link de lista ou login de provedor?
Se o seu serviço dá um endereço de servidor, usuário e senha, use Provider login: ele traz o guia e os filmes e séries do provedor com capas e detalhes, e mostra quando sua assinatura termina. Um link de lista é para todo o resto, inclusive listas que você mesmo mantém. Os dois podem estar num só guia com o ChannelSplice Pro.
Perguntas, ideias ou algo desatualizado? Pergunte no Discord do ChannelSplice ou no r/ChannelSplice no Reddit, ou escreva para support@channelsplice.com.