Guida

Tre formati, tutti autosufficienti — Python, Qt, libmpv e ffmpeg sono dentro il download, quindi non c'è nient'altro da installare.

AppImage — quello da prendere se hai dubbi. Funziona su qualsiasi distribuzione:

chmod +x dopeIPTV-*.AppImage
./dopeIPTV-*.AppImage

.deb su Debian o Ubuntu:

sudo apt install ./dopeiptv_*_amd64.deb

Flatpak:

flatpak install --user dopeIPTV-*.flatpak

Di tutti e tre esiste la versione arm64, per un Raspberry Pi o un server ARM.

Apri il .dmg e trascina dopeIPTV in Applicazioni. Serve macOS 15 o successivo e l'app gira su Apple Silicon — la 1.2.10 è stata l'ultima versione con build Intel.

Il primo avvio viene rifiutato perché l'app non è autenticata da Apple. Fai clic destro sull'app e scegli Apri, poi Apri di nuovo nella finestra. Se non basta, vedi «macOS dice che l'app non può essere aperta» più sotto.

Non c'è un programma di installazione. Estrai dopeIPTV-*-windows-x64.zip dove preferisci — la cartella utente va benissimo, non servono diritti di amministratore — ed esegui il dopeiptv.exe che trovi dentro.

Esiste una build arm64 nativa per i portatili Snapdragon; anche la x64 funziona lì, in emulazione e quindi più lentamente.

Per un collegamento nel menu Start o sul desktop: Impostazioni → Interfaccia → Manutenzione → Crea collegamento. Il README.txt nello zip elenca tutto ciò che va cancellato se vuoi rimuovere l'app senza lasciare tracce.

Al primo avvio ti vengono chiesti tre dati del tuo account Xtream Codes:

• Server — l'indirizzo con la porta, tipo http://example.com:8080. Non un URL di playlist completo, solo l'host.
• Nome utente e Password — quelli che ti ha dato il provider.

Vengono salvati. Per aggiungere un altro account in seguito, o modificare questo: Impostazioni → Playlist. Puoi passare da una playlist all'altra con l'app aperta, e preferiti e cronologia restano separati per ciascuna.

Sì. Scegli M3U quando aggiungi una playlist e incolla l'indirizzo che ti ha dato il provider.

Un account Xtream sfrutta di più l'app — catch-up, scadenza dell'account, la guida del provider — perché arrivano da un'API che una lista M3U non ha. Una lista M3U si riproduce e può ricevere un proprio indirizzo XMLTV per la guida, il che copre quasi tutta la differenza.

Sì. La procedura iniziale propone dei canali dimostrativi: alcuni flussi di prova liberi e pubblici di Mux, Apple e Bitmovin, così vedi l'app all'opera prima di digitare qualsiasi cosa. Sono flussi di test ufficiali, non il servizio di qualcuno, e puoi passare a una playlist vera quando vuoi.

Doppio clic nella lista centrale, oppure premi ▶ Riproduci nel pannello di destra. Scegliere un altro canale sostituisce il flusso sul posto invece di smontare e ricostruire il lettore — è per questo che lo zapping è rapido.

I pulsanti Indietro e Avanti nella barra del lettore scorrono la lista in cui ti trovi — canali, episodi di una serie, registrazioni o cronologia.

Per film, episodi, registrazioni e catch-up — tutto ciò che ha una durata nota:

• Porta il puntatore sull'immagine e sale una barra di avanzamento, con tempo trascorso e totale e i pulsanti −10 s / +30 s.
• Fai un clic sul video e usa le frecce: una pressione salta dieci secondi, tenendola premuta si scorre di continuo.

I canali in diretta non si scorrono e di proposito non mostrano alcuna barra. Per spostarti dentro un canale in diretta serve il timeshift — vedi sotto.

Doppio clic sull'immagine, o premi F. Esc esce — e lo fa anche il pulsante esplicito Esci da schermo intero nella barra fluttuante, che esiste proprio perché nessuno debba conoscere Esc.

I controlli e il puntatore si nascondono dopo qualche secondo di immobilità e tornano al minimo movimento.

Sì — stacca il lettore in una finestra propria e trascinala dove vuoi.

È senza cornice per impostazione predefinita: trascina da un punto qualsiasi dell'immagine per spostarla. Clic destro per «sempre in primo piano», barra del titolo o Esci. Anche Esc la riporta indietro. La finestra principale continua a funzionare nel frattempo.

Il pulsante ⚙ nella barra del lettore — c'è anche nei controlli a schermo intero — contiene tutto quello che riguarda il flusso in corso:

• Traccia audio e traccia dei sottotitoli
• Ritardo audio, quando il suono non è sincronizzato
• Rapporto d'aspetto (16:9, 4:3, allungato e così via)
• Dimensione del buffer di rete
• Stats for nerds: codec, risoluzione, frequenza dei fotogrammi, decodifica hardware, sincronia A/V, fotogrammi persi, cache e velocità di rete, in tempo reale sopra l'immagine

La traccia scelta viene ricordata, e in una serie passa all'episodio successivo. Se invece vuoi una preferenza valida per tutti i flussi, vedi Impostazioni più sotto.

• Spazio — pausa e ripresa
• F — schermo intero, Esc per uscire
• ← / → — dieci secondi, tieni premuto per continuare
• M — muto

Funzionano allo stesso modo nella finestra principale, a schermo intero e nella finestra staccata.

Sì, per film, episodi di serie, registrazioni e i tuoi file locali. Riavviando qualcosa ti chiede se riprendere da quel punto o ricominciare dall'inizio.

Le posizioni molto vicine all'inizio o alla fine vengono ignorate di proposito, per non proporti di riprendere qualcosa che avevi appena cominciato o che avevi effettivamente finito.

Dal tuo provider. Ogni canale in diretta mostra nella lista cosa c'è adesso con una barra di avanzamento, e il pannello dei dettagli mostra cosa viene dopo.

La guida viene messa in cache su disco per ogni playlist, quindi è a schermo appena avvii l'app — la copia aggiornata si scarica in secondo piano e la sostituisce. Se quel download fallisce, resta la guida in cache invece di lasciarti senza nulla.

Sì. Il pulsante Guida nella barra laterale apre una griglia di programmi consultabile su tutti i canali, con una linea temporale da scorrere. La ricerca trova un programma per nome su tutti i canali.

Su un canale con catch-up, un doppio clic su un programma già andato in onda lo riproduce dall'archivio.

Dai a quella playlist una guida propria al posto di quella del provider:

1. Impostazioni → Playlist
2. Seleziona la playlist e modificala
3. Metti un indirizzo XMLTV nel campo della guida personalizzata

Sostituisce quello che manda il provider. L'app abbina i tuoi canali a quella guida prima per identificativo EPG e poi per nome del canale, quindi anche una guida di altra origine di solito combacia.

Alcuni provider pubblicano orari che non corrispondono a quello che trasmettono davvero. In Impostazioni → Riproduzione ci sono due correzioni distinte:

• Lo scostamento EPG sposta tutti gli orari mostrati dalla guida.
• Lo scostamento replay sposta il punto in cui catch-up e timeshift iniziano a riprodurre, senza toccare gli orari elencati.

Sono separati perché i provider sbagliano l'uno indipendentemente dall'altro.

Alcuni provider conservano qualche giorno di registrazione di ogni canale. Dove il tuo lo fa, il canale porta il contrassegno ⏪ nella lista, e il pannello dei dettagli dice quanti giorni copre l'archivio.

Se un canale non ha il contrassegno, il provider non offre archivio per quel canale. È una sua impostazione e nulla nell'app può attivarla.

Premi il pulsante ⏪ nel lettore — c'è anche nei controlli a schermo intero — oppure fai clic destro sul canale e scegli Timeshift. Poi scegli dall'inizio.

Quello che parte è un pezzo dell'archivio, quindi si scorre come un film: la barra e le frecce funzionano entrambe.

Sì. Il menu del timeshift elenca i programmi passati raggruppati per giorno — doppio clic su uno per guardarlo. Puoi anche tornare indietro a passi fissi, e quei passi si adattano alla profondità reale dell'archivio del tuo provider, da trenta minuti fino a una settimana.

Alcuni provider accettano una richiesta all'archivio e servono in silenzio la diretta. L'app lo verifica e te lo dice, invece di lasciarti credere che stai guardando ieri.

Due strade:

• Il pulsante REC nel lettore, per quello che stai guardando.
• Clic destro su un canale qualsiasi → Registra, per uno che non stai guardando.

Senza una durata scelta registra finché non la fermi. Una registrazione si può guardare mentre è ancora in scrittura.

Entrambe le cose. Il menu REC propone 30 minuti, 1, 2 o 4 ore, e una registrazione programmata prende un orario di inizio e uno di fine.

Le programmazioni sopravvivono al riavvio dell'app, ma l'app deve essere in esecuzione quando scattano — è un programma, non un servizio di sistema. Registrazioni → Attive e programmate mostra cosa è in attesa.

No, se registri il canale che stai guardando: viene derivato il flusso del lettore stesso, quindi non costa nulla in più e funziona anche con i soliti account che permettono un solo flusso alla volta.

Registrare un canale diverso, o una programmazione che parte più tardi, apre invece una connessione propria verso il provider.

Una cosa da sapere sulla registrazione dal lettore: viene chiusa quando la registrazione si ferma, quindi fermare la riproduzione, cambiare canale o un errore del flusso la terminano.

Sì, su due livelli. Impostazioni → Registrazione accetta un limite di dimensione valido per tutte le registrazioni — un numero più MB, GB o TB. E il menu REC del lettore ha un limite rapido solo per la sessione in corso, da 250 MB a 10 GB.

Dove le imposti in Impostazioni → Registrazione. La sezione Registrazioni nella barra laterale le sfoglia, con le sottocartelle come categorie: creare cartelle, rinominare, spostare le cose tra una e l'altra e selezionarne più di una per cancellarle in un colpo solo.

Una finestra separata che mostra 2, 4, 6 o 9 canali in diretta insieme in una griglia, ognuno un flusso indipendente. Possono venire da playlist diverse e persino da account diversi.

Si apre dalla barra laterale; la dimensione della griglia è in Impostazioni → Multiview. Doppio clic su un riquadro per ingrandirlo.

Fai clic su un riquadro per dargli l'audio — un bordo rosso segna quello che stai sentendo.

Clic destro su uno qualsiasi per: muto, traccia audio e sottotitoli, spostarlo o scambiarlo con un altro, oppure toglierlo. Un canale con catch-up ha la sua linea temporale dell'archivio dentro il proprio riquadro, così puoi riavvolgere un canale mentre gli altri restano in diretta.

Perché è così — una per riquadro. La maggior parte degli account IPTV consente solo uno o due flussi contemporanei, quindi una griglia da nove verrà semplicemente rifiutata da quasi tutti i provider.

L'app lo dice una volta, prima che tu lo scopra da un muro di flussi che falliscono. Se vedi «limite di connessioni raggiunto», di solito il motivo è questo.

Clic destro su un canale, film o episodio → Trasmetti a Chromecast…, poi scegli il dispositivo. I canali in diretta vengono inviati come HLS, che è ciò che un ricevitore Cast si aspetta.

La trasmissione ferma la riproduzione locale — insieme sarebbero una seconda connessione verso il provider. Una fascia sopra il lettore indica il dispositivo e cosa c'è in onda, con un pulsante di stop. Riprodurre qualcosa nell'app termina anche la trasmissione e restituisce la riproduzione.

Alcuni canali sono normale video H.264 con audio Dolby Digital Plus. Un Chromecast che non sia un Ultra o un Google TV non ha il decoder per quello e rifiuta il flusso senza dire perché.

L'app converte quei casi su questo computer e serve il risultato sulla tua rete: il video viene ricopiato intatto — solo l'audio viene ricodificato, il che costa poco — e succede solo dopo che il dispositivo ha effettivamente rifiutato il flusso. Un canale che il tuo dispositivo sa riprodurre riceve sempre il flusso originale del provider, inalterato.

Serve ffmpeg, che è dentro ogni download pacchettizzato.

Impostazioni → Trakt. Crei un'applicazione su trakt.tv, incolli le due chiavi che ti dà e autorizzi nel browser che si apre.

Da lì in poi quello che guardi viene scrobblato, e la tua watchlist e la cronologia si possono sfogliare dentro l'app. Anche i tuoi file locali vengono scrobblati, quando TMDB è riuscito a identificare il file.

Sì. File locali nella barra laterale sfoglia le cartelle che aggiungi in Impostazioni → File locali.

Una condivisione di rete che il sistema ha già montato compare da sola — un montaggio SMB gvfs su Linux, una condivisione sotto /Volumes su macOS, un'unità mappata su Windows. Per l'app sono percorsi come tutti gli altri, quindi non c'è nessun client SMB al suo interno che possa comportarsi male.

Entrambe, con un selettore nella colonna centrale.

• Cartelle mostra l'albero esattamente com'è su disco.
• Libreria legge i nomi dei file e ne ricava serie con stagioni ed episodi, con i film sotto Film — la stessa forma delle sezioni del provider.

Da TMDB, per tutto ciò che si può abbinare per nome e anno. Ciò che non si abbina riceve un fotogramma preso dal video stesso, e la musica prende la copertina dai tag del file o da un'immagine di copertina nella cartella.

Su un file senza anno e senza tag di release nel nome non si tira mai a indovinare. È voluto: una locandina sbagliata è peggio di una miniatura. Rinomina il file inserendo l'anno se vuoi che venga riconosciuto.

Sì. Gli album stanno insieme, artista, album e titolo vengono dai tag, e c'è una coda di riproduzione: aggiungi un brano, accoda un'intera cartella, o metti qualcosa come prossimo. Passa al brano successivo da sola quando uno finisce.

Ci sono anche una visualizzazione e un equalizzatore a dieci bande.

È stato spostato, rinominato, oppure la sua condivisione non è montata. La cronologia dice quale dei tre, e propone di rimuovere la voce, invece di fallire in silenzio.

Se è una condivisione, montala e riprova — la voce tornerà a funzionare come prima.

Impostazioni → Interfaccia. L'interfaccia è tradotta in 27 lingue e cambia subito, senza riavviare. Arabo, persiano, ebraico e urdu ribaltano l'intero impaginato.

Nella stessa scheda ci sono cinque temi di colore e sette colori d'accento, applicati in tempo reale.

Impostazioni → Riproduzione definisce cosa deve succedere senza chiedertelo ogni volta:

• Lingua dell'audio preferita
• Sottotitoli attivi o no, con una prima e una seconda lingua preferita
• Rapporto d'aspetto e buffer di rete predefiniti
• Con quanto anticipo compare la scheda «Prossimo episodio» — mai, oppure da uno a dieci minuti

Il menu ⚙ del lettore può comunque scavalcare ognuna di queste per il flusso in corso.

Sì. Un PIN protegge le categorie bloccate e i gruppi di preferiti bloccati. Un gruppo bloccato non rivela nemmeno quali canali contiene finché il PIN non viene inserito — nasconde il contenuto, non solo la riproduzione.

Il PIN è memorizzato con sale e hash, non in chiaro.

Clic destro su un canale, un film o una serie per rinominarlo o nasconderlo. Il risultato è di fatto una tua playlist ritoccata, salvata per playlist, e Ripristina i canali predefiniti… rimette tutto esattamente come lo manda il provider.

Intere categorie si possono nascondere, rinominare o bloccare dal loro menu contestuale. I canali di una categoria nascosta restano fuori anche da «Tutti».

Aggiungi tutte le playlist che vuoi in Impostazioni → Playlist e passa dall'una all'altra con l'app aperta. Ognuna mantiene i propri preferiti, la propria cronologia, i canali nascosti e le rinomine.

Ognuna può avere anche un proprio indirizzo XMLTV e una propria pianificazione di aggiornamento — mai, all'avvio, ogni 2, 6 o 12 ore, ogni giorno o ogni settimana.

Il log è ciò che trasforma «non funziona» in qualcosa di risolvibile, e le credenziali ne vengono mascherate automaticamente: si può quindi allegare a una segnalazione senza rischi.

Avvia l'app da un terminale con DOPEIPTV_LOG_FILE impostato e ne scriverà uno lì, oltre che a schermo.

Linux — AppImage

DOPEIPTV_LOG_FILE=/tmp/dopeiptv.log ./dopeIPTV-*.AppImage

Linux — .deb o pipx

DOPEIPTV_LOG_FILE=/tmp/dopeiptv.log dopeiptv

macOS

DOPEIPTV_LOG_FILE=/tmp/dopeiptv.log \
  /Applications/dopeIPTV.app/Contents/MacOS/dopeiptv

Windows — PowerShell, nella cartella estratta

$env:DOPEIPTV_LOG_FILE="$env:TEMP\dopeiptv.log"
.\dopeiptv.exe

Riproduci il problema, chiudi l'app e allega il file. Per molti più dettagli aggiungi DOPEIPTV_LOG=debug davanti allo stesso comando.

Avviala da un terminale — la risposta qui sopra riporta il comando esatto per il tuo sistema — e leggi cosa stampa. Nella maggior parte dei casi indica la causa.

Le build pacchettizzate portano con sé tutto il necessario. Se hai installato dai sorgenti con pipx ti servono anche mpv e ffmpeg della tua distribuzione:

sudo apt install mpv ffmpeg     # Debian/Ubuntu
sudo dnf install mpv ffmpeg     # Fedora
sudo pacman -S mpv ffmpeg       # Arch

Il lettore integrato non sta ottenendo una superficie video.

1. Apri ⚙ → Stats for nerds e guarda se arrivano fotogrammi — questo separa un problema di flusso da uno di visualizzazione.
2. Su Wayland, prova Impostazioni → Riproduzione → Esegui tramite backend X11 e riavvia l'app.
3. Avvia da un terminale e cerca righe che nominano GL o mpv.

Non è ancora autenticata da Apple. Fai clic destro sull'app e scegli Apri, poi Apri nella finestra — oppure consentila in Impostazioni di Sistema → Privacy e sicurezza → Apri comunque.

Se invece macOS dice che l'app è «danneggiata», è l'attributo di quarantena messo dal download. Rimuovilo:

xattr -dr com.apple.quarantine /Applications/dopeIPTV.app

Nessuno dei due avvisi significa che l'app abbia qualcosa che non va — solo che la build non è firmata, cosa che richiede un certificato Apple a pagamento.

SmartScreen non riconosce l'autore perché la build non è firmata — servirebbe un certificato a pagamento. Fai clic su Ulteriori informazioni e poi su Esegui comunque.

Un falso positivo. Due delle sue cause sono state risolte nella 1.2.10: l'avviatore ora viene compilato dai sorgenti invece di essere il binario predefinito di cui gli antivirus hanno le firme, e l'eseguibile porta una vera risorsa di versione.

Se il tuo motore lo segnala ancora, consenti la cartella nell'antivirus e segnala il falso positivo a Microsoft — è ciò che alla fine lo risolve per tutti, non solo per te.

L'app interroga il provider e ti dice il perché in parole chiare invece di mostrare un errore nudo: account scaduto, limite di connessioni raggiunto, flusso assente, server irraggiungibile e così via.

Se gli altri canali partono, è quel canale. Se non parte nulla, controlla Impostazioni → Playlist — il pannello dell'account mostra la data di scadenza e quante connessioni consente.

Il tuo account consente un certo numero di flussi contemporanei e sono tutti occupati. In ordine di probabilità:

1. Il multiview è aperto — ogni riquadro è una connessione.
2. È in corso la registrazione di un canale diverso.
3. Un altro dispositivo o un'altra persona sta usando l'account.
4. Una sessione precedente non è ancora scaduta presso il provider; aspettare un minuto spesso basta.

Registrare il canale che stai guardando non conta come seconda connessione.

Su Wayland, GNOME e KDE prendono l'icona di una finestra da una voce desktop corrispondente e ignorano quella che il programma imposta da sé. Un AppImage non ha una voce del genere finché qualcosa non la installa.

1. L'app propone di aggiungerne una al primo avvio. Accetta — e poi riavvia l'app, perché la finestra aperta conserva l'icona con cui è partita.
2. Lo stesso interruttore è in Impostazioni → Riproduzione se avevi rifiutato.
3. Se l'icona ancora non compare, la sta coprendo una cache delle icone vecchia. GTK legge quel file invece della cartella:

rm ~/.local/share/icons/hicolor/icon-theme.cache

Se hai installato dal .deb, la voce c'è già e niente di tutto questo si applica.

Quella voce avvia un mpv o un vlc autonomo del tuo sistema, quindi uno dei due deve essere installato — il lettore integrato non ha bisogno di nient'altro e non è coinvolto.

sudo apt install mpv vlc        # Debian/Ubuntu
sudo dnf install mpv vlc        # Fedora
sudo pacman -S mpv vlc          # Arch