Neste artigo
Este artigo faz parte do guia O que é IPTV? Guia completo para iniciantes em Portugal.
Uma lista M3U é um ficheiro de texto: cada canal ocupa duas linhas, uma com a informação (nome, grupo, logótipo, identificador do guia) e outra com o endereço do vídeo. Editar uma lista é, portanto, editar texto, num editor simples ou numa ferramenta própria. Mas antes de pôr mãos à obra, uma recomendação: se a sua aplicação permite ocultar grupos, criar favoritos e reordenar canais, faça isso na aplicação. Editar o ficheiro só compensa em casos específicos, e uma lista que se atualiza a partir de um URL do fornecedor volta ao original na próxima atualização.
Se é a primeira vez que lida com IPTV, comece pelo guia O que é IPTV.
A estrutura de uma lista M3U
Um exemplo (valores fictícios):
#EXTM3U
#EXTINF:-1 tvg-id="CanalExemplo.pt" tvg-name="Canal Exemplo" tvg-logo="https://exemplo/logo.png" group-title="Portugal",Canal Exemplo HD
http://servidor.exemplo/stream/123| Elemento | Para que serve |
|---|---|
| #EXTM3U | Cabeçalho obrigatório na primeira linha |
| #EXTINF:-1 | Início da informação de um canal (-1 = duração indefinida, típico de direto) |
| tvg-id | Identificador que liga o canal ao guia de programação (EPG) |
| tvg-name | Nome do canal no guia |
| tvg-logo | Endereço do logótipo |
| group-title | Grupo ou categoria |
| Texto depois da vírgula | Nome mostrado na lista |
| Linha seguinte | Endereço (URL) do vídeo |
Explicamos o formato em detalhe em O que é um ficheiro M3U.
O que pode editar com segurança
- Ordem dos canais: mover os pares de linhas (#EXTINF + URL) juntos.
- Grupos: mudar o group-title para criar categorias à sua medida (por exemplo, "Favoritos").
- Nomes: alterar o texto depois da vírgula.
- Logótipos: trocar o tvg-logo por outro endereço.
- Ligação ao guia: corrigir o tvg-id para corresponder ao identificador do canal no ficheiro XMLTV.
- Remover canais que não usa (sempre o par de linhas completo).
Ferramentas
- Editor de texto simples (Bloco de Notas, TextEdit em modo texto simples, editores de código): suficiente para listas pequenas. Guarde em UTF-8 para manter os acentos.
- Editores de listas M3U (aplicações e sites próprios): úteis para listas grandes, com arrastar e largar. Cuidado com editores online: ao carregar a lista, está a entregar o seu URL e as suas credenciais a terceiros. Prefira ferramentas que funcionam localmente.
- Editor das aplicações de Smart TV: algumas, como o SS IPTV, têm editor no site do programador. Veja SS IPTV na Smart TV.
Editar na aplicação vs. editar o ficheiro
| Na aplicação | No ficheiro | |
|---|---|---|
| Ocultar grupos | Sim, na maioria | Removendo linhas |
| Favoritos | Sim | Criando um grupo |
| Sobrevive à atualização da lista | Sim | Não, se a lista vem de um URL do fornecedor |
| Risco de estragar | Baixo | Médio |
Conclusão: para uso diário, organize na aplicação. Edite o ficheiro quando precisar de algo que a aplicação não faz, e mantenha uma cópia do original.
Criar a sua própria lista com canais de acesso livre
Pode criar uma lista M3U do zero com fluxos que tem direito a usar, por exemplo transmissões em direto que os próprios canais disponibilizam publicamente nos seus sites:
- Crie um ficheiro de texto com #EXTM3U na primeira linha.
- Para cada canal, acrescente a linha #EXTINF com o nome e, na linha seguinte, o endereço do fluxo.
- Guarde com a extensão .m3u e em UTF-8.
- Abra no VLC para testar. Veja Como ver IPTV no VLC.
Atenção: endereços publicados em listas "públicas" na internet não são automaticamente legais. Use apenas fluxos que o titular disponibiliza abertamente. Veja IPTV é legal em Portugal?.
Problemas depois de editar
| Problema | Causa provável |
|---|---|
| A aplicação diz "lista inválida" | Falta #EXTM3U na primeira linha, ou uma linha #EXTINF ficou sem URL |
| Acentos estranhos | Ficheiro guardado sem UTF-8 |
| Guia deixou de aparecer | tvg-id alterado ou apagado |
| As alterações desapareceram | A aplicação recarregou a lista original a partir do URL |
Perguntas frequentes
Como abro uma lista M3U para editar?
Num editor de texto simples (Bloco de Notas, TextEdit em texto simples ou um editor de código). Guarde sempre em UTF-8.
O que é o tvg-id numa lista M3U?
É o identificador que liga o canal à sua entrada no guia de programação (XMLTV). Se não corresponder, o canal aparece sem programação.
Porque é que as minhas alterações desaparecem?
Se a aplicação carrega a lista a partir do URL do fornecedor, recarrega a versão original. Nesse caso, organize os canais na própria aplicação.
É seguro usar editores de M3U online?
Ao carregar a lista, entrega o URL e as credenciais a terceiros. Prefira ferramentas que funcionam localmente no seu computador.
Em resumo
Uma lista M3U é texto: cada canal tem uma linha de informação (#EXTINF com tvg-id, tvg-logo e group-title) e uma linha com o endereço do vídeo. Pode reordenar, renomear, agrupar e corrigir a ligação ao guia, mas nunca os endereços. Para uso diário, organize na aplicação; edite o ficheiro só quando necessário, numa ferramenta local e com uma cópia do original.
Não sabe onde está o URL da sua lista? Explicamos onde o encontrar e como o introduzir.
URL da lista M3U
