Converti M3U8 in XML

Un catalogo multimediale, un dispositivo o un’applicazione di editing può richiedere una playlist XML anziché un manifest HLS. La conversione della playlist può inoltre rendere le voci più facili da archiviare, esaminare o modificare, ma la struttura XML richiesta è determinata dall’applicazione ricevente.

Cos’è il formato M3U8

M3U8 è una variante codificata in UTF-8 del formato playlist M3U, utilizzata principalmente per HTTP Live Streaming (HLS). È un manifest in testo semplice contenente direttive come #EXTINF, URL dei segmenti multimediali, URL degli stream variant, dettagli sulla crittografia, codec, sottotitoli e impostazioni dello stream.

I server di streaming, gli strumenti Apple HLS, FFmpeg, VLC, i sistemi IPTV, i servizi video basati su browser e le applicazioni di registrazione utilizzano file M3U8. Un manifest HLS normalmente fa riferimento a numerosi segmenti .ts o MP4 frammentati; non contiene il video stesso.

Cosa offre XML

XML memorizza dati gerarchici e denominati in un formato che le applicazioni possono analizzare, modificare, associare a namespace e convalidare rispetto a uno schema XSD. Viene utilizzato per configurazione, cataloghi, metadati, RSS e formati playlist come XSPF.

XML non dispone di un vocabolario universale per le playlist. Un’applicazione può richiedere <track> e <location>, un’altra può richiedere uno schema specifico per IPTV e un’altra ancora può accettare XSPF. Un file può essere XML ben formato e risultare comunque inutilizzabile se i relativi elementi, attributi, namespace o l’ordine non corrispondono allo schema di destinazione.

Convertire in XML con VLC

Per una playlist che VLC è in grado di leggere, salvarla come XSPF, un formato playlist basato su XML:

1. Aprire VLC e caricare M3U8 tramite Media → Open File, oppure aggiungerlo alla playlist.
2. Aprire la playlist con View → Playlist.
3. Scegliere Media → Save Playlist to File.
4. Selezionare XSPF playlist, se VLC presenta una scelta del formato, e salvare con un’estensione .xspf.

XSPF non è una conversione XML generica. Può preservare le posizioni riproducibili e i metadati di base delle tracce, eliminando però le direttive specifiche di HLS, le relazioni tra segmenti, i dati di crittografia e le informazioni sugli stream variant. Rinominare l’estensione solo se il programma ricevente accetta esplicitamente contenuti XSPF con estensione .xml.

Creare un file XML strutturato locale

Per una rappresentazione semplice e indipendente dall’applicazione, utilizzare la libreria standard di Python. Questa conserva le direttive come testo e associa ogni URI a un elemento track con la durata e il titolo di eventuali #EXTINF precedenti:

import sys
import xml.etree.ElementTree as ET

source, destination = sys.argv[1], sys.argv[2]
root = ET.Element('playlist', {'source': source})
pending = None

with open(source, encoding='utf-8-sig') as stream:
    for raw in stream:
        line = raw.strip()
        if not line:
            continue
        if line.startswith('#EXTINF:'):
            value = line[len('#EXTINF:'):]
            duration, title = value.split(',', 1) if ',' in value else (value, '')
            pending = (duration, title)
        elif line.startswith('#'):
            directive = ET.SubElement(root, 'directive')
            directive.text = line
        else:
            track = ET.SubElement(root, 'track')
            if pending is not None:
                duration, title = pending
                track.set('duration', duration)
                if title:
                    ET.SubElement(track, 'title').text = title
                pending = None
            ET.SubElement(track, 'uri').text = line

ET.indent(root, space='  ')
ET.ElementTree(root).write(destination, encoding='utf-8', xml_declaration=True)

Eseguirlo con:

python m3u8_to_xml.py input.m3u8 output.xml

Questo crea XML ben formato utilizzando un vocabolario personalizzato con playlist, track, title, uri e directive. Non è automaticamente compatibile con VLC, con il software IPTV o con un’altra applicazione. Rinominare gli elementi e gli attributi in modo che corrispondano alla documentazione o all’XSD del destinatario. ET.indent richiede Python 3.9 o versioni successive; omettere quella riga nelle versioni precedenti.

Convertire per uno schema XML specifico

Ottenere un file XML di esempio o un XSD dall’applicazione di destinazione prima della conversione. Associare la durata e il titolo di #EXTINF ai campi corrispondenti dello schema, associare ogni URI successivo all’elemento URL o location richiesto e decidere come rappresentare direttive, varianti, sottotitoli, chiavi ed elenchi di segmenti. Oxygen XML Editor o un altro editor XML compatibile con gli schemi può convalidare il risultato rispetto a un XSD, ma nessun editor può dedurre automaticamente uno schema playlist sconosciuto.

Conversione online e limiti di compatibilità

Non esiste un servizio universale e affidabile per la conversione da M3U8 a XML con un solo clic, poiché il vocabolario XML di destinazione non è definito. Un convertitore online è adatto solo quando indica lo schema di output esatto richiesto dal programma ricevente; caricare un manifest locale non sensibile, scaricare il risultato e convalidarlo prima dell’uso. Non inviare a un servizio online URL di streaming privati, a pagamento, con token o temporanei. Uno script Python locale o un editor XML desktop è più sicuro per questi file.

Gli URL relativi rimangono relativi dopo la conversione e devono essere risolti rispetto alla posizione del manifest originale. La conversione del manifest non scarica, decritta, unisce o ricodifica i media a cui fa riferimento. Le playlist variant, le chiavi di crittografia, gli intervalli di byte, le sezioni di inizializzazione, i codec, i sottotitoli e le relazioni tra segmenti multimediali possono andare persi, a meno che lo schema di destinazione non disponga di campi per rappresentarli.