Como criar sua própria lista M3U com seus vídeos

5 min de leitura

Uma lista M3U é um arquivo de texto com endereços de vídeo, um depois do outro, e alguns dados para cada um: o nome, a imagem e o grupo em que ele fica. Não é preciso programar nem instalar nada: com um editor de texto e seus vídeos acessíveis por um endereço da web, você pode ter seu próprio catálogo e abri-lo no celular, no tablet ou na TV. Neste guia, você vai ver o formato linha por linha, onde hospedar a lista e como adicioná-la no Whatplay.

O mínimo: #EXTM3U e um endereço

A lista mais simples tem um cabeçalho e um endereço por linha:

#EXTM3U
http://192.168.1.20:8000/vacaciones/playa.mp4
http://192.168.1.20:8000/vacaciones/montana.mp4

A primeira linha, #EXTM3U, indica que é uma M3U “estendida”, a que aceita dados de cada vídeo. O Whatplay também abre listas sem ela, mas é bom colocá-la sempre, porque outros players a exigem. Sem mais dados, cada vídeo fica com o nome do arquivo.

O nome e os dados de cada vídeo: #EXTINF

Antes de cada endereço, você pode colocar uma linha #EXTINF com os dados do vídeo. Ela tem três partes: a duração, os atributos e, depois da primeira vírgula, o nome que você vai ver na tela:

#EXTM3U
#EXTINF:-1 tvg-logo="https://example.com/img/playa.jpg" group-title="Vacaciones 2025",La playa de Cádiz
https://example.com/videos/playa.mp4
#EXTINF:-1 tvg-logo="https://example.com/img/cumple.jpg" group-title="Familia",Cumpleaños de Lucía
https://example.com/videos/cumple-lucia.mp4

A duração fica em segundos. O -1 significa “não se sabe” ou “não tem fim”, e é o mais comum: o player descobre a duração ao abrir o vídeo.
tvg-logo é o endereço de uma imagem (JPG ou PNG) que serve de capa. Prefira uma imagem leve, com algumas centenas de pixels de largura, para a lista carregar rápido.
group-title é o grupo. No Whatplay, cada grupo é uma pasta ou um filtro, conforme o que você escolher em Configurações › “Grupos das listas”. Se um vídeo não tiver grupo, ele fica no grupo do anterior; e, se todos estiverem no mesmo, a lista aparece sem pastas.
tvg-id é o identificador que liga um canal ao guia de programação XMLTV. Para seus vídeos ele não é necessário, mas, se um dia você adicionar uma transmissão com programação, é ele que manda.

Coloque os valores dos atributos entre aspas duplas e o nome no final, depois da vírgula. O nome pode ter vírgulas sem problema.

Mais coisas que o Whatplay entende

radio="true" no #EXTINF marca algo que é só áudio, como um podcast ou uma rádio.
url-tvg="…" na linha #EXTM3U indica o guia de programação da lista inteira. O Whatplay o reconhece e sugere importá-lo no Guia.
#EXTGRP:Nombre é outra forma de indicar o grupo, em uma linha separada.

Como escrever e salvar a lista

Abra um editor de texto sem formatação: o Bloco de Notas no Windows, o TextEdit no Mac no modo de texto simples ou qualquer editor de código. Nada de processadores de texto, que adicionam estilos.
Escreva o cabeçalho e, para cada vídeo, o #EXTINF e o endereço dele.
Salve com a extensão .m3u e a codificação UTF-8, para que os acentos e o ç apareçam direito.
Confira se cada endereço abre o vídeo em um navegador. Se o nome de um arquivo tiver espaços, no endereço eles viram %20; melhor ainda, renomeie os arquivos usando hifens.

Onde hospedar a lista e os vídeos

A lista só guarda endereços: os vídeos precisam estar em algum lugar que o aparelho em que você assiste consiga alcançar. Há três opções comuns:

Seu próprio servidor ou hospedagem de sites. Envie os vídeos e a lista para uma pasta pública e use endereços https://. É o mais prático se você também quiser assistir fora de casa. Leve em conta o tráfego que seu plano permite: vídeo consome muito.
Uma pasta compartilhada por HTTP em casa. Um computador ou um NAS serve uma pasta pela rede de casa, e a lista aponta para o IP dele, como http://192.168.1.20:8000/…. Só funciona dentro do seu Wi-Fi. Os passos estão em como assistir aos vídeos do computador ou de um NAS.
Um link direto da sua nuvem. Muitos serviços de armazenamento oferecem um link de compartilhamento que abre uma página de pré-visualização, e não o arquivo. Para uma lista, você precisa do link de download direto: aquele que, ao ser aberto no navegador, começa a baixar ou a reproduzir o arquivo. Se o serviço não oferece isso, essa nuvem não serve para esse fim.

A lista em si pode ficar onde você quiser: junto com os vídeos, em outro servidor ou no próprio celular. O que importa é que os endereços dentro dela funcionem no aparelho que a abre.

Adicionar a lista no Whatplay

Vá em Listas e toque em “Adicionar lista”.
Escolha como: “Endereço” se a lista estiver na internet ou na sua rede, “Arquivo” se ela estiver no dispositivo, “Colar” para colar um link copiado ou “Código QR” para lê-la com a câmera.
Com um endereço, deixe ativado “Sincronizar automaticamente”: o Whatplay baixa a lista de novo ao abrir o app, se tiver passado mais de uma hora. Assim, basta editar o arquivo no servidor para que as mudanças cheguem a todos os seus aparelhos.
Toque em “Importar lista”. Ela vai aparecer em Listas com seus grupos e imagens.

Para baixar uma lista, o Whatplay só aceita endereços http:// ou https://. Uma lista adicionada como arquivo não se atualiza sozinha: se você alterá-la, importe-a de novo. Há um resumo na ajuda: Como adiciono uma lista?

Sem escrever nada: crie no app

Se você não quiser editar texto, na aba Favoritos dá para criar uma lista com “Nova lista” e preenchê-la com “Adicionar” › “Canal pelo endereço”, com pastas e imagens. O Whatplay a salva em W3U, seu formato de listas, e você pode compartilhá-la. Se estiver em dúvida entre um formato e outro, veja M3U, M3U8 e W3U: o que é cada uma.

Erros comuns

“A lista não contém canais”: nenhuma linha tem um endereço reconhecível. Confira se eles começam com http:// ou https://.
Nomes com símbolos estranhos: o arquivo não foi salvo em UTF-8.
Um vídeo não abre: teste o endereço dele sozinho no navegador. Se lá também falhar, o problema é o servidor ou o link, não a lista.
Tudo aparece em uma pasta só: falta group-title no primeiro vídeo de cada grupo.
As mudanças não chegam: se você adicionou a lista como arquivo, importe-a de novo; se foi por endereço, toque em “Atualizar” no menu da lista.