Neste artigo
Este artigo faz parte do guia O que é IPTV? Guia completo para iniciantes em Portugal.
Xtream Codes API (ou simplesmente "Xtream") é uma forma de aceder a um serviço de IPTV com três dados: o endereço do servidor, o utilizador e a palavra-passe. Em vez de descarregar uma lista M3U única, a aplicação "fala" com o servidor e recebe, de forma organizada, os canais, o guia de programação, os filmes e as séries. É hoje o formato mais usado e o mais cómodo de configurar na maioria das aplicações.
O nome vem de um software de gestão de serviços IPTV com o mesmo nome. A forma de comunicar com o servidor tornou-se um padrão de facto e continua a ser usada por muitos sistemas e aplicações, independentemente desse software.
Se está a começar, o guia O que é IPTV explica os conceitos de base.
Xtream vs. M3U vs. portal
| Xtream Codes | Lista M3U | Portal (MAC) | |
|---|---|---|---|
| O que introduz | Servidor + utilizador + palavra-passe | Um URL longo | URL do portal |
| Canais por categorias | Sim | Depende da lista | Sim |
| Guia (EPG) | Normalmente automático | Muitas vezes à parte | Do portal |
| Filmes e séries | Separados e organizados | Misturados na lista | Do portal |
| Mudar de equipamento | Fácil | Fácil | Exige alterar o MAC |
| Escrever com o comando | Três campos curtos | Um endereço longo | Um URL |
Explicamos o M3U em URL da lista M3U e o portal em Portal IPTV (MAC/Stalker).
Os três dados, explicados
- Servidor (URL): algo como http://servidor.exemplo:8080. Inclua sempre o http:// (ou https://) e a porta, se o fornecedor a indicar.
- Utilizador: distingue maiúsculas e minúsculas.
- Palavra-passe: idem.
Alguns leitores pedem também um nome para a ligação: é só para si, pode escrever o que quiser.
Como iniciar sessão (genérico)
- Abra o leitor e escolha adicionar utilizador/playlist.
- Selecione Xtream Codes (por vezes "Xtream Codes API" ou "Login com API Xtream").
- Preencha servidor, utilizador e palavra-passe.
- Guarde e aguarde o carregamento de canais, guia, filmes e séries.
- Confirme o fuso horário do guia (Europa/Lisboa).
Passos específicos: TiviMate, IPTV Smarters Pro e IPTV no Android.
Converter Xtream em M3U
Se a sua aplicação só aceita M3U, muitos fornecedores geram o URL M3U a partir dos mesmos dados (o endereço inclui o utilizador e a palavra-passe). Peça-o ao fornecedor em vez de o construir à mão, para ter o formato certo para a sua aplicação.
Erros comuns e soluções
| Erro | Causa provável | Solução |
|---|---|---|
| "Invalid username or password" | Dados errados, maiúsculas, espaço a mais | Copiar exatamente do email |
| "Server not found" / erro de ligação | Falta http:// ou a porta | Escrever o endereço completo |
| Login aceite, nada carrega | Conta expirada ou sem pacotes | Confirmar com o fornecedor |
| Guia vazio | EPG não disponível ou não atualizado | Atualizar EPG; perguntar ao fornecedor |
| "Max connections reached" | Mais ecrãs do que o plano permite | Fechar a aplicação noutros equipamentos |
Uma nota sobre a história do Xtream Codes
Em setembro de 2019, uma operação coordenada pela Guardia di Finanza italiana, com apoio da Europol e da Eurojust, visou a plataforma Xtream Codes e vários serviços de IPTV, segundo a Telecompaper. A empresa por trás do software contestou mais tarde a caracterização como serviço pirata, alegando que vendia software de gestão e não conteúdos, segundo o TorrentFreak.
A lição prática é a mesma de sempre: o formato de acesso (Xtream, M3U, portal) não diz nada sobre a legalidade do serviço. O que conta é se o fornecedor tem direitos sobre os conteúdos. Veja IPTV é legal em Portugal?.
Perguntas frequentes
O que é o Xtream Codes no IPTV?
É uma forma de acesso com servidor, utilizador e palavra-passe, através da qual a aplicação recebe canais, guia, filmes e séries de forma organizada.
Xtream Codes ou M3U: qual é melhor?
Na maioria das aplicações, o Xtream é mais cómodo: três campos curtos, guia automático e conteúdos organizados. O M3U é útil quando a aplicação só aceita listas.
Porque é que o login Xtream dá erro?
Normalmente por falta do http:// ou da porta no servidor, maiúsculas trocadas, espaços a mais, ou conta expirada.
Usar Xtream Codes é ilegal?
Não. É apenas um formato de acesso. A legalidade depende do fornecedor e dos direitos sobre os conteúdos.
Em resumo
O login Xtream Codes usa servidor, utilizador e palavra-passe para dar à aplicação acesso organizado a canais, guia, filmes e séries. É mais simples de introduzir do que um URL M3U e costuma carregar o guia automaticamente. Escreva o servidor completo (com http:// e porta), respeite maiúsculas e minúsculas e guarde estes dados como uma palavra-passe.
Ainda tem dúvidas entre M3U, Xtream e portal? A nossa página sobre playlists resume as diferenças.
Formatos de acesso IPTV
