SobrePerfisMulti telaRecursosCada appSaimo ConnectAparelhosBaixarAbrir no navegador
SAIMO TV

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.

Última atualização: 10 de novembro de 2026 · Versão 1.0
1

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.

JEITOPARA QUEMO QUE DIGITAR NO APP
Link M3UVocê já tem uma lista .m3uSó o link (em Minhas listas)
Servidor + usuário + senha (Xtream)Seu provedor entrega esses dadosServidor, usuário e senha
Formato SaimoVocê quer controlar tudoDois endereços: canais e filmes/séries
Link M3U → Só o link (em Minhas listas) Xtream → Servidor, usuário e senha Formato Saimo → Dois endereços (canais + filmes/séries)
2

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://….
3

Onde publicar

Qualquer hospedagem de arquivos estáticos serve: Cloudflare Pages, GitHub Pages, Netlify, Vercel, um servidor próprio com nginx.

EXIGÊNCIAPOR QUÊ
HTTPSO 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 redirecionamentoO app não sabe preencher
4

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.

CHAVEOBRIGATÓRIAO QUE É
canal:simNome do canal. Abre um canal novo
fonte:sim, ao menos umaEndereço do vídeo. A primeira é a preferida; se falhar, desce para a seguinte
logo:nãoImagem do canal (PNG/JPG/WebP, https)
categoria:nãoSeção da lista. Sem ela, o app deduz pelo nome
nome:nãoRótulo da fonte ("Principal", "Legendado")
qualidade:nãoMarca de qualidade da fonte ("4K", "HD")
referer:nãoCabeçalho Referer que o servidor exige
agente:nãoUser-Agent que o servidor exige
chave:nãoChave ClearKey das fontes DASH protegidas
canal: Canal de Exemplo logo: https://example.com/logos/canal.png categoria: TV Aberta fonte: https://example.com/canal/principal.m3u8 nome: Principal fonte: https://example.com/canal/reserva.m3u8 nome: Reserva
5

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 #.

6

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ó testarPublique catalogo.txt com um canal e informe o endereço em Ajustes → Listas
Uma reserva automáticaAcrescente outro fonte: abaixo do canal
Canal que exige cabeçalhoreferer: / agente: logo abaixo da fonte:
Canal protegido (DASH)fonte: com .mpd + chave: KID:CHAVE
Dublado e legendado do mesmo filmeDuas colunas na mesma linha: dub=… e leg=…
Trocar um servidor inteiroTroque a linha base: no indice.txt
7

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/
8

Erros comuns

Sintomas frequentes e suas causas prováveis:

SINTOMA NO APPCAUSA PROVÁVEL
Nada apareceEndereço sem https://, ou sem catalogo.txt/indice.txt na pasta
Funciona no Mac e não no site/Samsung/LGFalta Access-Control-Allow-Origin: *
Canal someNão tem fonte: ou a fonte não é http(s) completa
referer:/chave: não valemVieram antes da fonte: (pertencem à fonte de cima)
Filme abre em tela pretaNúmero de base inexistente, base sem / no fim, ou indice.txt desatualizado
Série abre vaziaTítulo/ano do @ diferente do de series-<LETRA>.txt
Filme não aparece na buscaFalta em busca.txt, ou está na letra errada
Rádios não atualizamMenos de 10 rádios válidas no arquivo
Acentos quebradosO arquivo não está em UTF-8
Mudei e nada mudouCache. Feche e abra o app; se persistir, limpe o cache dos Ajustes
Publicidade
+

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.

python3 scripts/validar_formato_saimo.py tudo https://seu-site/canais/ https://seu-site/filmes/

Dúvidas ou um caso que o formato não cobre? Fale com o suporte.