Converter XML para M3U8

Um media player, aplicativo IPTV ou dispositivo de streaming pode exigir uma playlist M3U8 quando sua lista de canais ou mídias está armazenada como XML. A conversão funciona somente se o XML contiver URLs de mídia utilizáveis; apenas metadados de programas ou nomes de canais não podem criar entradas reproduzíveis.

O que é o formato XML

XML é um formato de texto estruturado para dados hierárquicos, incluindo catálogos de canais, URLs de streams, guias eletrônicos de programação XMLTV, exportações de bibliotecas de mídia e configurações de aplicativos. Provedores de IPTV, gerenciadores de mídia, sistemas de automação e aplicativos personalizados o utilizam.

XML não possui um schema universal de playlist. Uma URL pode ser armazenada em um atributo url, em um elemento <url> ou em um elemento específico do provedor, como <stream_url>. Abra o arquivo no VS Code, Notepad++ ou em um navegador e identifique o elemento de item repetido, o campo de nome de exibição e o campo de URL antes de convertê-lo.

O que é o formato M3U8

M3U8 é uma playlist M3U codificada como UTF-8. Uma playlist estendida de canais ou arquivos normalmente contém um cabeçalho #EXTM3U, uma entrada #EXTINF e uma URL de mídia:

#EXTM3U
#EXTINF:-1,Example channel
https://example.com/live/stream.m3u8

Aplicativos IPTV usam essa estrutura para listar canais ao vivo ou arquivos sob demanda. A mesma extensão .m3u8 é usada por playlists de mídia HLS, que fazem referência a segmentos e contêm tags como #EXT-X-TARGETDURATION e #EXTINF. Portanto, uma lista de canais IPTV não é necessariamente uma playlist de segmentos HLS.

Como converter XML em M3U8

Converter uma lista de canais com Python

Para um schema não documentado ou específico de um provedor, um script local em Python é mais seguro e confiável do que enviar o arquivo para um serviço online, especialmente quando as URLs contêm tokens ou informações de assinantes.

1. Instale Python 3 a partir de python.org e coloque o arquivo XML em uma pasta de trabalho.
2. Inspecione o XML e determine o elemento de item repetido e os campos que contêm o nome do canal e a URL do stream.
3. Salve o exemplo a seguir como xml_to_m3u8.py. Ele espera itens <channel> e oferece suporte a campos comuns de nome e URL:

import xml.etree.ElementTree as ET

root = ET.parse('input.xml').getroot()

def text_value(node, attribute, element):
    return (node.get(attribute) or node.findtext(element) or '').strip()

with open('output.m3u8', 'w', encoding='utf-8', newline='\n') as out:
    out.write('#EXTM3U\n')
    for channel in root.findall('.//channel'):
        name = text_value(channel, 'name', 'name') or 'Unnamed channel'
        url = (channel.get('url') or
               channel.findtext('url') or
               channel.findtext('stream_url') or '').strip()
        if url:
            name = name.replace('\r', ' ').replace('\n', ' ')
            out.write(f'#EXTINF:-1,{name}\n{url}\n')

4. Execute python xml_to_m3u8.py no Windows, macOS ou Linux.
5. Teste output.m3u8 no VLC com Media → Open File e, em seguida, importe-o no aplicativo IPTV desejado.

Substitua .//channel e as buscas de campos quando o XML usar nomes de elementos diferentes, caminhos aninhados ou namespaces. Um arquivo XMLTV geralmente contém registros <channel id="..."> e <programme>, mas nenhuma URL de stream; ele pode fornecer metadados de programas, não uma playlist M3U8 reproduzível.

Usar XSLT para um schema documentado

Para processamento em lote repetível, o XSLT mapeia diretamente campos XML conhecidos para linhas da playlist. Saxon, XMLStarlet e as bibliotecas XML do Python podem executar a transformação. Um site genérico de conversão de arquivos não consegue inferir quais elementos específicos do provedor representam nomes, URLs, grupos ou logotipos.

Criar uma playlist HLS real com FFmpeg

Se o requisito for um stream HLS, e não uma lista IPTV de URLs existentes, use FFmpeg para gerar o arquivo M3U8 e os segmentos de mídia:

ffmpeg -i input.mp4 -c:v libx264 -c:a aac -f hls -hls_time 6 -hls_playlist_type vod output.m3u8

Isso produz output.m3u8 e arquivos de segmentos, como output0.ts; publique-os juntos no mesmo diretório. Uma URL de origem extraída pode substituir input.mp4. A opção -c copy evita a recodificação, mas somente quando os codecs e o contêiner da origem são compatíveis com os clientes HLS pretendidos. FFmpeg converte mídias identificadas pelo XML; ele não converte os metadados XML em si.

Compatibilidade e limitações

Transformar registros XML em texto M3U8 não baixa, corrige, transcodifica nem autentica a mídia referenciada. As URLs devem continuar acessíveis, e streams protegidos podem exigir cabeçalhos HTTP, cookies, tokens com expiração ou suporte a DRM que uma playlist básica não pode fornecer.

Grave o arquivo como UTF-8, mantenha cada URL em sua própria linha e remova quebras de linha dos nomes dos canais. Os aplicativos IPTV podem aceitar atributos como tvg-id, tvg-name, tvg-logo e group-title em uma linha #EXTINF, mas essas são convenções de aplicativos, não requisitos universais do M3U8.

Não existe um conversor online de XML para M3U8 confiável e independente de schema. Serviços como Convertio e CloudConvert lidam com muitas conversões gerais de documentos, mas não mapeiam de forma confiável um XML arbitrário de provedor para uma playlist reproduzível. Use um serviço online somente se ele oferecer suporte explícito ao schema XML exato e o arquivo não contiver URLs privadas, credenciais ou dados de assinantes; caso contrário, use Python, XSLT ou FFmpeg localmente.