Ciao a tutti utenti di Unraid Italia! Oggi vediamo come integrare i canali TV (IPTV) direttamente all'interno di Plex utilizzando xTeve.

Cos'è xTeve?

xTeve è un proxy M3U che emula un hardware HDHomeRun. Questo permette a Plex di "vedere" una lista IPTV come se fosse un sintonizzatore fisico collegato alla rete, abilitando funzionalità come la Guida TV (EPG) e la registrazione (DVR).

Disclaimer: Questa guida è redatta a solo scopo illustrativo per usi privati e legali. L'autore e il forum non si assumono alcuna responsabilità per utilizzi illeciti derivanti dall'uso di questo software.

1. Requisiti Preliminari

Prima di iniziare, assicuratevi di avere:

• Plex Media Server installato e funzionante.

• Una lista canali in formato M3U (nell'esempio useremo Pluto TV).

• Un file/link XMLTV (per l'EPG - la guida programmi).

• Plex Pass (necessario per la funzione Live TV/DVR di Plex).

2. Installazione del Docker

1. Andate nel tab APPS del vostro server Unraid.

2. Cercate xTeve.

   • Nota: Se volete offuscare il traffico, potete usare la versione xTeve_VPN, come nel mio caso (la configurazione di base però non cambia).

     

3. Configurazione parametri Docker:

   • Network Type: Impostate tassativamente su Host (necessario affinché Plex lo rilevi automaticamente).

   • Temp Directory: Create o assegnate una cartella specifica.

     • Consiglio: Puntate la directory sulla Cache (M.2/SSD) per eliminare i colli di bottiglia durante il buffering.

• VPN (Opzionale): Se usate la versione VPN, inserite le credenziali del vostro provider.

• Local Network: Inserite la struttura della vostra sottorete LAN (es. 192.168.1.0/24 o 192.168.178.0/24). È l'IP che usate per accedere a Unraid, ma terminante con .0/24.

Controllate che le porte non siano in conflitto con altri servizi e cliccate su Apply.

3. Configurazione di xTeve (Web UI)

Aprite l'interfaccia web di xTeve (solitamente IP-DEL-SERVER:34400/web). Al primo avvio partirà un wizard:

1. Tuner: Inserite il numero di stream simultanei consentiti dal vostro provider. Se usate Pluto TV o liste libere, inserite un numero congruo ai vostri utenti (es. 5).

2. EPG Source: Selezionate XMLTV.

3. M3U Playlist URL: Inserite il link della vostra lista.

   • Esempio Pluto TV: https://raw.githubusercontent.com/Brenders/Pluto-TV-Italia-M3U/main/PlutoItaly.m3u

4. XMLTV URL: Inserite il link per la guida programmi.

   • Esempio Pluto TV: https://raw.githubusercontent.com/matthuisman/i.mjh.nz/master/PlutoTV/it.xml
     Ottimizzazione Streaming (Fondamentale)

     Una volta terminato il wizard, andate in Settings per garantire la massima stabilità:

   • Streaming > Stream Buffer: Impostate su FFmpeg.
     

1. Buffer Size: 1MB (standard) o 5MB se avete una connessione meno stabile.

2. FFmpeg Options: Sovrascrivete la riga esistente con questa configurazione ottimizzata:

   -hide_banner -loglevel error -i [URL] -c:a libmp3lame -vcodec copy -f mpegts pipe:1

le impostazioni dovrebbero essere come nell'immagine:

Prossimi Passi

Ora che xTeve è configurato e i canali sono "mappati", il server è pronto per essere aggiunto a Plex.

Fate SAVE, chiudete il docker e riavviatelo.

Configurazione Su Plex Media Server

Dopo aver configurato correttamente xTeve, il gioco è quasi fatto. Ora dobbiamo dire a Plex di leggere xTeve come se fosse un sintonizzatore fisico.

1. Preparazione degli URL in xTeve

Prima di spostarci su Plex, assicuratevi di avere sottomano i due indirizzi fondamentali che xTeve ha generato per voi. Li trovate nella schermata principale (Dashboard) di xTeve:

• DVR IP: (es. http://192.168.1.100:34400)

• XEPG URL: (il link che finisce con .xml, serve per la guida programmi).

2. Aggiungere il sintonizzatore su Plex

1. Aprite Plex, andate in Impostazioni (l'icona della chiave inglese in alto a destra).

2. Nella colonna di sinistra, scorrete verso il basso fino alla sezione Gestisci e cliccate su Live TV & DVR.

3. Cliccate sul pulsante Configura il DVR di Plex (o "Aggiungi un dispositivo").

4. Plex inizierà la scansione. Se xTeve è impostato correttamente su rete HOST, dovrebbe apparire automaticamente.

   • Se non appare: Cliccate su "Inserisci l'indirizzo IP manualmente" e digitate l'indirizzo di xTeve (es. 192.168.1.100:34400).

5. Una volta trovato, cliccate su Continua.

3. Configurazione Canali e Guida (EPG)

Qui è dove colleghiamo i programmi ai canali:

1. Plex vi mostrerà l'elenco dei canali trovati. Cliccate su Continua.

2. Nella schermata successiva, Plex vi chiederà la nazione e il codice postale per la guida programmi. NON usate quella di Plex.

3. Cliccate invece sulla scritta arancione in alto: "Hai un file XMLTV sul tuo computer?".

4. Nel campo Guida XMLTV, incollate l'indirizzo XEPG URL che avete copiato prima da xTeve.

5. Date un nome alla guida (es. "Pluto TV xTeve") e premete Continua.

4. Mapping dei Canali

Plex caricherà la lista. Ora dovete assicurarvi che il nome del canale a sinistra corrisponda al programma corretto a destra.

• Se avete fatto tutto bene in xTeve, Plex dovrebbe accoppiarli automaticamente.

• Se vedete dei canali "non mappati", selezionateli manualmente dal menu a tendina.

• Cliccate su Continua e poi su Fine.

5. Consigli Post-Configurazione

Plex inizierà a scaricare i dati della guida (potrebbe volerci qualche minuto). Una volta terminato:

• Aggiornamento Guida: Di default Plex aggiorna la guida ogni poche ore. Potete forzarlo andando in Impostazioni > Live TV & DVR e cliccando sui tre puntini accanto al dispositivo, selezionando "Aggiorna Guida".

• Qualità Streaming: Poiché abbiamo impostato il buffer su FFmpeg nella Parte 1, Plex riceverà un flusso già ottimizzato. Se notate scatti, tornate in xTeve e aumentate il buffer a 5MB.

• Transcodifica: Se volete registrare i programmi, ricordate che Plex salverà il file così come arriva. Assicuratevi di avere abbastanza spazio sul disco configurato per le registrazioni.

Ora, andando nella sezione Live TV del vostro client Plex (TV, Smartphone o Web), troverete la griglia programmi completa. Potete cambiare canale, guardare cosa c'è in onda e persino programmare registrazioni come se aveste un decoder di ultima generazione!

Trucco Extra: Se aggiungete o rimuovete canali in xTeve in futuro, ricordatevi sempre di fare un "Update" sia su xTeve che sulla Guida di Plex per vedere le modifiche.

Buona visione a tutti su Unraid Italia!

PS. Liste ITA/ENG libere e gratuite con i suoi epg:

M3u

Pluto TV:

https://raw.githubusercontent.com/Brenders/Pluto-TV-Italia-M3U/main/PlutoItaly.m3u

Samsung TV:

https://tinyurl.com/multiservice21?region=it&service=SamsungTVPlus

Roku TV:

https://tinyurl.com/multiservice21?region=it&service=Roku

PBS:

https://tinyurl.com/multiservice21?region=it&service=PBS

https://tinyurl.com/multiservice21?region=it&service=PBSKids

Stirr:

https://tinyurl.com/multiservice21?region=it&service=Stirr

Tubi:

https://raw.githubusercontent.com/BuddyChewChew/tubi-scraper/refs/heads/main/tubi_playlist.m3u

EPG:

Pluto TV:

https://raw.githubusercontent.com/matthuisman/i.mjh.nz/master/PlutoTV/it.xml

Samsung TV:

https://github.com/matthuisman/i.mjh.nz/raw/master/SamsungTVPlus/it.xml.gz

Roku TV:

https://github.com/matthuisman/i.mjh.nz/raw/master/Roku/all.xml.gz

PBS:

https://i.mjh.nz/PBS/all.xml.gz

https://github.com/matthuisman/i.mjh.nz/raw/master/PBS/kids_all.xml.gz

Stirr:

https://i.mjh.nz/Stirr/all.xml.gz

Tubi:

https://github.com/dtankdempse/tubi-m3u/raw/refs/heads/main/tubi_epg_us.xml

testate i link 1 per volta perchè xTeve supporta massimo 500 canali (a quanto so) quindi inserite quello che ritenete più interessante per le vostre esigenze

AGGIORNAMENTO 23/04/2026

se non trovate xteve perchè vi da outdated, usate Threadfin che è identico ma più recente

Edited April 23Apr 23 by Ricyx
aggiornato con nuovo docker

GitHub

GitHub - Free-TV/IPTV: M3U Playlist for free TV channels

M3U Playlist for free TV channels. Contribute to Free-TV/IPTV development by creating an account on GitHub.

Ottima guida, peccato che avendo un HDhomerun non riesco ad aggiungere un altro sinto. Praticamente Plex li vede entrambi, ma non aggiunge canali se non hanno la guida TV (cosa nota) ma se aggiungo es. exteve, poi non trova la guida tv dei canali broadcast e viceversa. Ho provato anche a mettere 2 guide TV in xteve, ma poi vede un solo XMLTV ci riunucio XD

1 hour ago, XRedShark said:

Ottima guida, peccato che avendo un HDhomerun non riesco ad aggiungere un altro sinto. Praticamente Plex li vede entrambi, ma non aggiunge canali se non hanno la guida TV (cosa nota) ma se aggiungo es. exteve, poi non trova la guida tv dei canali broadcast e viceversa. Ho provato anche a mettere 2 guide TV in xteve, ma poi vede un solo XMLTV ci riunucio XD

Puoi provare con threadfin anche se l'idea è uguale

you can generate this with xteve:
http://<your IP of XTEVE>:34400/xmltv/xteve.xml

*Programmed inside xteve with filters...

plex needs the xml file, I usually use no cords for USA English.


USA - English Pluto https://nocords.xyz/

when plex asks for a guide use the xml:
https://nocords.xyz/pluto/epg.xml

example nocords:
xteve playlist:


plex add tuner:



###################################################################################

Its why I shared the Legal Free IPTV:
https://github.com/Free-TV/IPTV

the guides and playlist.
INFO Playlist info of content: https://github.com/Free-TV/IPTV/blob/master/lists/italy.md
Xteve the file to grab: https://raw.githubusercontent.com/Free-TV/IPTV/refs/heads/master/playlists/playlist_italy.m3u8

For Plex:.
Example for all the egp xml GUIDE DATA: https://github.com/Free-TV/IPTV/blob/master/epglist.txt
XTEVE Italy xml https://epgshare01.online/epgshare01/epg_ripper_IT1.xml.gz

guida aggiornata