Převod souboru M3U do XML

Některé media přehrávače, IPTV klienti a katalogizační systémy přijímají XML playlisty, ale ne soubory M3U exportované z VLC, foobar2000 nebo jiných správců playlistů. Převod je také užitečný, když je třeba upravit nebo archivovat metadata playlistu nebo je importovat do softwaru, který vyžaduje definované XML schéma.

Co je formát M3U

M3U je playlist ve formátu prostého textu, který obsahuje místní cesty, relativní cesty, síťová sdílení nebo streamingové URL adresy. Základní soubor obsahuje jedno umístění média na řádek; rozšířený playlist začíná řádkem #EXTM3U a před každé umístění běžně vkládá řádek #EXTINF, který určuje délku a zobrazovaný název.

VLC, Winamp, foobar2000, Kodi, IPTV klienti a nástroje pro správu knihoven médií běžně vytvářejí nebo načítají soubory M3U. .m3u8 používá stejnou obecnou syntaxi playlistu s kódováním textu UTF-8. M3U ukládá odkazy a volitelná metadata; samotný zvuk ani video neobsahuje a nekonvertuje.

Co je formát XML

XML ukládá hierarchická data s pojmenovanými prvky, atributy, textem, pravidly escapování a volitelnými jmennými prostory. Jeho strukturovaná pole usnadňují ověřování, úpravy, archivaci nebo import záznamů playlistu do databází a katalogizačních systémů.

XML nemá univerzální strukturu playlistu. Jedna aplikace může vyžadovat <track uri="...">, zatímco jiná očekává prvky jako <media>, <location> a konkrétní jmenný prostor. Soubor proto může být platným XML a přesto být pro cílový program nepoužitelný.

Převod pomocí skriptu Python

Pro opakovatelný převod použijte Python 3 a přizpůsobte názvy výstupních prvků schématu přijímající aplikace. Uložte následující kód jako m3u_to_xml.py v Notepad++, VS Code nebo jiném editoru prostého textu:

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)

Spusťte jej z terminálu ve složce obsahující skript:

python m3u_to_xml.py playlist.m3u playlist.xml

Na systémech nakonfigurovaných s tímto příkazem použijte místo python příkaz python3. Skript vytvoří XML jako <playlist> obsahující <track uri="..." duration="..."> a volitelný prvek <title>. Změňte playlist, track, uri, duration a title na přesné názvy vyžadované specifikací cílového programu.

Před importem porovnejte kořenový prvek výstupu, podřízené prvky, atributy, jmenné prostory a povinná pole s dokumentací cílové aplikace. Nevkládejte text M3U do nového souboru a pouze jej nepřejmenovávejte; změna přípony nevytvoří XML a nezpracované řádky M3U nepředstavují platnou strukturu XML.

Použití media přehrávače nebo online služby

VLC může ukládat playlisty prostřednictvím položky Media → Save Playlist to File. Jeho výstup playlistu XML je obecně XSPF, což je playlistový formát založený na XML, nikoli libovolné XML odpovídající schématu konkrétního programu. XSPF použijte pouze tehdy, když jej přijímající aplikace výslovně podporuje.

U malého playlistu bez citlivých údajů vyzkoušejte renomované služby, jako jsou Zamzar nebo Convertio, a ověřte, zda jejich aktuální výběr formátu uvádí M3U jako vstup a XML jako výstup. Tyto služby mohou pouze změnit název souboru nebo vytvořit obecný výsledek a nedokážou odvodit soukromé XML schéma aplikace. Nenahrávejte playlisty obsahující důvěrné místní cesty, URL adresy s ověřením, adresy soukromých sítí nebo tokeny streamů.

Textový editor, jako je Notepad++, je vhodný ke kontrole a ruční úpravě výsledku, pokud je požadované XML schéma známé, ale nejde o automatický konvertor. Pro opakované převody nebo vlastní IPTV metadata je skript či specializovaný importer spolehlivější než ruční úpravy.

Omezení kvality a kompatibility

Převod zachová umístění a pouze metadata explicitně namapovaná konvertorem. Direktivy jako #EXTVLCOPT, #KODIPROP, atributy skupin IPTV, loga, kodeky a vlastní značky ukázkový skript zahodí, pokud není implementováno další zpracování.

Pro názvy obsahující znaky mimo ASCII použijte výstup UTF-8. Knihovna XML escapuje znaky jako &, < a > v textu prvků a atributech, ale poškozené kódování zdroje může stále vést k nahrazení znaků. Relativní cesty zůstanou relativní vůči umístění playlistu; ponechte soubor XML v očekávaném adresáři nebo upravte skript tak, aby je převedl na absolutní cesty. URL adresy a cesty zůstávají odkazy, takže převod neověřuje, zda je médium dostupné.