Configurare Xtream Codes in un lettore IPTV
Guida aggiornata il 9 agosto 2026 — valida per Maya IPTV e qualsiasi lettore compatibile.
«Xtream Codes», «URL get.php», «accesso Xtream»… questi termini compaiono in ogni email degli operatori IPTV e all'inizio possono confondere. La realtà è semplice: si riduce tutto a tre informazioni da copiare nel tuo lettore. Questa guida ti spiega cos'è l'API Xtream Codes, come sono formattati gli URL e come accedere in due minuti.
Cos'è esattamente Xtream Codes?
Xtream Codes è il nome di un'API (un protocollo di scambio) diventata lo standard di fatto tra i server degli operatori IPTV e le app di riproduzione. In pratica, il tuo operatore ti fornisce tre informazioni:
- l'URL del server, porta inclusa — per esempio
http://example.tld:8080; - un nome utente;
- una password.
Con questi tre elementi, qualsiasi lettore compatibile recupera automaticamente i tuoi canali in diretta, la guida programmi (EPG), i film e le serie — tutto organizzato per categoria. È molto più ricco di una semplice playlist M3U, che contiene solo la lista grezza dei flussi.
Il formato dell'URL get.php
Alcuni operatori inviano un URL «già pronto» come questo:
http://example.tld:8080/get.php?username=MIOUTENTE&password=MIAPASSWORD&type=m3u_plus
Quell'URL contiene in realtà le tue tre credenziali. Per scomporlo:
- URL del server: tutto quello che precede
/get.php→http://example.tld:8080; - Nome utente: il valore dopo
username=; - Password: il valore dopo
password=.
In un lettore compatibile Xtream Codes, non aggiungere mai /get.php: inserisci solo la base del server — è l'app a costruire da sola le chiamate (player_api.php per il catalogo, get.php per i flussi).
Inserire le credenziali in Maya IPTV (o in qualsiasi altro lettore)
- Apri l'app e scegli Xtream Codes come tipo di connessione;
- Incolla l'URL del server esattamente come fornito: stesso protocollo (http o https), stessa porta, niente dopo la porta;
- Inserisci il nome utente e poi la password, rispettando maiuscole e minuscole;
- Conferma: il primo caricamento del catalogo può richiedere uno o due minuti a seconda delle dimensioni del tuo abbonamento.
La procedura è identica in tutti i lettori sul mercato — è proprio questo il senso dello standard: le tue credenziali non sono vincolate a una sola app (vedi la nostra guida su come cambiare lettore senza perdere nulla).
Errori comuni (e come risolverli)
- Porta sbagliata: l'URL deve quasi sempre includere una porta (
:8080,:80,:2095…). Senza, la connessione fallisce. Copia l'URL dell'operatore carattere per carattere; - http vs https: non «correggere» il protocollo da solo. Se il tuo operatore ti ha fornito
http, forzarehttpsspesso fallirà (e viceversa); - Spazi invisibili: basta un solo spazio copiato prima o dopo il nome utente o la password per far fallire l'autenticazione. Su una TV, ricontrolla cosa ha digitato la tastiera a schermo;
- Account scaduto o troppi schermi: se è tutto corretto ma l'accesso viene rifiutato, il tuo abbonamento potrebbe essere scaduto, oppure essere già in uso sul numero massimo di dispositivi simultanei. Contatta il tuo operatore;
- URL M3U al posto della base: incollare l'URL
get.phpcompleto nel campo «server» è l'errore numero uno. Tieni solo la base (vedi la sezione precedente).
Disponibile su Android, Android TV, Fire TV, Windows e iPhone / iPad.
FAQ
Dove trovo il mio URL, il nome utente e la password?
Te li fornisce il tuo operatore IPTV al momento della sottoscrizione, di solito via email — a volte raggruppati in un URL get.php che devi solo scomporre (vedi sopra).
Devo aggiungere /get.php alla fine dell'URL?
No. Inserisci solo la base http://server:porta; è il lettore a costruire da solo le chiamate.
Le mie credenziali sono corrette ma l'accesso fallisce — perché?
Verifica, nell'ordine: la porta nell'URL, il protocollo (http/https esattamente come fornito), gli spazi di troppo, e infine che il tuo abbonamento sia ancora attivo presso il tuo operatore.
Xtream Codes o M3U — quale scegliere?
Entrambi accedono allo stesso abbonamento, ma Xtream Codes aggiunge categorie, locandine, l'EPG e un catalogo VOD strutturato. Preferiscilo ogni volta che il tuo lettore lo offre.