M3U, M3U8 e W3U: o que é cada uma e quando usar qual

4 min de leitura

Ao organizar seus vídeos, você vai encontrar três extensões muito parecidas: .m3u, .m3u8 e .w3u. As duas primeiras são quase a mesma coisa; a terceira é outra forma de escrever uma lista, mais completa. Veja o que é cada uma, em que elas diferem e qual é a melhor para você.

M3U: a lista de sempre

A M3U nasceu no fim dos anos 1990 como formato de playlists de música: um arquivo de texto com um caminho ou um endereço por linha. Com o tempo, surgiu a versão “estendida”, que começa com #EXTM3U e permite colocar antes de cada item uma linha #EXTINF com a duração e o nome. Sobre essa base, os players foram somando atributos próprios, como tvg-logo (a imagem), group-title (o grupo) ou tvg-id (o canal do guia de programação).

As vantagens: quase qualquer player a entende, dá para escrevê-la à mão em um minuto e ela é fácil de ler. Os limites: não é um padrão fechado, então cada programa aceita alguns atributos e outros não; tem só um nível de grupos; e não há espaço para descrições longas, legendas externas ou listas dentro de listas.

M3U8: a mesma lista, em UTF-8

Uma .m3u8 é uma M3U salva com a codificação de caracteres UTF-8; daí o “8”. Hoje quase todas as M3U são UTF-8, então, para listas de vídeos, as duas extensões são usadas sem distinção. Se os seus nomes têm acentos, ç ou caracteres de outros alfabetos, salve em UTF-8, seja qual for a extensão.

Atenção: .m3u8 também é HLS

A mesma extensão é usada pelo HLS, o sistema de streaming de muitos sites e transmissões. Um .m3u8 de HLS não é uma lista de vídeos para escolher, e sim o manifesto de um único vídeo dividido em pedaços. Dá para distinguir pelo conteúdo: o de HLS está cheio de tags que começam com #EXT-X-, como #EXT-X-STREAM-INF ou #EXT-X-TARGETDURATION. Explicamos isso em HLS e DASH: como funciona o streaming adaptativo.

O Whatplay olha o conteúdo, e não só a extensão: se você tentar reproduzir um endereço que na verdade é uma lista, ele avisa “Este endereço é uma lista de canais, não um canal”, para que você a adicione em Listas.

W3U: uma lista em JSON

W3U é o formato de listas do Whatplay, escrito em JSON, um formato de texto estruturado com chaves e colchetes. É o que o app usa para salvar e compartilhar as listas que você cria em Favoritos. Um pequeno exemplo:

{
"name": "Vídeos de casa",
"author": "Marta",
"groups": [
{ "name": "Viajes", "image": "https://example.com/img/viajes.jpg",
"stations": [
{ "name": "Lisboa", "url": "https://example.com/videos/lisboa.mp4",
"subtitle": "https://example.com/videos/lisboa.srt" }
] }
]
}

O que ela acrescenta em relação a uma M3U:

• Grupos dentro de grupos (groups dentro de um grupo), para organizar por anos, temporadas ou temas.
• Imagem e descrição (image e info) na lista, em cada grupo e em cada vídeo.
• Legendas externas com subtitle: o endereço de um .srt, .vtt ou .ass.
• Endereços alternativos com url1, url2…: se o principal falhar, eles são testados em ordem.
• Listas vinculadas: um grupo com a própria url é baixado ao ser aberto, então uma coleção grande pode ser dividida em vários arquivos.
• Guia de programação da lista com epg e, em cada item, o epgId, o equivalente do tvg-id.
• Conteúdo restrito com "parental": true na lista, em um grupo ou em um vídeo, que pede o PIN do controle parental.

Se ela ficar muito pesada, dá para compactá-la com gzip e salvá-la como .w3uz; o Whatplay a descompacta sozinho. E ele é tolerante: se faltar uma vírgula no JSON ou sobrar uma chave, ele tenta consertar antes de recusar a lista.

Qual eu uso?

• Você quer que funcione em qualquer player: M3U em UTF-8. É o mais compatível e, para uma coleção simples com capas e grupos, é mais do que suficiente.
• Você vai escrever à mão e a lista é curta: M3U. É mais fácil errar em um JSON do que em uma linha de texto.
• Você tem muito material e quer organizá-lo em níveis, com descrições, legendas externas ou endereços de reserva: W3U.
• Você não quer escrever nada: crie a lista em Favoritos com “Nova lista”. O Whatplay a salva como W3U, e você pode compartilhá-la por link, arquivo ou código QR.

O Whatplay abre as duas igualmente bem, então não é preciso converter o que você já tem. A ajuda resume isso em M3U ou W3U?, e o formato M3U passo a passo está em como criar sua própria lista M3U.

Outras extensões que você vai ver

Em “Adicionar lista”, o Whatplay mostra os formatos que aceita: M3U, M3U8, W3U, W3UZ, WISE e PKW. WISE é outra lista em JSON, muito parecida com a W3U, e PKW é um pacote com várias listas dentro. Se você colar por engano o endereço de um guia XMLTV no lugar de uma lista, o app avisa que é um guia e mostra onde importá-lo.

Dicas para qualquer formato

• Salve sempre em UTF-8 e em texto sem formatação.
• Use endereços completos, com https:// sempre que possível.
• Use nomes curtos e claros: na TV, eles são lidos de longe.
• Antes de compartilhar uma lista, confira se ela não tem usuários nem senhas dentro dos endereços. O Whatplay avisa ao compartilhar se detectar os dados de uma conta.