Xtream Player: o que é a API Xtream Codes, como configurar o login e os erros comuns

O que é a API Xtream Codes

Xtream Codes foi o nome de um painel de gerenciamento de IPTV que definiu um padrão de comunicação entre servidor e aplicativo. O painel original acabou, mas o padrão ficou e é usado pela maioria dos serviços hoje. Na prática, a “API Xtream” é um jeito de o app perguntar ao servidor: quais categorias existem, quais canais, quais filmes, qual a programação. O app recebe tudo organizado e monta a interface. Por isso tantos apps se chamam “Xtream Player”, “Xtream IPTV” ou “XC Player”: eles anunciam que falam esse padrão. Não são um app só; são dezenas, de desenvolvedores diferentes, e a regra para escolher é a mesma de qualquer player: desenvolvedor identificado, atualização recente, permissões coerentes. Como o padrão funciona por dentro está em como o IPTV funciona por dentro.

Como configurar: servidor, usuário e senha

1. Abra o player e escolha a opção Xtream Codes API (em alguns apps, “login com usuário e senha” ou “Add Xtream user”).
2. Nome: qualquer identificação, como “Soisopor”.
3. Servidor (URL): o endereço enviado pelo serviço, começando com http:// ou https:// e, muitas vezes, terminando com a porta (dois-pontos e um número). Copie exatamente como veio.
4. Usuário e senha: os enviados pelo serviço. Diferenciam maiúsculas de minúsculas.
5. Confirme e aguarde. O app baixa categorias, canais, catálogo e EPG; a primeira carga pode levar um ou dois minutos.

Na Soisopor, os três dados chegam pelo WhatsApp em uma mensagem, junto com a versão M3U do mesmo acesso. Se o app tiver a opção de colar tudo de uma vez a partir de um link de login, ela costuma funcionar, mas digitar os três campos separados evita erro.

Xtream x M3U: o que muda

Regra prática: Xtream sempre que o player aceitar; M3U quando o player só abre link (VLC, alguns apps de Smart TV). Comparação completa em lista M3U e Xtream Codes.

Players que aceitam Xtream em cada aparelho

• Android TV, Fire TV e TV Box: XCIPTV e TiviMate.
• Smart TV Samsung e LG: IBO Player, Smartone, IPTV Smarters. Alguns pedem ativação única pelo MAC no site do desenvolvedor.
• Celular Android e iPhone: IPTV Smarters; XCIPTV no Android.
• PC: IPTV Smarters para Windows e Mac.
• Roku: alguns players da loja aceitam; confira na descrição do app.

Erros comuns e o que fazer

• “Login incorreto” ou “usuário inválido”: na maioria das vezes é digitação — letra maiúscula, espaço no fim, “l” no lugar de “1”. Apague e digite de novo. Se persistir, o acesso pode ter vencido ou estar em uso em mais telas do que o permitido.
• Porta: o servidor vem com uma porta (dois-pontos seguidos de um número). Sem ela, o app não conecta. Copie o endereço inteiro.
• http x https: use exatamente o que o serviço enviou. Trocar um pelo outro dá “erro de conexão” mesmo com os dados certos.
• “Servidor não responde”: internet do aparelho, DNS da operadora ou manutenção no serviço. Teste abrir um site no aparelho; se abrir, fale com o suporte.
• Lista carrega mas canais não abrem: decodificador ou buffer. Troque para hardware e aumente para 5–10 segundos.
• EPG vazio: aguarde a primeira carga; em alguns players, ative a atualização de EPG nas configurações.

Teste o formato antes de assinar

O jeito mais simples de ver a diferença entre Xtream e M3U é usar os dois no mesmo player. O teste da Soisopor entrega o acesso nos dois formatos, por 6 horas, sem cartão. Depois, planos de R$ 25 a R$ 35 por mês, com suporte pelo WhatsApp.

1. Clique em teste IPTV grátis e envie a mensagem no WhatsApp informando o aparelho (Smart TV, TV Box, Fire TV Stick, Roku, celular ou PC).
2. Receba em minutos o aplicativo indicado e o acesso (Xtream Codes ou M3U). Não há cartão nem cadastro.
3. Instale o app, digite o acesso e aguarde a lista carregar.
4. Use as 6 horas no horário em que você mais assiste, de preferência entre 20h e 22h.

Perguntas rápidas