Konwertuj M3U na XML

Niektóre odtwarzacze multimedialne, klienci IPTV i systemy katalogowania akceptują playlisty XML, ale nie pliki M3U eksportowane przez VLC, foobar2000 lub inne menedżery playlist. Konwersja jest również przydatna, gdy metadane playlisty muszą zostać edytowane, zarchiwizowane lub zaimportowane do oprogramowania wymagającego określonego schematu XML.

Czym jest format M3U

M3U to format playlisty w postaci zwykłego tekstu, zawierający ścieżki lokalne, ścieżki względne, udziały sieciowe lub adresy URL transmisji strumieniowych. Podstawowy plik zawiera jedną lokalizację multimediów w każdym wierszu; rozszerzona playlista zaczyna się od #EXTM3U i zwykle umieszcza wiersz #EXTINF przed każdą lokalizacją, aby określić czas trwania i tytuł wyświetlany użytkownikowi.

VLC, Winamp, foobar2000, Kodi, klienci IPTV i narzędzia bibliotek multimediów często tworzą lub odczytują pliki M3U. .m3u8 korzysta z tej samej ogólnej składni playlisty i kodowania tekstu UTF-8. M3U przechowuje odwołania i opcjonalne metadane; nie zawiera ani nie konwertuje samego dźwięku lub obrazu.

Czym jest format XML

XML przechowuje dane hierarchiczne za pomocą nazwanych elementów, atrybutów, tekstu, reguł kodowania znaków specjalnych i opcjonalnych przestrzeni nazw. Jego uporządkowane pola ułatwiają sprawdzanie poprawności, edytowanie, archiwizowanie lub importowanie rekordów playlist do baz danych i systemów katalogowania.

XML nie ma uniwersalnej struktury playlisty. Jedna aplikacja może wymagać <track uri="...">, podczas gdy inna oczekuje elementów takich jak <media>, <location> oraz określonej przestrzeni nazw. Plik może więc być poprawnym plikiem XML, a mimo to być nieprzydatny dla programu docelowego.

Konwersja za pomocą skryptu Python

Aby przeprowadzać powtarzalną konwersję, użyj Python 3 i dostosuj nazwy wyjściowe do schematu aplikacji odbierającej dane. Zapisz poniższy kod jako m3u_to_xml.py w Notepad++, VS Code lub innym edytorze zwykłego tekstu:

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)

Uruchom go z terminala w folderze zawierającym skrypt:

python m3u_to_xml.py playlist.m3u playlist.xml

Użyj python3 zamiast python w systemach skonfigurowanych z użyciem tego polecenia. Skrypt tworzy XML w postaci <playlist>, zawierający <track uri="..." duration="..."> oraz opcjonalny element <title>. Zmień playlist, track, uri, duration i title na dokładne nazwy wymagane przez specyfikację programu docelowego.

Przed zaimportowaniem porównaj element główny, elementy podrzędne, atrybuty, przestrzenie nazw i wymagane pola danych wyjściowych z dokumentacją aplikacji docelowej. Nie wklejaj tekstu M3U do nowego pliku i nie zmieniaj jego nazwy; zmiana rozszerzenia nie tworzy XML, a surowe wiersze M3U nie stanowią poprawnej struktury XML.

Użycie odtwarzacza multimedialnego lub usługi online

VLC może zapisywać playlisty za pomocą polecenia Media → Save Playlist to File. Dane wyjściowe playlisty XML to zazwyczaj XSPF, czyli format playlisty oparty na XML, a nie dowolny XML zgodny ze schematem właściwym dla konkretnego programu. Używaj XSPF tylko wtedy, gdy aplikacja odbierająca dane wyraźnie go obsługuje.

W przypadku małej, niezawierającej poufnych danych playlisty sprawdź renomowane usługi, takie jak Zamzar lub Convertio, i potwierdź, że ich aktualny selektor formatów zawiera M3U jako format wejściowy, a XML jako format wyjściowy. Usługi te mogą jedynie zmienić nazwę pliku lub wygenerować ogólny wynik i nie są w stanie odtworzyć prywatnego schematu XML aplikacji. Nie przesyłaj playlist zawierających poufne ścieżki lokalne, adresy URL wymagające uwierzytelniania, prywatne adresy sieciowe ani tokeny transmisji.

Edytor tekstu, taki jak Notepad++, nadaje się do sprawdzania i ręcznego edytowania wyniku, gdy wymagany schemat XML jest znany, ale nie jest automatycznym konwerterem. W przypadku powtarzających się konwersji lub niestandardowych metadanych IPTV skrypt albo dedykowany importer są bardziej niezawodne niż ręczna edycja.

Ograniczenia jakości i zgodności

Konwersja zachowuje lokalizacje i tylko te metadane, które zostały jawnie odwzorowane przez konwerter. Dyrektywy takie jak #EXTVLCOPT, #KODIPROP, atrybuty grup IPTV, logotypy, kodeki i niestandardowe znaczniki są odrzucane przez przykładowy skrypt, chyba że zostanie zaimplementowane dodatkowe przetwarzanie.

W przypadku tytułów zawierających znaki spoza ASCII używaj danych wyjściowych w UTF-8. Biblioteka XML koduje znaki takie jak &, < i > w tekście elementów i atrybutach, ale niepoprawne kodowanie źródłowe może nadal powodować zastępowanie znaków. Ścieżki względne pozostają względne względem lokalizacji playlisty; przechowuj plik XML w oczekiwanym folderze lub zmodyfikuj skrypt tak, aby rozwiązywał je do ścieżek bezwzględnych. Adresy URL i ścieżki pozostają odwołaniami, więc konwersja nie sprawdza, czy multimedia są dostępne.