Como editar uma playlist M3U sem danificá-la

Você abre o arquivo de playlist que recebeu e encontra oito mil linhas. Metade dos nomes tem prefixos exagerados e códigos de países. Os grupos não fazem sentido. Há quatrocentas entradas que você nunca vai assistir.

Você quer corrigir tudo, mas tem medo de estragar alguma coisa.

A boa notícia: uma M3U é um texto simples com uma estrutura muito flexível, e existem apenas quatro edições que realmente podem danificá-la. Todo o resto é seguro. Veja como organizá-la corretamente.

Antes de tudo: faça uma cópia do arquivo

Faça uma cópia chamada playlist-original.m3u8 e não mexa nela. Você vai cometer algum erro, e desfazê-lo leva dois segundos se tiver um original intacto — ou uma tarde inteira se não tiver.

Se sua playlist veio de uma URL, e não de um arquivo, baixe-a primeiro: abra a URL no navegador e salve o texto. Observe que, se a playlist for gerada automaticamente por um provedor, suas edições locais não sobreviverão a uma atualização feita a partir da fonte. É importante saber disso antes de passar uma hora editando. (Falaremos mais sobre isso no final.)

A estrutura que você precisa preservar

Todo o formato se resume a três regras. Quebre uma delas e a playlist apresentará problemas. Respeite-as e você poderá fazer o que quiser. (Explicação completa do formato.)

1. #EXTM3U permanece na primeira linha. Nada antes dela. Nem uma linha em branco, nem um comentário, nem um caractere perdido.
2. Cada entrada tem exatamente duas linhas: uma linha #EXTINF:, seguida do endereço diretamente na linha abaixo.
3. Nada deve ficar entre essas duas linhas. Nem uma linha em branco, nem um comentário.

É realmente só isso.

As quatro edições que danificam uma playlist

Na ordem em que as pessoas costumam cometê-las:

1. Excluir apenas uma linha do par. Remova a #EXTINF e deixe a URL, e a URL se tornará uma entrada órfã sem nome. Remova a URL e deixe a #EXTINF, e a entrada seguinte receberá o nome errado, propagando o problema pelo restante do arquivo. Sempre exclua as duas linhas juntas.
2. Salvar como texto formatado. Abrir o arquivo em um processador de texto e salvá-lo novamente insere bytes de formatação. O arquivo parece idêntico na tela, mas é interpretado como lixo.
3. Aspas curvas. Editores que "ajudam" transformando " em " destroem todos os atributos que alteram. Essa é a falha mais desagradável, porque o arquivo parece perfeito. Desative a autocorreção ou use um editor que não tenha esse recurso.
4. Alterar a codificação. Salve uma playlist UTF-8 em outro formato e todos os nomes com acentos ou caracteres não latinos virarão texto corrompido. Sempre salve como UTF-8.

O que usar

Um editor de texto simples é a resposta certa. Notepad++ no Windows, BBEdit ou VS Code no Mac, qualquer editor de código no Linux. Você precisa de localizar e substituir no arquivo inteiro, sem autocorreção e com controle explícito da codificação. Qualquer ferramenta voltada para programadores oferece os três recursos.

Planilhas são uma armadilha. As pessoas tentam importar uma M3U para uma planilha para classificá-la, mas a correspondência entre as duas linhas não sobrevive ao processo de ida e volta. Não faça isso.

Editores de M3U online existem e são convenientes. Leia a observação de segurança abaixo antes de colar qualquer coisa em um deles.

Edições que valem a pena

Remova o excesso

É a edição que oferece o maior benefício. A maioria das playlists muito grandes é composta por 90% de conteúdo que você nunca vai abrir, e uma playlist menor carrega mais rápido e facilita a navegação na TV.

Procure um grupo ou prefixo que você não quer e exclua os pares correspondentes. Em um bom editor, você pode selecionar desde uma linha #EXTINF até o final da linha seguinte e excluir as duas de uma só vez.

Corrija os nomes

As playlists de provedores adoram prefixos: [HD] UK: , US| , 4K -. Eles existem para a classificação do provedor, não para facilitar sua leitura.

Use localizar e substituir para trocar o prefixo por nada em todo o arquivo e limpe centenas de entradas de uma só vez. Apenas verifique se a sequência que você está substituindo aparece somente nos nomes exibidos, e não em uma URL — um prefixo como US| é seguro, mas um 4K isolado pode não ser.

Reagrupe

group-title="…" é o que cria o menu de categorias no seu player. Os agrupamentos dos provedores costumam ser pouco úteis — trinta categorias quando você queria cinco.

Use localizar e substituir para trocar group-title="Sports UK" por group-title="Sport", repita o processo com os demais e você terá transformado um menu enorme em algo fácil de navegar. Essa é a edição que mais muda a experiência de uso da playlist no dia a dia. (Mais informações sobre como organizar por categorias.)

Reordene

Em geral, os players exibem as entradas na ordem em que aparecem no arquivo dentro de cada grupo. Mova um par de linhas para mover uma entrada. Recorte as duas linhas, cole as duas linhas e pronto.

Para a maioria das pessoas, isso é desnecessário: os favoritos do player resolvem melhor a questão das "dez coisas que eu realmente assisto" do que a ordem no arquivo, e eles não são apagados quando a playlist é atualizada.

Corrija os IDs do guia

Se o seu guia de programação estiver pela metade, o motivo mais comum são valores de tvg-id que não correspondem aos IDs do seu feed do guia. Editá-los para que coincidam é trabalhoso, mas essa é a correção de verdade; recarregar o guia quantas vezes quiser não substitui esse procedimento. (Por que a correspondência do guia falha.)

Faça isso por último. É a tarefa mais trabalhosa e a menos reversível.

Observação de segurança sobre editores online

Editores de M3U baseados na web são realmente convenientes. Antes de colar o arquivo, pense no que ele contém.

Se sua playlist veio de uma fonte no estilo Xtream, todas as URLs contêm seu nome de usuário e sua senha. Colar o arquivo em um site entrega a um desconhecido credenciais válidas da sua conta — o que, em uma fonte com limite de conexões, significa que outra pessoa pode desconectar você. (Como essas URLs são construídas.)

Se você quiser essa praticidade, prefira um editor que funcione inteiramente no navegador sem fazer upload e confirme essa afirmação desligando sua conexão de rede durante a edição — se ele continuar funcionando, nada está sendo enviado. Caso contrário, um editor de texto local não expõe nada.

A primeira coisa a decidir: suas edições vão permanecer?

Isso determina se todo esse trabalho vale a pena.

Se sua playlist for um arquivo local que pertence a você, suas edições serão permanentes. Edite à vontade.

Se sua playlist for uma URL gerada por um provedor, editar uma cópia baixada cria uma versão independente. Agora você tem um arquivo limpo e organizado que não recebe mais as inclusões, remoções e correções do provedor. Quando eles adicionarem algo, você não verá. Quando o endereço de um stream mudar, o seu deixará de funcionar.

Isso não é necessariamente errado — uma cópia estável e organizada é exatamente o que algumas pessoas querem —, mas deve ser uma decisão, não uma surpresa.

O meio-termo que geralmente funciona melhor: deixe a playlist de origem intacta e faça sua organização dentro do player. Favoritos, categorias personalizadas e grupos ocultos oferecem uma visão limpa e pessoal sem criar uma versão independente do arquivo, além de sobreviverem a todas as atualizações do provedor. No Tuneline, isso significa favoritos e categorias personalizadas, que são sincronizados entre seus dispositivos em vez de ficarem em um único arquivo em uma única máquina.

Eu tentaria isso primeiro. Editar manualmente um arquivo com oito mil linhas dá muito trabalho para refazer na próxima vez que o provedor o gerar novamente.

Verifique seu trabalho

Depois de editar e antes de confiar no resultado:

1. Confirme se a primeira linha ainda é #EXTM3U.
2. Conte as entradas. A maioria dos editores mostra a quantidade de resultados de uma busca — procurar por #EXTINF e por http deve retornar números iguais ou muito próximos. Uma diferença indica linhas órfãs.
3. Carregue o arquivo em um player. Se os nomes aparecerem corretamente, a estrutura foi preservada.
4. Verifique algumas entradas de grupos diferentes.

Se carregar, mas não mostrar nada, a estrutura foi danificada. Se carregar com os nomes, mas nada for reproduzido, a estrutura está correta e o problema está nos endereços — é outro problema, outra lista de verificação.

Conclusão

• Uma M3U é um texto simples. Editá-la é seguro se você mantiver #EXTM3U na primeira posição e as entradas em duas linhas consecutivas.
• Os quatro problemas fatais: excluir metade de um par, usar texto formatado, aspas curvas e codificação incorreta.
• Use um editor de texto simples com localizar e substituir. Nunca um processador de texto e nunca uma planilha.
• Editores online podem estar lendo as credenciais incluídas nas suas URLs.
• Editar uma lista gerada pelo provedor cria uma cópia independente dela. Os favoritos e as categorias personalizadas dentro do seu reprodutor geralmente oferecem o mesmo resultado sem esse custo.

Quer a curadoria sem mexer no arquivo? Baixe Tuneline — favoritos, categorias personalizadas e busca em qualquer lista, grátis.