Il lettore Xtream Codes
per Windows e Android TV (2026)

Che cos'è Xtream Codes e che cos'è la sua API?

Xtream Codes è un sistema di gestione IPTV comparso all'inizio degli anni Dieci e diventato il software di pannello standard che i provider eseguono sui propri server. L'azienda originale ha chiuso nel 2019, ma il protocollo dell'API Xtream Codes che aveva reso popolare è sopravvissuto ed è tuttora lo standard del settore nel 2026. Per questo, sottoscrivendo quasi qualsiasi abbonamento IPTV, ricevi tre valori invece di un file:

• URL del server (host:porta): l'indirizzo del pannello del tuo provider, scritto come host e porta, ad esempio http://linea.example.com:8080. Sia lo schema (http o https) sia la porta ne fanno parte.
• Nome utente: il nome del tuo account su quel pannello. Distingue maiuscole e minuscole.
• Password: la password del tuo account. Anche questa distingue maiuscole e minuscole.

L'API Xtream Codes non è altro che l'interfaccia HTTP con cui parla il tuo lettore dopo aver inserito quei tre valori. Dietro le quinte il lettore chiama endpoint come player_api.php?action=get_live_categories, get_vod_streams, get_series e get_short_epg. Tu non vedi niente di tutto ciò, solo il risultato: una libreria ordinata e per categorie. Da un solo collegamento, l'API costruisce automaticamente:

• Canali in diretta: organizzati in categorie reali (sport, notizie, bambini, per Paese) e con i loghi.
• VOD: un catalogo di film con locandine, trame e metadati.
• Serie: con elenchi di stagioni ed episodi.
• EPG: la guida ai programmi dei canali in diretta, consegnata dallo stesso collegamento, quindi non serve aggiungere un link XMLTV separato.

Come collegarsi con Xtream Codes

Il passaggio decisivo è scegliere l'opzione Accesso Xtream Codes invece dell'opzione URL M3U: è questo che ti dà tre campi separati anziché un unico campo URL.

1. Apri Aggiungi playlist. Avvia l'applicazione. La prova di 7 giorni non richiede una chiave e parte dalla tua prima riproduzione. Entra nella schermata Playlist e scegli Aggiungi playlist.
2. Scegli Accesso Xtream Codes. Vedrai tre campi: host e porta, nome utente e password.
3. Inserisci host e porta. Digita il server nel formato host:porta, ad esempio http://linea.example.com:8080. Includi lo schema e la porta: :8080 e :80 non sono la stessa cosa. Non incollare un URL completo di player_api.php; solo host e porta di base.
4. Inserisci nome utente e password. Esattamente come te li ha forniti il provider. Distinguono maiuscole e minuscole, quindi copia e incolla invece di digitare.
5. Salva e lascia costruire le categorie. Il lettore chiama l'API Xtream e crea le tue categorie Live, VOD e Serie più la EPG: di norma tra 5 e 30 secondi a seconda della dimensione del catalogo.

Hai un secondo provider? Ripeti gli stessi cinque passaggi. Nightmare TV mantiene più accessi Xtream in parallelo. Se il tuo provider ti ha dato solo un link M3U semplice, vedi come riprodurre playlist M3U su Windows.

Xtream Codes o URL M3U: quando usare cosa

Usa Xtream Codes se il tuo provider lo supporta, come accade nella maggior parte dei casi. Un solo collegamento porta Live + VOD + Serie + EPG, le categorie arrivano già strutturate e locandine e dati di programmazione arrivano da soli. Usa un URL M3U semplice quando il tuo provider offre soltanto M3U o quando hai una playlist costruita a mano. Un trucco: se ti hanno dato un lungo link M3U, l'host:porta iniziale è il tuo URL del server, e i parametri username= e password= sono le tue credenziali. Vedi M3U o Xtream Codes spiegati.

Anatomia di un URL Xtream: get.php e player_api.php

Se ti hanno dato un link lungo invece di tre campi, o se hai cercato get.php o type=m3u_plus, ecco che cosa significa ogni parte. Un tipico URL di esportazione M3U di Xtream si presenta così:

http://linea.example.com:8080/get.php?username=UTENTE&password=PASSWORD&type=m3u_plus&output=ts

Esiste un secondo endpoint più capace: /player_api.php. Invece di un M3U piatto restituisce JSON, che è ciò che un vero client Xtream usa per costruire il catalogo strutturato. Non digiti mai tu nessuno di questi percorsi. Quando inserisci URL del server, utente e password nei tre campi, il lettore aggiunge player_api.php per te e costruisce Live + VOD + Serie + EPG automaticamente: per questo un vero accesso Xtream rende più di un link get.php incollato grezzo.

Risoluzione dei problemi di accesso a Xtream Codes

• «Errore di connessione» anche con la password giusta. Le credenziali distinguono maiuscole e minuscole e spesso confondono 0/O e 1/l/I. Copia e incolla entrambi i campi e controlla che non ci siano spazi in eccesso.
• Porta sbagliata (:80 contro :8080). La porta fa parte dell'URL del server. Molti pannelli usano :8080, alcuni :80 o :25461. Verifica anche lo schema: http o https.
• Percorso o barra incollati di troppo. Inserisci solo host:porta di base. Togli qualsiasi /player_api.php, /get.php o barra finale.
• «Max connections reached». La maggior parte degli abbonamenti limita i flussi contemporanei, spesso tra 1 e 3. Chiudi l'altra sessione o chiedi più connessioni al tuo provider.
• Account scaduto o sospeso. Se il pannello lo segnala come scaduto, nessun lettore potrà collegarsi finché non viene rinnovato.
• Funziona in un'app ma non in un'altra. Quasi sempre è la porta o lo schema. Copia lo schema://host:porta esatto dell'app che funziona.

Domande frequenti

Che cos'è Xtream Codes?

Xtream Codes è un sistema di gestione IPTV diventato il software di pannello standard che i provider eseguono sui propri server. L'azienda originale ha chiuso nel 2019, ma il protocollo della sua API è sopravvissuto ed è tuttora lo standard del settore nel 2026. Per questo, sottoscrivendo quasi qualsiasi abbonamento IPTV, ricevi tre valori invece di un file: un URL di server con porta, un nome utente e una password.

Come si collega un lettore con Xtream Codes?

Scegli l'opzione di accesso Xtream Codes invece dell'opzione URL M3U: è questo che ti dà tre campi separati. Inserisci l'URL del server nel formato host:porta includendo lo schema, ad esempio http://linea.example.com:8080, poi il nome utente e la password esattamente come te li ha forniti il provider. Salva e attendi dai cinque ai trenta secondi mentre il lettore costruisce le categorie.

Che differenza c'è tra Xtream Codes e un URL M3U?

Un accesso Xtream Codes usa tre campi e restituisce un catalogo strutturato: canali in diretta per categorie, VOD con locandine, serie con stagioni ed episodi, e la guida EPG inclusa. Un URL M3U semplice è un unico link che restituisce una lista piatta, di norma senza VOD strutturato, senza gestione delle stagioni e senza EPG, che va aggiunta a parte con un link XMLTV.

Perché l'accesso Xtream Codes fallisce se la password è corretta?

La causa più comune è la porta o lo schema. Molti pannelli usano la porta 8080, altri la 80 o la 25461, e http e https non sono intercambiabili. Poi vengono gli errori di maiuscole e minuscole: copia e incolla utente e password invece di digitarli e controlla che non ci siano spazi in eccesso. Inserisci solo host e porta di base, senza aggiungere player_api.php, get.php o una barra finale.

Letture correlate

• Lettore M3U per Windows
• M3U o Xtream Codes spiegati
• Dispositivi compatibili
• Politica «porta la tua playlist»