Xtream Codes: tutto spiegato nel 2026 (API, sicurezza, configurazione)

Se hai mai configurato un abbonamento IPTV su TiviMate, Smarters Pro o IBO Player, probabilmente hai visto tre campi: host (o URL del server), nome utente e password. Questo trio si chiama Xtream Codes, un'API che ha ridefinito il modo in cui i lettori IPTV dialogano con i server. Questa guida spiega tutto, dal funzionamento interno alle buone pratiche di sicurezza.

Che cos'è l'API Xtream Codes?

Xtream Codes nacque come pannello di gestione per fornitori IPTV, creato negli anni Dieci. La sua API REST esponeva elenchi di canali, guida ai programmi, video on demand e serie attraverso endpoint standard. Anche dopo la chiusura dell'azienda originale, il protocollo è rimasto uno standard di fatto, adottato praticamente da ogni server IPTV e da ogni lettore serio.

In concreto, un trio del tipo http://esempio.com:80 / tuo_utente / tua_password permette all'app di recuperare dinamicamente l'elenco in diretta (circa 66.000 canali), la griglia dei programmi di sette giorni, il catalogo di film con le copertine e le serie con stagioni ed episodi.

Xtream Codes contro M3U: confronto

• Formato M3U: un solo URL, contenuto statico, nessuna guida nativa, ideale per Kodi e VLC.
• Xtream Codes: trio di API, contenuto dinamico, guida, film e serie inclusi, necessario per TiviMate.
• Aggiornamenti: l'M3U si scarica in blocco; Xtream carica per categoria su richiesta.
• Multidispositivo: entrambi i formati supportano più connessioni secondo il piano sottoscritto.

Anatomia di una configurazione Xtream Codes

L'host (URL del server)

L'host è l'indirizzo del tuo server IPTV, per esempio http://line.atvcorner.com:80. Comprende il protocollo (http o https), il dominio e la porta. La porta 80 è l'HTTP standard, la 443 corrisponde all'HTTPS, mentre la 8080 e la 25461 vengono usate talvolta da server specifici.

Il nome utente e la password

Il tuo identificativo e la tua password univoci, legati all'abbonamento. Non condividerli mai: uno stesso utente consente soltanto il numero di connessioni simultanee autorizzate dal tuo piano.

Gli endpoint accessibili

Una volta autenticata, l'app accede a indirizzi come /player_api.php?action=get_live_categories oppure /player_api.php?action=get_vod_streams. È per questo che TiviMate può caricare la sola categoria sport quando la apri, invece delle altre 60.000 voci.

Configurare Xtream Codes sui lettori principali

TiviMate (Android TV)

1. Apri TiviMate e scegli Add playlist.
2. Seleziona Xtream Codes (o Stalker Portal a seconda della versione).
3. Compila: nome del profilo, URL del server (l'host), nome utente e password.
4. Conferma. TiviMate scarica elenco e guida in background.

IPTV Smarters Pro

1. Add New User → Login with Xtream Codes API.
2. Compila i tre campi e il nome del profilo.
3. L'app sincronizza tutte le categorie in meno di un minuto.

IBO Player

Su ibo.tv, aggiungi il dispositivo tramite MAC e poi scegli Xtream Codes invece di M3U URL. Inserisci host (spesso senza la porta), nome utente e password.

Sicurezza: proteggere il tuo account Xtream

• Non condividere mai il trio host/utente/password: chi lo possiede consuma le tue connessioni e può causare un blocco sul server.
• Se sospetti una fuga di dati, contatta il fornitore per rigenerare la password.
• Diffida dei siti che offrono «account Xtream gratuiti»: sono credenziali rubate, sono illegali e smettono di funzionare entro 24 ore.
• Preferisci i server HTTPS quando il fornitore li offre: le credenziali viaggiano cifrate.

Risolvere gli errori di Xtream Codes

«User and password incorrect»: controlla che non ci siano spazi all'inizio o alla fine, l'errore più comune. «Server is offline»: prova senza la porta, oppure con un'altra porta (80, 8080, 25461). «Max connections reached»: un altro dispositivo sta già usando il tuo abbonamento; scollegalo o passa a un piano con più connessioni simultanee.