Skip to content

mccoy88f/OMG-Premium-TV

Repository files navigation

📺 OMG Premium TV per Stremio

🇮🇹 Leggi in italiano - 🇬🇧 Read in English - 🇫🇷 Lire en Français - 🇪🇸 Leer en español

Screenshot 2025-02-28 alle 21 36 52

👋 Introduzione

Benvenuto in OMG Premium TV, l'addon per Stremio che ti permette di guardare i tuoi canali TV e IPTV preferiti da playlist M3U/M3U8, arricchiti con informazioni sui programmi (EPG). Questa guida ti aiuterà a sfruttare al meglio tutte le funzionalità disponibili.

⚠️ Leggi con attenzione!

Lavorare a questo addon, tenerlo aggiornato è costato tantissime ore e tantissimo impegno ❤️ Un caffè ☕ o una birra sono 🍺 un gesto di riconoscenza molto apprezzato e mi aiutano a continuare e a mantenere attivo questo progetto!

Con una donazione verrai inserito in un gruppo telegram dedicato dove riceverai in anteprima le nuove versioni! Ti aspetto!

Puoi anche offrirmi una birra con PayPal 🍻

🔄 Changelog di OMG Premium TV

🚀 Versione 7.0.0 (Attuale)

✨ Nuove funzionalità

  • 🔒 Protezione password della home: Opzione nella web UI per proteggere l’accesso alla pagina di configurazione con una password. Se attivata, chi apre la home (o il link «Configura» da Stremio) deve inserire la password; l’uso dell’addon da Stremio non richiede password.
  • 🔄 Sessioni e cache isolate: La cache è isolata automaticamente per configurazione (stessa config = stessa cache). EPG, Resolver Python e Generatore playlist sono anch'essi per sessione. Più utenti o configurazioni diverse possono usare il server contemporaneamente senza sovrascrivere i dati.
  • 🆔 ID Sessione: In home/config viene mostrato l'ID Sessione (derivato dalla configurazione) quando generi una configurazione. L'ID è incluso anche nel backup (export) e viene aggiornato in fase di ripristino (import).
  • ⏰ Scadenza sessioni (24h): Se una sessione non riceve richieste per 24 ore, scade automaticamente: tutta la cache di quella sessione (cache M3U, EPG, resolver, generatore) viene eliminata. Alla successiva richiesta con la stessa config la sessione viene ricreata e i dati ripopolati dagli URL.

🔧 Miglioramenti

  • 🌐 UI in 4 lingue: L'interfaccia web è disponibile in italiano, inglese, spagnolo e francese; si può cambiare lingua dalla barra in alto a destra.
  • 📋 Liste predefinite (opzionale): In pagina di configurazione, una sezione permette di aggiungere in un clic le playlist e gli EPG predefiniti di iptv-org e iptv-epg.org per nazione (campi M3U e EPG).
  • ⚙️ Sezione Impostazioni: Nel catalogo è presente un filtro per genere ⚙️ (impostazioni) che raggruppa i canali utility: Refresh M3U playlist, Refresh EPG e Rigenera Playlist Python. Descrizioni e messaggi in inglese.
  • 🔄 Pseudo-canali: Aprendo un canale dalla sezione ⚙️ si esegue l’azione (ricarica playlist, aggiornamento EPG o rigenerazione Python) e si mostra un messaggio di esito; nessun flusso video reale.
  • ♻️ Cache al riavvio: Se la cache è vuota (es. dopo riavvio Docker), la playlist e l’EPG vengono ricostruite automaticamente alla prima richiesta con URL M3U/EPG configurati.
  • 📺 EPG e ID canali: Migliorato l’abbinamento EPG per canali con suffisso (es. canale5.it / canale5).
  • 🔒 UI protezione home: Con protezione attiva si vede la spunta e il pulsante «Modifica password»; i campi password e conferma compaiono solo cliccando «Modifica password».
  • 🔗 Ritorno dopo login: Dopo aver inserito la password sul gate si viene reindirizzati alla pagina da cui si era partiti (es. pagina di configurazione con URL codificato).

🚀 Versione 6.0.0

📢 Rebrand del nome

  • 📜 OMG+ diventa OMG Premium: Nuovo nome per differenziare e valorizzare tutte le nuove funzioni disponibili. OMG TV rimane come versione base con canali preimpostati. Non verrà più aggiornata.

✨ Nuove funzionalità

  • 🐍 Resolver Python: Sistema completo per risolvere URL di streaming tramite script Python personalizzabili
  • 🔄 Canale di rigenerazione: Nuovo canale nella categoria SETTINGS per rigenerare la playlist senza accedere al pannello web
  • 🛠️ Backup e ripristino: Sistema per salvare e ripristinare la configurazione completa
  • 🔧 Template resolver: Funzionalità per creare automaticamente template di script resolver personalizzabili
  • 👤 User-Agent avanzato: Gestione migliorata degli header User-Agent, Referer e Origin
  • 🧩 Moduli Python: Supporto integrato per request e altri moduli Python per script avanzati

🔧 Miglioramenti

  • 🐳 Supporto Docker migliorato: Configurazioni ottimizzate per Hugging Face e Portainer
  • ♻️ Cache intelligente: Sistema di cache completamente ridisegnato con performance migliorate
  • 🔄 Aggiornamento pianificato: Controllo preciso dell'intervallo di aggiornamento in formato HH:MM
  • 📋 Interfaccia web rinnovata: Pannello di configurazione più intuitivo e ricco di funzionalità
  • ⚡ Streaming ottimizzato: Miglior gestione del fallback tra proxy e stream diretti
  • 🛡️ Gestione errori robusta: Sistema migliorato di gestione errori e tentativi multipli

🐛 Correzioni

  • 🔄 Risolto il loop infinito: Corretto il problema del loop infinito con resolver e proxy attivi
  • 🔌 Migliorata compatibilità: Risolti problemi di compatibilità con diverse tipologie di playlist
  • 🧰 Fix header HTTP: Corretta la gestione degli header HTTP personalizzati
  • 🔍 Fix ricerca canali: Migliorata la ricerca dei canali per corrispondenza parziale
  • 📊 Ottimizzazione EPG: Risolti problemi con EPG di grandi dimensioni

📝 Note di aggiornamento

  • Le configurazioni precedenti NON compatibili rispetto alle installazioni di OMG TV e OMG+ TV.
  • Si consiglia di eseguire una nuova installazione da zero su Hugging Face o su VPS (consiglio Portainer)
  • Per sfruttare le funzionalità del resolver Python, è necessario configurarlo nella sezione avanzata

Per dettagli completi sul funzionamento delle nuove funzionalità, consulta il manuale utente aggiornato.

🚀 Iniziamo: Installazione

🐳 Deploy su DOCKER

  • Per poter procedere devi prima fare l'installazione tramite docker su Hugging Face o su VPS.
  • Segui la guida qui e poi ritorna a questa pagina una volta disponibile il sito web del tuo addon.
  • Se tutte queste cose ti sembrano incomprensibili FERMATI; cerca una guida on line su docker, guarda la sezione supporto in basso a questa pagina o chiedi aiuto ad un AI 😊

📲 Installazione dell'addon

  1. Apri la pagina web di configurazione OMG Premium TV
  2. Configura l'addon secondo le tue esigenze
  3. Clicca sul pulsante INSTALLA SU STREMIO 🔘
  4. Stremio si aprirà automaticamente e ti chiederà di confermare l'installazione
  5. Clicca su Installa

⚙️ Configurazione di base

📋 Configurazione della playlist

  • URL M3U 📋: Inserisci l'URL della tua playlist M3U/M3U8
    • Esempio singolo: http://example.com/playlist.m3u
    • Esempio multiplo: http://example.com/playlist1.m3u,http://example.com/playlist2.m3u
    • 💡 Novità: Puoi inserire più URL M3U separandoli con una virgola (,) per combinare più playlist

📊 Configurazione EPG

  • URL EPG 📊: Inserisci l'URL del file EPG (guida elettronica dei programmi)
    • Esempio singolo: http://example.com/epg.xml o http://example.com/epg.xml.gz
    • Esempio multiplo: http://example.com/epg1.xml,http://example.com/epg2.xml
    • 💡 Novità: Puoi inserire più URL EPG separandoli con una virgola (,) per combinare più guide programmi
  • Abilita EPG ✅: Spunta questa casella per visualizzare le informazioni sui programmi

🔍 Utilizzo dell'addon

📱 Navigazione nel catalogo

  1. Apri Stremio
  2. Vai alla sezione Scopri 🔍
  3. Seleziona Canali TV e poi OMG Premium TV dalla lista degli addon
  4. Vedrai la lista completa dei canali disponibili

🎯 Filtraggio dei canali

  • Per genere 🏷️: Seleziona un genere dal menu a discesa per filtrare i canali
  • Ricerca 🔍: Usa la funzione di ricerca per trovare canali specifici per nome

🎬 Visualizzazione dei dettagli del canale

Clicca su un canale per vedere:

  • 📋 Informazioni sul canale
  • 📺 Programma attualmente in onda (se EPG abilitato)
  • 🕒 Prossimi programmi (se EPG abilitato)
  • 🏷️ Categorie del canale

▶️ Riproduzione di un canale

  • Clicca sul canale e poi sul pulsante WATCH ▶️
  • Scegli tra le opzioni di stream disponibili:
    • 📺 Stream Originale: Lo stream standard dalla playlist
    • 🌐 Stream Proxy: Lo stream attraverso un proxy (maggiore compatibilità)
    • 🧩 Stream Risolto: Lo stream elaborato da uno script resolver (per canali speciali)

🛠️ Impostazioni avanzate

🔒 Proteggi accesso alla home

  • Abilita protezione con password ✅: Se attivi questa opzione, alla prossima visita alla pagina di configurazione (home o link «Configura» da Stremio) sarà richiesta la password. L’addon in Stremio continua a funzionare senza password.
  • Modifica password: Quando la protezione è attiva vedi «Protezione attiva» e il pulsante Modifica password; cliccandolo compaiono i campi per cambiare la password. Per disattivare la protezione togli la spunta e salva (senza inserire password).
  • La password si imposta e si modifica solo dalla web UI; non è richiesta per guardare i canali da Stremio.

🌐 Configurazione proxy

  • Proxy URL 🔗: URL del proxy per gli stream (è compatibile solo con MediaFlow Proxy)
  • Password Proxy 🔑: Password per l'autenticazione del proxy
  • Forza Proxy ✅: Obbliga tutti gli stream ad utilizzare il proxy

🆔 Gestione ID e aggiornamenti

  • ID Suffix 🏷️: Aggiunge un suffisso agli ID dei canali senza id nella playlist (es. .it)
  • Percorso file remapper 📝: Specifica un file per la rimappatura degli ID EPG
  • Intervallo Aggiornamento ⏱️: Specifica quanto spesso aggiornare la playlist (formato HH:MM)

🐍 Funzionalità Python avanzate

🔄 Generazione playlist con script Python

  1. URL dello Script Python 🔗: Inserisci l'URL dello script Python
  2. SCARICA SCRIPT 💾: Scarica lo script sul server
  3. ESEGUI SCRIPT ▶️: Esegui lo script per generare la playlist
  4. USA QUESTA PLAYLIST ✅: Utilizza la playlist generata come sorgente

⏱️ Aggiornamento automatico

  • Inserisci l'intervallo desiderato (es. 12:00 per 12 ore)
  • Clicca su PIANIFICA 📅 per attivare gli aggiornamenti automatici
  • Clicca su FERMA ⏹️ per disattivare gli aggiornamenti

🧩 Configurazione Resolver Python

  • URL Script Resolver 🔗: Inserisci l'URL dello script resolver
  • Abilita Resolver Python ✅: Attiva l'utilizzo del resolver
  • SCARICA SCRIPT 💾: Scarica lo script resolver
  • CREA TEMPLATE 📋: Crea un template di script resolver da personalizzare
  • VERIFICA SCRIPT ✅: Controlla che lo script resolver funzioni correttamente
  • PULISCI CACHE 🧹: Svuota la cache del resolver

💾 Backup e ripristino

📤 Backup configurazione

  1. Clicca su BACKUP CONFIGURAZIONE 💾
  2. Un file JSON verrà scaricato con tutte le tue impostazioni (incluso l'ID Sessione della config corrente)

📥 Ripristino configurazione

  1. Clicca su RIPRISTINA CONFIGURAZIONE 📤
  2. Seleziona il file JSON precedentemente salvato
  3. Attendi il completamento del ripristino (l'ID Sessione in pagina si aggiorna in base alla config ripristinata)

❓ Risoluzione problemi

⚠️ Stream non funzionanti

  • Prova ad attivare l'opzione Forza Proxy
  • Verifica che l'URL della playlist sia corretto
  • Prova a utilizzare uno script resolver Python per canali problematici

📊 Problemi con EPG

  • Verifica che l'URL dell'EPG sia corretto
  • Controlla che l'opzione Abilita EPG ✅ sia attivata
  • Assicurati che gli ID dei canali corrispondano tra playlist ed EPG

🐍 Problemi con script Python

  • Controlla che Python sia installato sul server dell'addon
  • Verifica lo stato dello script nella sezione Stato Script Python
  • Prova a scaricare nuovamente lo script

🔄 Aggiornamenti e manutenzione

🔄 Modifica delle impostazioni

  • In Stremio, vai su Impostazioni ⚙️ > Addon
  • Clicca su Configura 🔄 accanto a OMG Premium TV
  • Accedi alla pagina di configurazione, fai le modifiche che ti interessano
  • Premi su Genera Configurazione
  • Onde evitare un doppione rimuovi l'addon su Stremio
  • Torna alla pagina di configurazione e clicca Installa su Stremio

🔧 Rigenerazione playlist e aggiornamenti rapidi

  • Nella sezione ⚙️ (filtro per genere in catalogo) trovi: Refresh M3U playlist (ricarica dalla sorgente), Refresh EPG (aggiorna la guida programmi), Rigenera Playlist Python (esegue lo script e ricarica la playlist). Apri il canale e segui il messaggio a schermo.

📋 Riepilogo delle funzionalità principali

  • ✅ Supporto playlist M3U/M3U8
  • ✅ Supporto guide programmi EPG (XMLTV)
  • ✅ Filtri per genere e ricerca
  • ✅ Proxy per maggiore compatibilità
  • ✅ Resolver Python per stream speciali
  • ✅ Generazione playlist personalizzate
  • ✅ Aggiornamenti automatici
  • ✅ Backup e ripristino configurazione
  • ✅ Protezione password della pagina di configurazione (opzionale)
  • ✅ Cache isolata per configurazione (accessi simultanei)
  • ✅ ID Sessione visibile e incluso in export/import
  • ✅ Scadenza automatica sessioni inattive (24h) per liberare spazio
  • Specifiche tecniche nel wiki

📱 Compatibilità

OMG PremTV funziona su tutte le piattaforme supportate da Stremio:

  • 💻 Windows
  • 🍎 macOS
  • 🐧 Linux
  • 📱 Android
  • 📱 iOS (tramite browser web)
  • 📺 Android TV
  • 📺 Apple TV

👥 Community

👏 Ringraziamenti

  • FuriousCat per l'idea del nome OMG
  • Team di Stremio Italia
  • Comunità Telegram (vedi sezione Community)
  • Iconic Panda per l'icona
  • Video di Background del frontend e per i flussi dummy creato da igor.h (su Vecteezy)

📜 Licenza

Progetto rilasciato sotto licenza MIT.


📚 Nota importante: OMG Premium TV è progettato per accedere a contenuti legali. Nell'addon non sono inclusi canali o flussi. Assicurati di rispettare la normativa del tuo paese riguardo lo streaming di contenuti.

🌟 Grazie per aver scelto OMG Premium TV! Goditi la visione! 🌟

About

OMG Premium TV (Stremio Addon)

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors