1. O Que São Xtream Codes?
O Xtream Codes (também chamado Xtream-Codes API ou XC API) é o sistema de autenticação e gestão de conteúdo IPTV mais utilizado no mundo. Em termos simples, é como um "login" para o teu serviço IPTV — em vez de teres um simples URL de playlist, tens um sistema completo com utilizador e senha.
Quando o teu fornecedor IPTV usa Xtream Codes, fornece-te três dados:
- URL do servidor — ex:
http://servidor.com:8080 - Utilizador (username) — ex:
joao_portugal - Senha (password) — ex:
abc123xyz
Com estes três dados, qualquer app IPTV compatível faz login no servidor e acede a todo o conteúdo disponível na tua subscrição: canais ao vivo, séries e filmes (VOD).
2. Como Funcionam as Credenciais Xtream Codes
Quando introduzes as credenciais Xtream Codes numa app IPTV, acontece o seguinte:
- A app liga ao servidor IPTV com as tuas credenciais
- O servidor valida o utilizador e a senha
- O servidor devolve a lista completa de conteúdo a que tens acesso
- A app organiza automaticamente os canais por categorias, series e filmes
- As listas são atualizadas automaticamente — sem necessidade de renovar URLs
O sistema também inclui informação sobre a tua subscrição: data de expiração, número máximo de ligações simultâneas e se tens acesso a VOD.
URL M3U gerado automaticamente
Se a tua app não suporta Xtream Codes nativamente, podes gerar uma URL M3U a partir das credenciais. O formato é:
http://[servidor]:[porta]/get.php?username=[user]&password=[senha]&type=m3u_plus&output=ts
Substitui os campos entre colchetes pelos teus dados reais. Esta URL funciona em qualquer app que suporte M3U.
3. Xtream Codes vs Lista M3U
| Característica | Lista M3U | Xtream Codes |
|---|---|---|
| Tipo de acesso | URL com ficheiro | Login (user + senha) |
| Atualização do conteúdo | Manual (nova URL) | Automática |
| VOD organizado | ⚠️ Tudo misturado | ✅ Catálogo separado |
| Info de expiração | ❌ | ✅ Mostra na app |
| Estabilidade | ⚠️ URL pode expirar | ✅ Estável |
| Compatibilidade | Universal | Apps com suporte XC |
| Séries com temporadas | ⚠️ Lista plana | ✅ Organizado por temporada |
Conclusão: Sempre que possível, usa Xtream Codes. É mais robusto, mais organizado e não expira. A lista M3U é útil quando a app não suporta XC ou para testes rápidos.
Nunes TV — Xtream Codes Incluído
Todos os planos Nunes TV incluem credenciais Xtream Codes. Recebe servidor, utilizador e senha por WhatsApp em minutos após subscrever.
Obter Credenciais4. Configurar Xtream Codes no IPTV Smarters Pro
- Abre o IPTV Smarters Pro e toca em "Adicionar utilizador"
- Seleciona "Entrar com Xtream Codes API"
- Preenche o campo Nome (ex: "Nunes TV")
- Preenche o URL do Servidor completo (com porta, ex:
http://servidor.com:8080) - Introduz o Utilizador e a Senha
- Toca em "Adicionar utilizador" — a app faz login e carrega o conteúdo
- Aguarda o carregamento (pode demorar 1–2 minutos na primeira vez)
Após o login, tens acesso separado a Canais ao Vivo, Séries e Filmes no menu principal.
5. Configurar Xtream Codes no TiviMate
- Abre o TiviMate e vai a Configurações > Playlists > Adicionar playlist
- Seleciona "Xtream Codes"
- Introduz o Host (servidor sem protocolo, ex:
servidor.com) - Preenche a Porta (ex:
8080) - Introduz o Username e Password
- Toca em Continuar — o TiviMate importará todos os canais e o EPG automaticamente
http://servidor.com:8080, introduz servidor.com no host e 8080 na porta.
6. Configurar Xtream Codes no XCIPTv e GSE Smart IPTV
XCIPTv (Android, iOS, Windows)
- Abre o XCIPTv e toca em "+" para adicionar conta
- Seleciona "Xtream Codes API"
- Preenche o Server URL, Username e Password
- Toca em Save — o XCIPTv faz login e organiza o conteúdo
GSE Smart IPTV (iPhone/iPad)
- Abre o GSE Smart IPTV e vai a Remote Playlists
- Toca em "+" e seleciona "Xtream Codes API"
- Introduz o nome, URL, Username e Password
- Toca em Add e aguarda o carregamento dos canais
7. Resolver Problemas Comuns com Xtream Codes
"Autenticação falhou" ou "Credenciais inválidas"
- Verifica se copiaste o URL do servidor, utilizador e senha corretamente (sem espaços extra)
- O URL do servidor deve incluir
http://e a porta (ex:http://servidor.com:8080) - Confirma com o fornecedor se as credenciais estão corretas
- Verifica se a subscrição está ativa (pode ter expirado)
"Conexão máxima atingida"
- Estás a usar as credenciais em mais dispositivos do que o permitido pelo plano
- Fecha a app noutros dispositivos e tenta novamente
- Se o problema persistir, contacta o suporte para resetar as sessões
Canais carregam mas não reproduzem
- Testa noutro canal — pode ser um problema específico desse canal
- Verifica a velocidade da internet (mínimo 10 Mbps para HD)
- Tenta mudar o tipo de stream na app (TS vs HLS)
- Reinicia a app e o dispositivo
| Apps compatíveis com Xtream Codes | Plataforma |
|---|---|
| IPTV Smarters Pro | Android, iOS, Windows, Mac |
| TiviMate | Android TV, Fire TV |
| XCIPTv | Android, iOS, Windows, Mac |
| GSE Smart IPTV | iOS, macOS |
| IPTV Smart Player Pro | Android, Android TV |
| OTT Navigator | Android, Android TV |
Configuração Assistida por WhatsApp
Dúvidas na configuração do Xtream Codes? A nossa equipa Nunes TV ajuda passo a passo via WhatsApp. Resposta em menos de 30 minutos.
Pedir Ajuda