Onde encontro o meu URL, nome de utilizador e palavra-passe Xtream Codes?

Estas três informações são fornecidas pelo teu fornecedor IPTV quando subscreves, normalmente por e-mail ou mensagem, às vezes sob a forma de um URL get.php que já as contém (os parâmetros username e password).

Devo acrescentar /get.php ao fim do URL do servidor?

Não. Num leitor compatível com Xtream Codes introduzes apenas a base: http://servidor:porta. É o leitor que constrói sozinho as chamadas get.php e player_api.php. Se te deram um URL get.php completo, extrai dele a base, o nome de utilizador e a palavra-passe.

Porque recebo um erro de início de sessão mesmo com as credenciais corretas?

Verifica, por ordem: a porta (muitas vezes 8080 ou 80, tem de fazer parte do URL), http vs https (mantém exatamente o que o teu fornecedor forneceu), espaços a mais antes ou depois dos campos, e por fim se a subscrição ainda é válida — uma conta expirada devolve um erro de autenticação.

Xtream Codes vs M3U: qual é a diferença?

Ambos dão acesso à mesma subscrição. Um M3U é uma simples lista de streams; a API Xtream Codes acrescenta categorias, pósteres, o guia de TV (EPG) e um catálogo VOD estruturado. Quando o teu leitor o suportar, prefere o login Xtream Codes.

Configurar Xtream Codes num leitor IPTV

Guia atualizado a 9 de agosto de 2026 — aplica-se ao Maya IPTV e a qualquer leitor compatível.

«Xtream Codes», «URL get.php», «login Xtream»… estes termos aparecem em todos os e-mails dos fornecedores IPTV e podem confundir ao início. A realidade é simples: tudo se resume a três informações que copias para o teu leitor. Este guia explica o que é a API Xtream Codes, como são formatados os URLs, e como iniciar sessão em dois minutos.

O Maya IPTV é um leitor multimédia: não fornece, não aloja nem vende qualquer conteúdo ou subscrição. Usas a tua própria subscrição fornecida pelo teu fornecedor.

O que é, exatamente, o Xtream Codes?

Xtream Codes é o nome de uma API (um protocolo de troca) que se tornou o padrão de facto entre os servidores dos fornecedores IPTV e as apps de reprodução. Na prática, o teu fornecedor dá-te três informações:

o URL do servidor, incluindo a porta — por exemplo http://exemplo.tld:8080;
um nome de utilizador;
uma palavra-passe.

Com estes três elementos, qualquer leitor compatível obtém automaticamente os teus canais em direto, o guia de programação (EPG), os filmes e as séries — tudo organizado por categoria. É muito mais rico do que uma simples playlist M3U, que só transporta a lista bruta de streams.

O formato do URL get.php

Alguns fornecedores enviam um URL «pronto a usar» como este:

http://exemplo.tld:8080/get.php?username=OMEUUSER&password=AMINHAPASS&type=m3u_plus

Na verdade, esse URL contém as tuas três credenciais. Para o decompor:

URL do servidor: tudo o que está antes de /get.php → http://exemplo.tld:8080;
Nome de utilizador: o valor a seguir a username=;
Palavra-passe: o valor a seguir a password=.

Num leitor compatível com Xtream Codes, nunca acrescentes /get.php: introduz apenas a base do servidor — a app constrói sozinha as chamadas (player_api.php para o catálogo, get.php para os streams).

Introduzir as tuas credenciais no Maya IPTV (ou em qualquer outro leitor)

Abre a app e escolhe Xtream Codes como tipo de ligação;
Cola o URL do servidor exatamente como foi fornecido: mesmo protocolo (http ou https), mesma porta, nada depois da porta;
Introduz o nome de utilizador e depois a palavra-passe, respeitando maiúsculas e minúsculas;
Confirma: o primeiro carregamento do catálogo pode demorar um a dois minutos, consoante o tamanho da tua subscrição.

O procedimento é idêntico em todos os leitores do mercado — é essa a vantagem do padrão: as tuas credenciais não ficam presas a uma app (vê o nosso guia sobre mudar de leitor sem perder nada).

Erros comuns (e como resolvê-los)

Porta errada: o URL tem quase sempre de incluir uma porta (:8080, :80, :2095…). Sem ela, a ligação falha. Copia o URL do fornecedor caráter por caráter;
http vs https: não «corrijas» o protocolo por tua conta. Se o teu fornecedor forneceu http, forçar https vai falhar muitas vezes (e vice-versa);
Espaços invisíveis: um único espaço copiado antes ou depois do nome de utilizador/palavra-passe basta para quebrar a autenticação. Numa televisão, verifica bem o que o teclado no ecrã escreveu;
Conta expirada ou demasiados ecrãs: se tudo estiver correto mas o início de sessão for recusado, a tua subscrição pode ter expirado, ou pode já estar a ser usada no número máximo de dispositivos em simultâneo. Contacta o teu fornecedor;
URL M3U em vez da base: colar o URL get.php completo no campo «servidor» é o erro número um. Guarda apenas a base (vê a secção anterior).

Transferir o Maya IPTV grátis

Disponível no Android, Android TV, Fire TV, Windows e iPhone / iPad.

FAQ

Onde encontro o meu URL, nome de utilizador e palavra-passe?

São fornecidos pelo teu fornecedor IPTV quando subscreves, normalmente por e-mail — às vezes agrupados num URL get.php que só tens de decompor (vê acima).

Devo acrescentar /get.php ao fim do URL?

Não. Introduzes apenas a base http://servidor:porta; o leitor constrói sozinho as chamadas.

As minhas credenciais estão corretas mas o início de sessão falha — porquê?

Verifica, por ordem: a porta no URL, o protocolo (http/https exatamente como foi fornecido), espaços a mais, e depois se a tua subscrição ainda está ativa junto do teu fornecedor.

Xtream Codes ou M3U — qual escolher?

Ambos acedem à mesma subscrição, mas o Xtream Codes acrescenta categorias, pósteres, o EPG e um catálogo VOD estruturado. Prefere-o sempre que o teu leitor o oferecer.