Guida alla configurazione
Come guardare l’IPTV su iPhone e iPad con una playlist M3U o un accesso Xtream
Se il tuo provider IPTV ti ha dato un link M3U o un accesso Xtream Codes, puoi guardarlo in Onyx IPTV in circa due minuti. Questa guida copre entrambi, più l’EPG e i problemi più frequenti.
Onyx IPTV è solo un lettore. Non fornisce, non ospita e non vende canali, film o serie. Hai bisogno di un abbonamento con un provider IPTV e sei responsabile dei diritti sui contenuti che riproduci.
Cosa ti serve
- Un iPhone o iPad con iOS 18 o successivo, oppure una Apple TV (l’app tvOS è nella stessa scheda App Store).
- Onyx IPTV dall’App Store (gratis).
- Dal tuo provider, uno tra: un URL di playlist M3U / M3U8, un accesso Xtream Codes (URL del server, nome utente, password) oppure un link get.php / player_api che contiene questi dati.
Configurare una playlist M3U
Apri Impostazioni → Connessioni → Aggiungi provider
Scegli M3U. Dai un nome alla connessione per distinguere i provider in seguito.
Incolla l’URL della playlist
Incolla il link completo, inclusa l’eventuale parte ?username=…&password=…. Non aggiungere spazi prima o dopo.
Aggiungi una fonte EPG (facoltativo)
Se il tuo provider offre un URL XMLTV o EPG, incollalo nel campo EPG. Onyx mostrerà così il programma in corso, le barre di avanzamento e la griglia della guida.
Salva e carica
Onyx scarica la playlist, ordina i canali in gruppi e separa automaticamente la TV in diretta da film e serie.
Configurare un accesso Xtream Codes
Apri Impostazioni → Connessioni → Aggiungi provider
Scegli Xtream.
Incolla il link o inserisci i dati
Incolla il link get.php o player_api inviato dal tuo provider e Onyx compila server, nome utente e password. Oppure inserisci i tre valori a mano. L’URL del server di solito ha questa forma: http://host:porta.
Controlla la scheda di stato
Dopo l’accesso la scheda della connessione mostra la data di scadenza dell’account, il numero di flussi simultanei consentiti dal tuo piano e quanti canali supportano il catch-up.
Guida e catch-up si caricano automaticamente
Gli account Xtream forniscono l’EPG insieme all’accesso. I canali con archivio mostrano un’opzione di replay e lo scaffale «Ti sei perso qualcosa?» raccoglie i programmi terminati.
Usare l’app
- TV in diretta: l’elenco mostra il programma in corso, una barra di avanzamento e il tempo rimanente per canale. Tocca la stella per i preferiti. Filtra per gruppo o categoria.
- Guida: una griglia EPG completa con la linea del momento attuale. Cerca in tutta la guida per titolo e imposta un promemoria per un programma in arrivo.
- Raccolta: film e serie con locandine, trama, cast e trailer. «Continua a guardare» riprende da dove ti eri fermato.
- Cerca: una sola ricerca su canali, film e serie.
- Raggruppamento per qualità (Pro): le varianti SD, HD, FHD e 4K dello stesso canale si uniscono in una sola riga.
Risoluzione dei problemi
«Accesso non riuscito» o elenco canali vuoto
Controlla che non ci siano spazi in più nell’URL del server, nel nome utente o nella password. Assicurati che l’account non sia scaduto (la scheda di stato mostra la data). Alcuni provider bloccano le connessioni VPN.
Un flusso non parte o si interrompe dopo pochi secondi
Verifica prima che lo stesso flusso funzioni nel lettore consigliato dal tuo provider. Se funziona, il tuo piano potrebbe aver raggiunto il limite di flussi simultanei. Onyx ti avvisa prima della riproduzione quando tutti i posti sono occupati.
Il video si vede ma non c’è audio, oppure il file è MKV o AVI
Onyx usa prima il lettore nativo di iOS e passa automaticamente al motore VLC per i contenitori e i codec che iOS non decodifica. Se un flusso continua a non funzionare, vai in Impostazioni → Riproduzione e cambia il motore preferito.
La guida è vuota
Le playlist M3U hanno bisogno di un URL EPG (XMLTV) separato dal tuo provider. Gli account Xtream lo caricano automaticamente; usa Impostazioni → Aggiorna contenuti se è obsoleto.
Niente funziona
Scrivi a onyx.iptv.support@gmail.com. Non includere la password del tuo provider nella mail.