Xtream Codes è il formato più diffuso tra i servizi IPTV: un solo indirizzo dà accesso a canali, guida TV, film e serie. In questa guida colleghi il tuo portale a un’app IPTV per Apple TV in circa due minuti, e vedi come risolvere i problemi che bloccano la maggior parte delle prime configurazioni.
OneTV Connect è un lettore IPTV. Nessun canale, contenuto o abbonamento incluso: le credenziali Xtream te le fornisce il servizio a cui sei già abbonato in modo legittimo. L’app non vende abbonamenti e non indica fornitori.
Cosa ti serve prima di iniziare
- L’URL del portale, nel formato
http://host:porta, senza barra finale. A volte il servizio lo indica come «server» o «DNS». - Il nome utente e la password del tuo account.
- Un account iCloud attivo sull’Apple TV, se vuoi ritrovare la playlist su iPhone e iPad senza reinserirla.
Se hai ricevuto solo un link che finisce con get.php?username=…&password=…, contiene
già le tre informazioni: host e porta prima di /get.php, poi nome utente e password.
Non condividere questo link: vale quanto la tua password.
1. Installa OneTV Connect
Apri l’App Store sull’Apple TV, cerca OneTV Connect e installa l’app. La versione di base è gratuita e include la riproduzione IPTV completa. L’abbonamento Pro serve solo per Plex, Sport Centre, Trakt e i temi. Trovi tutte le funzioni nella pagina del lettore IPTV per Apple TV.
2. Apri la procedura Xtream
Dalla schermata iniziale vai in Impostazioni → Playlist → Aggiungi playlist → Xtream Codes. La procedura dedicata non passa dal file M3U: interroga direttamente l’API del portale. È più veloce e restituisce categorie più ordinate, oltre ai film e alle serie separati dai canali in diretta. Se non sai quale formato scegliere, la guida Xtream, M3U o Stalker (in inglese) confronta le tre opzioni.
3. Inserisci le credenziali
Incolla o digita URL, nome utente e password, poi conferma. L’app contatta il portale, legge le informazioni dell’account e inizia a indicizzare i canali in background. Per una playlist da 5.000 canali servono di solito dai 5 ai 30 secondi.
Digitare con il telecomando è lento. Se hai un iPhone vicino, usa la tastiera che compare sul telefono quando l’Apple TV chiede un testo: puoi incollare le credenziali in un attimo. In alternativa aggiungi la playlist direttamente dall’app su iPhone: con iCloud arriva anche sull’Apple TV.
Al termine trovi i canali ordinati nelle categorie del portale. Molti servizi ne pubblicano decine, spesso per paese o per lingua. Non devi tenerle tutte: dal menu a pressione lunga puoi nascondere una categoria, rinominarla o spostarla. Le modifiche restano anche dopo un aggiornamento della playlist e si sincronizzano sugli altri dispositivi. Se il portale ha film e serie ma non ti interessano, puoi disattivarne l’importazione nelle opzioni della playlist: il caricamento diventa più rapido.
L’app aggiorna la playlist in automatico a intervalli regolari, senza che tu debba fare nulla. Se il servizio cambia indirizzo o porta, modifica solo l’URL nella scheda della playlist: preferiti, categorie nascoste e posizioni di visione restano al loro posto.
4. Controlla guida TV e on demand
Finita l’indicizzazione, apri la scheda Diretta. I programmi devono comparire accanto al nome dei canali. Se un canale non mostra nulla, tienilo premuto e scegli il canale giusto nell’elenco della guida, con la ricerca. L’associazione si sincronizza poi via iCloud.
Se la guida del portale è incompleta, puoi aggiungere una fonte XMLTV esterna in Impostazioni → EPG. Le fonti si sommano: quella Xtream resta, l’altra riempie i buchi. Per i canali italiani abbiamo verificato i file gratuiti uno per uno in EPG XMLTV per l’Italia. Film e serie hanno le loro schede e arrivano dallo stesso portale; locandine e trame vengono completate da TMDB nei minuti successivi.
5. Ritrovala su iPhone e iPad
Apri OneTV Connect su iPhone o iPad con lo stesso account iCloud. La playlist compare da sola, insieme ai preferiti e alle fonti EPG. Non serve un’altra app IPTV per iPhone: è la stessa, con gli stessi dati.
I problemi più comuni
- «Credenziali non valide» con dati corretti. Controlla la porta e togli la barra finale dall’URL. Molti portali rispondono solo sulla porta indicata dal servizio, spesso diversa da 80.
- Portale HTTPS con certificato autofirmato. Alcuni motori rifiutano la connessione senza un messaggio chiaro. Se vedi errori SSL, prova un altro motore di riproduzione nelle impostazioni del lettore.
- Il portale rifiuta l’user agent. Alcuni servizi accettano solo certi client. Nelle impostazioni del lettore puoi indicare un user agent personalizzato.
- I film restituiscono errore 404. Molti endpoint on demand non gestiscono le richieste parziali HTTP. OneTV Connect lo rileva e disattiva l’avanzamento veloce. Se il 404 compare su ogni film, il problema è del servizio: chiedi di attivare il supporto byte-range.
- Guida in ritardo di un giorno. Alcuni servizi aggiornano la guida solo a mezzanotte UTC. In Impostazioni → EPG puoi forzare un aggiornamento. Se gli orari sono tutti spostati di una o due ore, leggi la parte sul fuso orario nella guida EPG per l’Italia.
- Loghi mancanti. Il servizio non ha compilato
tvg-logo. L’app usa allora il logo della guida TV; dal menu a pressione lunga puoi scegliere un logo diverso. - Troppe connessioni. Se il tuo account permette una sola connessione, chiudi il lettore sugli altri dispositivi prima di avviarlo sull’Apple TV.
Un secondo portale Xtream si aggiunge allo stesso modo. Compare nel selettore delle playlist e ci passi con un gesto. Se cerchi un confronto tra lettori prima di decidere, leggi la migliore app IPTV per Apple TV. Per altri errori, la pagina di supporto (in inglese) ha la lista di controllo completa.