Documentazione del bridge M3U

1. Per iniziare

M3U Bridge funge da proxy intelligente e da livello di normalizzazione tra le tue sorgenti multimediali autorizzate (codici M3U o Xtream) e le tue applicazioni di riproduzione IPTV (come TiviMate, IPTV Smarters, Apple TV o app per Android TV).

2. Aggiungi una fonte

Dalla dashboard del tuo tenant su app.m3ubridge.com, vai su Sources e fai clic su Add Source. Puoi configurare un URL di playlist M3U o un endpoint server compatibile con Xtream. Le credenziali upstream sono crittografate a riposo con AES-256-GCM.

3. Input M3U

M3U Bridge supporta le playlist M3U e M3U8 standard (inclusi i tag EXTINF, tvg-id, tvg-name, tvg-logo e group-title). Il parser gestisce playlist di grandi dimensioni, di diversi megabyte, con suddivisione in blocchi per lo streaming e sincronizzazione periodica in background.

4. Ingresso compatibile con Xtream

Se il tuo provider di streaming utilizza il protocollo Xtream Codes, inserisci l'URL di base del tuo server, il nome utente e la password. M3U Bridge sincronizza streaming live, film on demand, serie TV e categorie tramite il protocollo standard player_api.php.

5. Credenziali generate

Anziché inserire i dettagli del server upstream in ogni lettore, crea delle linee di abbonato dedicate nella tua dashboard:

• URL del server: https://live.m3ubridge.com
• Nome utente: Nome utente personalizzato generato per utente/dispositivo
• Password: Password sicura con verifica Argon2id
• Connessioni massime: Limiti di concorrenza applicati per abbonato

La dashboard mostra gli URL esatti da incollare nel player, costruiti dall'indirizzo del server sopra e dallo username/password generati per ciascuna linea di abbonato:

• player_api.php — Endpoint di autenticazione e API Xtream Codes usato dalle app compatibili Xtream (ad es. TiviMate, IPTV Smarters) per elencare streaming live, VOD, serie e categorie.
• get.php — Endpoint della playlist M3U per i player che supportano solo il formato classico M3U/M3U8 invece dell'API Xtream.
• xmltv.php — Endpoint della guida programmi elettronica XMLTV (EPG), abbinato e normalizzato automaticamente da M3U Bridge.

6. Corrispondenza EPG

M3U Bridge abbina automaticamente i canali compatibili con le fonti di dati EPG disponibili, sia con licenza che fornite dal cliente, per risolvere i problemi relativi agli identificatori della guida programmi mancanti o incoerenti. Il motore di normalizzazione supporta palinsesti gestiti, input XMLTV del cliente e futuri fornitori di guide.

7. Arricchimento dei metadati

I titoli di film e serie TV vengono confrontati con The Movie Database (TMDB) per recuperare locandine ad alta risoluzione, sfondi, sinossi, anni di uscita, cast ed elenchi di episodi, senza esporre la tua infrastruttura privata.

8. Modalità gateway

M3U Bridge supporta sia la modalità di reindirizzamento diretto che la modalità di inoltro tecnico protetto, a seconda dei vincoli di sicurezza del server a monte e dei requisiti di protezione delle credenziali. In modalità protetta, il traffico di rete viene temporaneamente inoltrato per proteggere le credenziali a monte e mantenere la connettività.

La capacità del Protected Relay e le quote di traffico sono definite separatamente dai limiti di account e di utente e potrebbero subire variazioni durante la fase di accesso anticipato.

9. Domande frequenti