Converti M3U in XML

Alcuni lettori multimediali, client IPTV e sistemi di catalogazione accettano playlist XML, ma non i file M3U esportati da VLC, foobar2000 o altri gestori di playlist. La conversione è utile anche quando i metadati della playlist devono essere modificati, archiviati o importati in software che richiede uno schema XML definito.

Che cos'è il formato M3U

M3U è un formato di playlist in testo semplice che contiene percorsi locali, percorsi relativi, condivisioni di rete o URL di streaming. Un file di base contiene una posizione multimediale per riga; una playlist estesa inizia con #EXTM3U e generalmente inserisce una riga #EXTINF prima di ogni posizione per specificare la durata e il titolo visualizzato.

VLC, Winamp, foobar2000, Kodi, i client IPTV e gli strumenti per librerie multimediali creano o leggono comunemente file M3U. .m3u8 utilizza la stessa sintassi generale delle playlist con codifica del testo UTF-8. M3U memorizza riferimenti e metadati facoltativi; non contiene né converte direttamente l'audio o il video.

Che cos'è il formato XML

XML memorizza dati gerarchici con elementi denominati, attributi, testo, regole di escaping e namespace facoltativi. I suoi campi strutturati rendono i record delle playlist più facili da convalidare, modificare, archiviare o importare in database e sistemi di catalogazione.

XML non dispone di una struttura universale per le playlist. Un'applicazione potrebbe richiedere <track uri="...">, mentre un'altra potrebbe aspettarsi elementi come <media>, <location> e uno specifico namespace. Pertanto, un file può essere XML valido e risultare comunque inutilizzabile dal programma di destinazione.

Convertire con uno script Python

Per una conversione ripetibile, utilizza Python 3 e adatta i nomi dell'output allo schema dell'applicazione ricevente. Salva quanto segue come m3u_to_xml.py in Notepad++, VS Code o un altro editor di testo semplice:

from pathlib import Path
import sys
import xml.etree.ElementTree as ET

source = Path(sys.argv[1])
destination = Path(sys.argv[2])
root = ET.Element('playlist')
duration = None
title = None

for raw_line in source.read_text(encoding='utf-8-sig', errors='replace').splitlines():
    line = raw_line.strip()
    if not line or line == '#EXTM3U':
        continue
    if line.startswith('#EXTINF:'):
        value = line[8:]
        fields = value.split(',', 1)
        duration = fields[0].strip()
        title = fields[1].strip() if len(fields) == 2 else ''
    elif not line.startswith('#'):
        track = ET.SubElement(root, 'track', {'uri': line})
        if duration not in (None, ''):
            track.set('duration', duration)
        if title:
            ET.SubElement(track, 'title').text = title
        duration = None
        title = None

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

Eseguilo da un terminale nella cartella che contiene lo script:

python m3u_to_xml.py playlist.m3u playlist.xml

Utilizza python3 invece di python nei sistemi configurati con quel comando. Lo script crea XML come <playlist> contenente <track uri="..." duration="..."> e un elemento <title> facoltativo. Modifica playlist, track, uri, duration e title con i nomi esatti richiesti dalle specifiche di destinazione.

Prima dell'importazione, confronta l'elemento radice dell'output, gli elementi figlio, gli attributi, i namespace e i campi obbligatori con la documentazione dell'applicazione di destinazione. Non incollare il testo M3U in un nuovo file e rinominarlo; cambiare l'estensione non crea XML e le righe M3U non elaborate non costituiscono una struttura XML valida.

Utilizzare un lettore multimediale o un servizio online

VLC può salvare le playlist tramite Media → Save Playlist to File. Il suo output per le playlist XML è generalmente XSPF, un formato di playlist basato su XML, anziché un XML arbitrario compatibile con lo schema specifico di un programma. Utilizza XSPF solo quando l'applicazione ricevente lo supporta esplicitamente.

Per una playlist di piccole dimensioni e non sensibile, consulta servizi affidabili come Zamzar o Convertio e verifica che il selettore di formato attuale elenchi M3U come input e XML come output. Questi servizi potrebbero limitarsi a rinominare il file o produrre un risultato generico e non possono dedurre lo schema XML privato di un'applicazione. Non caricare playlist contenenti percorsi locali riservati, URL autenticati, indirizzi di rete privati o token di streaming.

Un editor di testo come Notepad++ è adatto per esaminare e modificare manualmente il risultato quando lo schema XML richiesto è noto, ma non è un convertitore automatico. Per conversioni ripetute o metadati IPTV personalizzati, uno script o un importer dedicato è più affidabile della modifica manuale.

Limiti di qualità e compatibilità

La conversione conserva le posizioni e solo i metadati mappati esplicitamente dal convertitore. Direttive come #EXTVLCOPT, #KODIPROP, attributi dei gruppi IPTV, loghi, codec e tag personalizzati vengono scartati dallo script di esempio, a meno che non venga implementato un parsing aggiuntivo.

Utilizza l'output UTF-8 per i titoli non ASCII. La libreria XML esegue l'escaping di caratteri come &, < e > nel testo degli elementi e negli attributi, ma una codifica del testo sorgente non valida potrebbe comunque sostituire alcuni caratteri. I percorsi relativi rimangono relativi alla posizione della playlist; conserva il file XML nella directory prevista oppure modifica lo script per risolverli in percorsi assoluti. URL e percorsi rimangono riferimenti, quindi la conversione non verifica se il contenuto multimediale è raggiungibile.