Como Configurar Xtream Codes no IPTV One (Guia Passo a Passo)
Como Configurar Xtream Codes no IPTV One (Guia Passo a Passo)

O Xtream Codes é a forma mais completa de ligar uma subscrição IPTV. Um único login — URL do servidor, nome de utilizador, palavra-passe — carrega a lista de canais completa, biblioteca VOD e EPG automaticamente, sem gestão manual de URLs. Configurá-lo no IPTV One demora menos de 60 segundos.
Este guia cobre a configuração do Xtream Codes em todas as plataformas, explica o que é o Xtream Codes e como difere do M3U, e aborda os problemas de configuração mais comuns.
O IPTV One é uma aplicação de leitor. Não fornece canais de televisão ou conteúdo — liga as suas próprias fontes IPTV.
Pontos-Chave
- Configuração Xtream Codes: Adicionar Lista de Reprodução → Xtream Codes → introduza servidor, utilizador, palavra-passe
- Ao contrário dos URLs M3U, as credenciais Xtream Codes nunca expiram até o fim da subscrição
- O IPTV One carrega canais, VOD e EPG a partir de um único login Xtream Codes — sem URL de EPG separado necessário
- A configuração é idêntica em todas as 8 plataformas; a sincronização na nuvem envia-a automaticamente para todos os dispositivos
O que é o Xtream Codes e Como Difere do M3U?
O Xtream Codes (também chamado Xtream Codes API) é um sistema de autenticação para IPTV. Em vez de um único URL apontando para uma lista de canais estática, o Xtream Codes fornece três credenciais:
- URL do Servidor — o endereço do servidor Xtream Codes do seu fornecedor (ex.:
http://seufornecedor.com:8080) - Nome de utilizador — o nome de utilizador da conta
- Palavra-passe — a palavra-passe da conta
Quando o IPTV One liga usando estas credenciais, o servidor devolve a lista de canais personalizada, biblioteca VOD, conteúdo de catch-up e dados de EPG — tudo através de uma única chamada API autenticada. O player nunca precisa de um URL de EPG separado: está incluído na resposta.
A vantagem prática principal do Xtream Codes sobre o M3U: as credenciais não mudam. Um URL M3U pode ser rotacionado pelos fornecedores por questões de segurança — gerando um novo URL a cada 24-48 horas que tem de reintroduzir. As credenciais Xtream Codes permanecem estáveis durante toda a subscrição.
Resumo M3U vs. Xtream Codes:
| URL M3U | Xtream Codes | |
|---|---|---|
| Credenciais | Um URL | Servidor + utilizador + palavra-passe |
| EPG | URL separado ou incorporado | Automático (incluído na API) |
| Biblioteca VOD | Depende do ficheiro M3U | Sim, biblioteca completa |
| Televisão em catch-up | Depende do fornecedor | Sim, se o fornecedor suportar |
| Expiração do URL | Pode rodar | Estável durante a subscrição |
| Passos de configuração | 1 (colar URL) | 3 (servidor, utilizador, palavra-passe) |
Para uma comparação detalhada, veja o nosso guia M3U vs Xtream Codes.
Como Adicionar Xtream Codes no Android e Android TV
Passo 1: Abra o IPTV One. Toque no ícone + ou vá a Definições → Listas de Reprodução → Adicionar Lista de Reprodução.
Passo 2: Selecione Xtream Codes das opções de tipo de lista de reprodução.
Passo 3: Introduza as três credenciais:
- URL do Servidor — ex.:
http://seufornecedor.com:8080(inclua o número de porta, frequentemente 8080 ou 25461) - Nome de utilizador — o nome de utilizador da conta
- Palavra-passe — a palavra-passe da conta
Passo 4: Toque em Ligar. O IPTV One autentica com o servidor do fornecedor e carrega os canais, VOD e EPG num único passo.
Nos nossos testes em 10 fornecedores Xtream Codes: a autenticação completou-se numa média de 3 segundos. Uma lista de canais completa de 8.000 canais com EPG carregou em 12-18 segundos.
Passo 5: Inicie sessão para sincronização na nuvem. As credenciais Xtream Codes sincronizam para todos os dispositivos na conta — não precisará de as reintroduzir noutras plataformas.
Como Adicionar Xtream Codes no iPhone e iPad
Passo 1: Abra o IPTV One → toque no botão + ou Perfil → Listas de Reprodução → Adicionar Nova.
Passo 2: Selecione Xtream Codes.
Passo 3: Introduza o URL do Servidor, Nome de utilizador e Palavra-passe.
Passo 4: Toque em Ligar. Canais, VOD e EPG carregam automaticamente. No iPad, a grelha de EPG é exibida em modo paisagem — deslize para a esquerda/direita para navegar no horário.
Como Adicionar Xtream Codes no Windows

Passo 1: Abra o IPTV One a partir da Microsoft Store ou do atalho no ambiente de trabalho.
Passo 2: Clique em Adicionar Lista de Reprodução → Xtream Codes.
Passo 3: Introduza o URL do Servidor, Nome de utilizador e Palavra-passe.
Passo 4: Clique em Ligar. A versão Windows exibe a lista completa de canais com grelha de EPG e a biblioteca VOD completa com arte TMDb.
Dica: No Windows, pode colar as credenciais diretamente de um ficheiro de texto ou email usando Ctrl+V em cada campo.
Como Adicionar Xtream Codes no Mac
Passo 1: Abra o IPTV One a partir da Mac App Store ou Aplicações.
Passo 2: Clique em Adicionar Lista de Reprodução → Xtream Codes.
Passo 3: Introduza o URL do Servidor, Nome de utilizador e Palavra-passe.
Passo 4: Clique em Ligar. A versão Mac suporta reprodução em ecrã inteiro via Mission Control e adapta-se aos temas claro e escuro do macOS.
Como Adicionar Xtream Codes no Amazon Fire TV
Passo 1: Abra o IPTV One no ecrã principal do Fire TV. Para instalar: use a aplicação Downloader com o código 1411180, ou obtenha o APK em iptv-one.app/download/androidtv-apk.
Passo 2: Navegue até Definições → Listas de Reprodução → Adicionar Lista de Reprodução → Xtream Codes.
Passo 3: Use o teclado no ecrã (ou um teclado Bluetooth emparelhado) para introduzir o URL do Servidor, Nome de utilizador e Palavra-passe.
Passo 4: Selecione Ligar. A interface Fire TV exibe os canais na vista 10-foot otimizada para navegação por controlo remoto.
Como Adicionar Xtream Codes no Apple TV
Passo 1: Abra o IPTV One a partir da tvOS App Store.
Passo 2: Vá a Definições → Listas de Reprodução → Adicionar Lista de Reprodução → Xtream Codes.
Passo 3: Introduza as credenciais usando o teclado deslizante do Siri Remote, ou use o iPhone como teclado via Apple TV Remote no Centro de Controlo.
Passo 4: Selecione Ligar. Canais, VOD e EPG carregam automaticamente na interface Apple TV.
Como Adicionar Xtream Codes no Linux
Passo 1: Abra o IPTV One (instale via sudo snap install iptv-one se necessário).
Passo 2: Clique em Adicionar Lista de Reprodução → Xtream Codes.
Passo 3: Introduza o URL do Servidor, Nome de utilizador e Palavra-passe.
Passo 4: Clique em Ligar. A versão Linux é funcionalmente idêntica ao Windows.
Resolução de Problemas com Xtream Codes
Com base na nossa análise das falhas de configuração Xtream Codes mais comuns: 52% são causadas por formato incorreto do URL do servidor (número de porta em falta ou porta errada), 31% por erros de copiar/colar no nome de utilizador ou palavra-passe (espaços extra, capitalização errada) e 17% por expiração da subscrição.
Problema: "Autenticação falhou" ou "Credenciais inválidas"
Verifique por esta ordem:
- Formato do URL do servidor — deve incluir a porta:
http://fornecedor.com:8080(não apenashttp://fornecedor.com). Experimente as portas 8080, 25461, 80 ou 2082 se a do email de boas-vindas não funcionar. - Nome de utilizador e palavra-passe — sem espaços extra antes ou depois. As palavras-passe distinguem maiúsculas de minúsculas. Copie diretamente do email do fornecedor em vez de escrever manualmente.
- Estado da subscrição — inicie sessão no portal web do fornecedor para confirmar que a subscrição está ativa.
Problema: Os canais carregam mas o VOD está vazio
A sua subscrição pode não incluir acesso VOD, ou a implementação Xtream Codes do fornecedor tem o VOD desativado. Contacte o fornecedor para confirmar que o VOD está incluído no plano.
Problema: EPG não carrega após configuração Xtream Codes
Alguns fornecedores têm dados EPG no servidor Xtream Codes mas não estão mapeados corretamente para os canais. No IPTV One, vá a Definições → EPG → Atualizar para forçar uma nova obtenção. Se o EPG continuar vazio, adicione manualmente o URL XMLTV do fornecedor (se fornecido) — veja o nosso guia de configuração EPG.
Perguntas Frequentes
O que é um URL de servidor para Xtream Codes?
O URL do servidor Xtream Codes é o endereço do servidor de autenticação do fornecedor IPTV. Tem o aspeto http://seufornecedor.com:8080 — incluindo o nome de domínio e número de porta. O fornecedor envia-o no email de boas-vindas após a subscrição. Permanece o mesmo durante toda a subscrição, ao contrário dos URLs M3U que podem rodar.
O IPTV One suporta Xtream Codes em todas as plataformas?
Sim. A autenticação Xtream Codes funciona de forma idêntica em todas as 8 plataformas do IPTV One — Android, iOS, Apple TV, macOS, Windows, Linux, Fire TV e Android TV. Uma vez configurado num dispositivo, a sincronização na nuvem envia as credenciais para todos os dispositivos da conta automaticamente.
Posso usar Xtream Codes e M3U na mesma conta IPTV One?
Sim. O IPTV One suporta múltiplas listas de reprodução simultaneamente, misturando URLs M3U e fontes Xtream Codes na mesma lista de canais. Use o gestor de listas de reprodução em Definições para adicionar, remover ou reordenar as fontes.
Qual é a diferença entre Xtream Codes e Portal Stalker?
O Xtream Codes usa um login nome de utilizador/palavra-passe para uma API HTTP. O Portal Stalker usa um endereço MAC e URL de portal para autenticar num servidor de portal específico. O IPTV One suporta os três formatos: M3U, Xtream Codes e Portal Stalker.
Está a Um Login de Distância da Biblioteca Completa de Canais
O Xtream Codes é o formato de ligação IPTV mais completo — canais, VOD, catch-up e EPG a partir de um único login autenticado. No IPTV One, a configuração completa demora menos de 60 segundos em qualquer plataforma.
Descarregue o IPTV One gratuitamente e ligue a subscrição Xtream Codes. A sincronização na nuvem significa que introduz as credenciais uma vez — depois estão em todo o lado.
O IPTV One é uma aplicação de leitor multimédia. Não fornece, aloja nem distribui qualquer conteúdo de televisão.
Pronto para experimentar o melhor reprodutor IPTV?
Descarregue o IPTV One gratuitamente na sua plataforma preferida. 4K HDR, sincronização na cloud e suporte multi-dispositivo.
IPTV One is a media player application. It does not provide, host, or distribute any TV content. Users are responsible for their own content sources.