Formato de lista do Saimo
Como montar a sua própria lista de canais e de filmes e séries para o Saimo reconhecer, com exemplos prontos e um validador.
Antes de começar: três jeitos de trazer uma lista
Este documento descreve, arquivo por arquivo, como montar a sua própria lista de canais e de filmes e séries para o Saimo reconhecer. É o mesmo formato que os apps e o site leem.
O Saimo é um reprodutor. Ele não traz nem hospeda conteúdo: só abre o que está na lista que você informa. Use apenas endereços de conteúdo que você tem direito de acessar.
| JEITO | PARA QUEM | O QUE DIGITAR NO APP |
|---|---|---|
| Link M3U | Você já tem uma lista .m3u | Só o link (em Minhas listas) |
| Servidor + usuário + senha (Xtream) | Seu provedor entrega esses dados | Servidor, usuário e senha |
| Formato Saimo | Você quer controlar tudo | Dois endereços: canais e filmes/séries |
Como funciona
Você publica arquivos de texto em um endereço da internet. No app, em Ajustes → Listas, informa dois endereços:
O app só acrescenta o nome do arquivo ao endereço: …/canais/ + catalogo.txt.
- Canais: https://seu-site/canais/
- Filmes e séries: https://seu-site/filmes/
- o endereço começa com https:// e termina com /;
- os dois endereços podem ser o mesmo, com os arquivos na mesma pasta, ou diferentes;
- um arquivo opcional ausente não dá erro: aquele recurso só não aparece.
- texto UTF-8, sem BOM, de preferência com quebra de linha LF;
- linhas em branco são ignoradas; linhas começadas por # são comentários;
- endereços de vídeo completos: https://… ou http://….
Onde publicar
Qualquer hospedagem de arquivos estáticos serve: Cloudflare Pages, GitHub Pages, Netlify, Vercel, um servidor próprio com nginx.
| EXIGÊNCIA | POR QUÊ |
|---|---|
| HTTPS | O site e as TVs Samsung/LG bloqueiam endereços http:// em páginas seguras |
| CORS aberto (Access-Control-Allow-Origin: *) | O site e as TVs Samsung/LG são páginas web e só leem arquivos que permitem |
| Tipo text/plain (ou text/*) | Alguns navegadores recusam outros tipos |
| Sem login, sem redirecionamento | O app não sabe preencher |
Canais
Endereço de canais + arquivos: catalogo.txt (obrigatório), radios.txt, guia.txt, canais.txt e restritos.txt.
Um campo por linha, no formato chave: valor. Um canal começa com canal: e o que vem depois pertence a ele.
| CHAVE | OBRIGATÓRIA | O QUE É |
|---|---|---|
| canal: | sim | Nome do canal. Abre um canal novo |
| fonte: | sim, ao menos uma | Endereço do vídeo. A primeira é a preferida; se falhar, desce para a seguinte |
| logo: | não | Imagem do canal (PNG/JPG/WebP, https) |
| categoria: | não | Seção da lista. Sem ela, o app deduz pelo nome |
| nome: | não | Rótulo da fonte ("Principal", "Legendado") |
| qualidade: | não | Marca de qualidade da fonte ("4K", "HD") |
| referer: | não | Cabeçalho Referer que o servidor exige |
| agente: | não | User-Agent que o servidor exige |
| chave: | não | Chave ClearKey das fontes DASH protegidas |
Filmes e séries
Endereço de filmes + indice.txt (obrigatório), filmes-<LETRA>.txt, series-<LETRA>.txt, series-<LETRA>-<N>.txt, busca.txt e destaques.txt.
O acervo é fatiado por letra para que nenhum download passe de uns 100 KB: a tela navega por letra, e o app baixa só a fatia que o usuário abre.
A letra é a primeira letra do título, sem acento, em maiúscula: "Ágata" → A. Títulos que começam com número, símbolo ou outro alfabeto vão em #.
Referência rápida
Estrutura de pastas: canais/ (catalogo.txt, radios.txt, guia.txt, canais.txt, restritos.txt) e filmes/ (indice.txt, filmes-A.txt…Z, series-*.txt, busca.txt, destaques.txt, fichas.txt, generos.txt, detalhes.txt, marcas.txt).
| QUERO… | FAÇA |
|---|---|
| Só testar | Publique catalogo.txt com um canal e informe o endereço em Ajustes → Listas |
| Uma reserva automática | Acrescente outro fonte: abaixo do canal |
| Canal que exige cabeçalho | referer: / agente: logo abaixo da fonte: |
| Canal protegido (DASH) | fonte: com .mpd + chave: KID:CHAVE |
| Dublado e legendado do mesmo filme | Duas colunas na mesma linha: dub=… e leg=… |
| Trocar um servidor inteiro | Troque a linha base: no indice.txt |
Validar antes de usar
O repositório traz um validador que lê a sua lista e aponta cada problema com o arquivo e a linha:
Ele confere codificação, formato de cada linha, bases do índice, arquivos por letra, pedaços de série, correspondência de título e ano, e (em endereços web) o CORS. Termina com código 0 quando não há erro. Só precisa do Python 3, sem instalar nada.
- python3 scripts/validar_formato_saimo.py canais docs/exemplos/canais
- python3 scripts/validar_formato_saimo.py filmes docs/exemplos/filmes
- python3 scripts/validar_formato_saimo.py tudo https://seu-site/canais/ https://seu-site/filmes/
Erros comuns
Sintomas frequentes e suas causas prováveis:
| SINTOMA NO APP | CAUSA PROVÁVEL |
|---|---|
| Nada aparece | Endereço sem https://, ou sem catalogo.txt/indice.txt na pasta |
| Funciona no Mac e não no site/Samsung/LG | Falta Access-Control-Allow-Origin: * |
| Canal some | Não tem fonte: ou a fonte não é http(s) completa |
| referer:/chave: não valem | Vieram antes da fonte: (pertencem à fonte de cima) |
| Filme abre em tela preta | Número de base inexistente, base sem / no fim, ou indice.txt desatualizado |
| Série abre vazia | Título/ano do @ diferente do de series-<LETRA>.txt |
| Filme não aparece na busca | Falta em busca.txt, ou está na letra errada |
| Rádios não atualizam | Menos de 10 rádios válidas no arquivo |
| Acentos quebrados | O arquivo não está em UTF-8 |
| Mudei e nada mudou | Cache. Feche e abra o app; se persistir, limpe o cache dos Ajustes |
Exemplos prontos e validador
O repositório traz exemplos prontos em docs/exemplos/ e um validador que confere codificação, formato de cada linha, bases do índice, arquivos por letra e CORS. Copie, troque os endereços e publique.
Dúvidas ou um caso que o formato não cobre? Fale com o suporte.