O player Xtream Codes
para Windows e Android TV (2026)

O que é o Xtream Codes e o que é a API dele?

Xtream Codes é um sistema de gestão de IPTV que surgiu no começo da década de 2010 e acabou virando o software de painel padrão que os provedores rodam em seus servidores. A empresa original fechou em 2019, mas o protocolo da API Xtream Codes que ela popularizou sobreviveu e continua sendo o padrão do setor em 2026. Por isso, ao contratar quase qualquer assinatura de IPTV, você recebe três valores em vez de um arquivo:

• URL do servidor (host:porta): o endereço do painel do seu provedor, escrito como host e porta, por exemplo http://linha.example.com:8080. Tanto o esquema (http ou https) quanto a porta fazem parte dele.
• Usuário: o nome da sua conta nesse painel. Diferencia maiúsculas de minúsculas.
• Senha: a senha da sua conta. Também diferencia maiúsculas de minúsculas.

A API Xtream Codes nada mais é do que a interface HTTP com a qual o seu player conversa depois que você digita esses três valores. Por baixo, o player chama endpoints como player_api.php?action=get_live_categories, get_vod_streams, get_series e get_short_epg. Você não vê nada disso, só o resultado: uma biblioteca organizada e por categorias. A partir de uma única conexão, a API monta automaticamente:

• Canais ao vivo: organizados em categorias reais (esportes, notícias, infantil, por país) e com logotipos.
• VOD: um catálogo de filmes com capas, sinopses e metadados.
• Séries: com listas de temporadas e episódios.
• EPG: o guia de programação dos canais ao vivo, entregue pela mesma conexão, então não é preciso adicionar um link XMLTV separado.

Como conectar com Xtream Codes

O passo decisivo é escolher a opção Login Xtream Codes em vez da opção de URL M3U: é isso que dá três campos separados em vez de um único campo de URL.

1. Abra Adicionar lista. Inicie o aplicativo. O teste de 7 dias não precisa de chave e começa na sua primeira reprodução. Entre na tela Listas e escolha Adicionar lista.
2. Escolha Login Xtream Codes. Você verá três campos: host e porta, usuário e senha.
3. Digite o host e a porta. Informe o servidor no formato host:porta, por exemplo http://linha.example.com:8080. Inclua o esquema e a porta: :8080 e :80 não são a mesma coisa. Não cole uma URL completa de player_api.php; só o host e a porta base.
4. Digite o usuário e a senha. Exatamente como o provedor forneceu. Diferenciam maiúsculas de minúsculas, então copie e cole em vez de digitar.
5. Salve e deixe as categorias serem montadas. O player chama a API Xtream e cria suas categorias de Ao Vivo, VOD e Séries mais a EPG: normalmente entre 5 e 30 segundos, dependendo do tamanho do catálogo.

Tem um segundo provedor? Repita os mesmos cinco passos. O Nightmare TV mantém várias conexões Xtream em paralelo. Se o seu provedor só te deu um link M3U simples, veja como reproduzir listas M3U no Windows.

Xtream Codes ou URL M3U: quando usar cada um

Use Xtream Codes se o seu provedor oferecer, o que é o mais comum. Uma única conexão entrega Ao Vivo + VOD + Séries + EPG, as categorias já vêm estruturadas e as capas e dados de programação chegam sozinhos. Use uma URL M3U simples quando o seu provedor só oferecer M3U ou quando você tiver uma lista feita à mão. Uma dica: se te deram um link M3U longo, o host:porta do começo é a sua URL de servidor, e os parâmetros username= e password= são as suas credenciais. Veja M3U ou Xtream Codes explicado.

Anatomia de uma URL Xtream: get.php e player_api.php

Se te deram um link longo em vez de três campos, ou se você pesquisou get.php ou type=m3u_plus, veja o que cada parte significa. Uma URL típica de exportação M3U do Xtream se parece com isto:

http://linha.example.com:8080/get.php?username=USUARIO&password=SENHA&type=m3u_plus&output=ts

Existe um segundo endpoint mais capaz: /player_api.php. Em vez de um M3U plano ele devolve JSON, que é o que um cliente Xtream de verdade usa para montar o catálogo estruturado. Você nunca digita nenhum desses caminhos. Quando você informa a URL do servidor, o usuário e a senha nos três campos, o player acrescenta player_api.php por você e monta Ao Vivo + VOD + Séries + EPG automaticamente: por isso um login Xtream de verdade rende mais do que colar um link get.php cru.

Solução de problemas de conexão com Xtream Codes

• «Erro de conexão» mesmo com a senha certa. As credenciais diferenciam maiúsculas de minúsculas e costumam confundir 0/O e 1/l/I. Copie e cole os dois campos e confira se não há espaços sobrando.
• Porta errada (:80 contra :8080). A porta faz parte da URL do servidor. Muitos painéis usam :8080, alguns :80 ou :25461. Verifique também o esquema: http ou https.
• Caminho ou barra colados a mais. Digite só o host:porta base. Tire qualquer /player_api.php, /get.php ou barra no fim.
• «Max connections reached». A maioria das assinaturas limita os fluxos simultâneos, muitas vezes entre 1 e 3. Feche a outra sessão ou peça mais conexões ao seu provedor.
• Conta vencida ou suspensa. Se o painel marcar como vencida, nenhum player vai conseguir conectar até a renovação.
• Funciona em um aplicativo mas não em outro. Quase sempre é a porta ou o esquema. Copie o esquema://host:porta exato do aplicativo que funciona.

Perguntas frequentes

O que é o Xtream Codes?

Xtream Codes é um sistema de gestão de IPTV que virou o software de painel padrão que os provedores rodam em seus servidores. A empresa original fechou em 2019, mas o protocolo da sua API sobreviveu e continua sendo o padrão do setor em 2026. Por isso, ao contratar quase qualquer assinatura de IPTV, você recebe três valores em vez de um arquivo: uma URL de servidor com porta, um usuário e uma senha.

Como conectar um player com Xtream Codes?

Escolha a opção de login Xtream Codes em vez da opção de URL M3U: é isso que dá três campos separados. Digite a URL do servidor no formato host:porta incluindo o esquema, por exemplo http://linha.example.com:8080, e depois o usuário e a senha exatamente como o provedor forneceu. Salve e espere de cinco a trinta segundos enquanto o player monta as categorias.

Qual a diferença entre Xtream Codes e uma URL M3U?

Uma conexão Xtream Codes usa três campos e devolve um catálogo estruturado: canais ao vivo por categorias, VOD com capas, séries com temporadas e episódios, e o guia EPG incluído. Uma URL M3U simples é um único link que devolve uma lista plana, normalmente sem VOD estruturado, sem controle de temporadas e sem EPG, que precisa ser adicionada à parte por um link XMLTV.

Por que meu login Xtream Codes falha se a senha está certa?

A causa mais comum é a porta ou o esquema. Muitos painéis usam a porta 8080, outros a 80 ou a 25461, e http e https não são intercambiáveis. Depois vêm os erros de maiúsculas e minúsculas: copie e cole o usuário e a senha em vez de digitar e confira se não há espaços sobrando. Digite apenas o host e a porta base, sem acrescentar player_api.php, get.php nem uma barra no fim.

Leituras relacionadas

• Player M3U para Windows
• M3U ou Xtream Codes explicado
• Dispositivos compatíveis
• Política «traga sua própria lista»