Coloque o seu conteúdo em todas as telas com um código

O TEVIX é um aplicativo para Smart TV, celular e computador que vira o aplicativo da sua empresa. Você não precisa publicar nada nas lojas: o seu público instala o TEVIX, digita o seu código e o aparelho passa a abrir sempre direto no seu conteúdo, com o seu nome, a sua cor e o seu logo.

Em 3 passos

Escolha o tipo de fonte

A "fonte" é de onde o TEVIX busca o seu conteúdo. Existem três tipos. Comece pelo mais simples para o seu caso; dá para trocar depois sem mudar o código.

Site ou player web

Informe a URL completa. O aparelho abre essa página em tela cheia dentro do TEVIX. Funciona para qualquer site, mas para ficar bom na TV o site precisa aceitar navegação por setas e OK (foco visível nos botões). Se ele já funciona no navegador da TV, vai funcionar aqui.

Formato compatível (start.json)

Se você já tem um start.json publicado para outro aplicativo de TV, cadastre a URL dele (por exemplo https://seusite.com/app/start.json). O TEVIX entende:

• parameter com menu:, content: e redirect:; os marcadores {PREFIX} e {SERVER} são preenchidos com o protocolo e o host do seu start.json.
• Menu (headline, menu[] com label, icon, data como URL ou objeto, execute, focus).
• Conteúdo em pages[].items[] com layout na grade 12×6 (ou 16×8 com compress), e também template + items com {context:...} e action: "video:data".
• Tipos de item default, separate, teaser, button, space; campos title, titleHeader, titleFooter, label, image, icon, action, execute, focus.
• Ações video:, audio:, link:, link:window:, content:, info:, reload:, back: e ações múltiplas [a|b].

Ainda não suportado nesse formato: plugins (video:plugin:, audio:plugin:), panel:, request:interaction: e propriedades estendidas. Esses itens mostram um aviso em vez de quebrar.

Formato TEVIX

É o formato mais completo e também simples: um arquivo principal (tevix.json) com a identidade e o menu, e um arquivo por página. Veja a seguir.

tevix.json: identidade e menu

{
  "tevix": "1.0",
  "app": {
    "name": "Portal Cidade",
    "tagline": "Notícias e Rádio 98,7",
    "short": "PC",
    "color": "#E8452C",
    "logo": "logo.png"
  },
  "menu": [
    { "id": "inicio",   "label": "Início",   "icon": "home",  "content": "inicio.json" },
    { "id": "aovivo",   "label": "Ao vivo",  "icon": "live",  "content": "aovivo.json" },
    { "id": "noticias", "label": "Notícias", "icon": "news",  "content": "noticias.json" },
    { "id": "radio",    "label": "Rádio",    "icon": "radio", "content": "radio.json" }
  ],
  "player": {
    "type": "audio",
    "title": "Rádio Cidade 98,7 FM",
    "subtitle": "Ao vivo",
    "url": "https://stream.suaradio.com.br/live.mp3"
  }
}

Páginas e blocos

Cada item do menu aponta para um arquivo de página. A página tem um título e uma lista de blocos, de cima para baixo.

{
  "title": "Início",
  "meta": "Atualizado há 4 min",
  "blocks": [
    { "type": "hero", "items": [ "1 destaque grande + até 2 laterais" ] },
    { "type": "row",  "title": "Últimos vídeos", "items": [ "carrossel horizontal" ] },
    { "type": "grid", "title": "Notícias",       "items": [ "grade de cards" ] },
    { "type": "list", "title": "Mais lidas",     "items": [ "lista numerada só com texto" ] }
  ]
}

Itens

{
  "k": "Esporte",
  "title": "Cidade FC vence e assume a liderança",
  "desc": "Gol aos 43 do segundo tempo garantiu a vitória.",
  "time": "há 1 h",
  "image": "https://seusite.com/img/futebol.jpg",
  "action": "text:materia/1235.json"
}

Ações

URLs podem ser relativas ao arquivo em que estão (materia/1235.json, ../videos/x.mp4). Um item sem action é só informativo.

Plugins: conteúdo dinâmico do seu servidor

JSONs estáticos resolvem a maioria dos apps. Quando o conteúdo precisa de lógica em tempo real (programação que muda, player com login, progresso ao vivo, catálogo por usuário), use um plugin TEVIX: uma página HTML sua que roda escondida dentro do app e conversa com ele. O app pede o conteúdo ao plugin, o plugin responde com o mesmo JSON de página que você já conhece e, quando quiser, atualiza itens na tela, abre um vídeo, mostra um painel ou reage ao que o usuário faz.

1. A página do plugin

Crie um HTML (ex.: https://seusite.com/tevix/plugin.html) que carrega a biblioteca e registra um handler. A página não tem interface: ela só responde ao app.

<!DOCTYPE html>
<html><head><meta charset="utf-8">
<script src="https://tevix.app/js/tevix-plugin.js"></script>
</head><body><script>
TevixPlugin.setupHandler({
  init: function (info) {
    // info.app {name,color,logo}, info.code, info.lang ("pt"|"en"|"es"), info.device.id, info.tevix
  },
  ready: function () {
    // conexão pronta: aqui você pode iniciar timers (ex.: atualizar itens a cada segundo)
  },
  handleRequest: function (id, data, reply) {
    // o app pede um conteúdo. "init" é o pedido padrão quando a página do plugin abre.
    if (id === "init") reply({
      headline: "No ar",
      pages: [{ items: [
        { id: "agora", layout: "0,0,8,2", titleHeader: "Agora", title: "Jornal da Manhã", progress: 0.4, action: "video:plugin:aovivo" },
        { layout: "8,0,4,2", type: "button", icon: "list", label: "Programação", action: "content:plugin:grade" }
      ]}]
    });
    else if (id === "aovivo") reply({ url: "https://cdn.seusite.com/live.m3u8", title: "Ao vivo" });
    else if (id === "grade") reply({ headline: "Programação", pages: [ /* ... */ ] });
    else reply({ error: "pedido desconhecido: " + id });
  },
  handleData: function (data) {
    // veio de uma ação "plugin:commit:ALGUMA-COISA" (string)
  },
  handleEvent: function (name, data) {
    // "player:play", "player:time" {position,duration}, "player:ended", "player:closed", "content:shown", "focus" {id}, "back", "visibility"
  }
});
</script></body></html>

reply() aceita um JSON de página (pages/template+items ou blocks), um objeto { "action": "video:..." } para só executar uma ação, ou { "error": "mensagem" }. Também pode devolver uma Promise. Se o plugin não responder em 20 segundos, o app mostra um erro com botão Tentar novamente.

2. Ligando o plugin ao app

No tevix.json, um item do menu pode apontar para o plugin em vez de um arquivo de página:

{
  "app": { "name": "TV Cidade", "color": "#E8452C" },
  "menu": [
    { "label": "Ao vivo", "icon": "live", "plugin": "https://seusite.com/tevix/plugin.html" },
    { "label": "Notícias", "icon": "news", "content": "noticias.json" }
  ]
}

Se o app inteiro é o plugin, use "plugin": "URL" direto na raiz do tevix.json (sem menu): o app abre sem barra lateral. Por padrão o app pede o conteúdo init; mude com "request": "outro-id". Dentro de qualquer página, estática ou vinda do plugin, use as ações da tabela abaixo. O plugin fica carregado enquanto o app estiver aberto, mesmo trocando de página; carregar um plugin de outra URL descarrega o anterior.

3. O que o plugin pode fazer no app

Tudo pela biblioteca TevixPlugin:

4. Eventos que o app envia

Chegam em handleEvent(nome, dados):

5. Propriedades extras de páginas e itens

Matérias (texto)

{
  "k": "Cidade",
  "title": "Prefeitura anuncia nova linha de ônibus",
  "subtitle": "Operação começa na segunda-feira com 12 veículos.",
  "date": "2 de novembro de 2026",
  "author": "Redação",
  "image": "https://seusite.com/img/onibus.jpg",
  "body": [
    "Primeiro parágrafo.",
    "Segundo parágrafo."
  ]
}

Cada item de body vira um parágrafo. Texto puro, sem HTML. A leitura usa letra grande, confortável a 3 metros da TV.

Rádio fixa

Com o campo player no tevix.json, o app mostra uma barra de rádio sempre visível. O ouvinte navega pelas notícias enquanto escuta. Qualquer item com audio: também toca nessa barra. Use um stream direto (.mp3 ou .aac), não uma página de player.

Ícones do menu

home live news video radio play movie tv music settings info link web star search list. Nomes de ícones Material Design (play-circle-outline, live-tv, ondemand-video…) são convertidos automaticamente; nomes desconhecidos viram um ponto.

Exemplo completo para copiar

O app de demonstração "Portal Cidade" está publicado e pode servir de modelo. Baixe os arquivos, troque textos, imagens e URLs e publique no seu servidor:

• tevix.json (identidade, menu e rádio)
• inicio.json (hero, carrossel e lista), noticias.json (grade), radio.json (áudio e content:)
• materia/1234.json (matéria)

Para ver no app: abra o TEVIX e digite 8CR-EEC.

Hospedagem e CORS

Os arquivos JSON ficam no seu servidor, em qualquer hospedagem que sirva arquivos estáticos. O aparelho busca direto de lá, então duas coisas são obrigatórias:

1. Liberar CORS: o servidor precisa responder com o cabeçalho Access-Control-Allow-Origin: * nos JSON (e nas imagens, se quiser).
2. HTTPS sempre que possível. Certificados gratuitos (Let's Encrypt) resolvem.

location ~* \.json$ {
    add_header Access-Control-Allow-Origin * always;
    add_header Cache-Control "public, max-age=300";
}

<FilesMatch "\.json$">
    Header set Access-Control-Allow-Origin "*"
    Header set Cache-Control "public, max-age=300"
</FilesMatch>

Gerar os arquivos automaticamente

Você não precisa escrever JSON à mão. Qualquer coisa que gere um arquivo de texto serve:

• Site WordPress / RSS: um script (PHP, Python, Node) lê o feed RSS e grava inicio.json e noticias.json a cada 5 minutos. Título → title, resumo → desc, imagem destacada → image, link da matéria → gere um materia/ID.json com o texto.
• Rádio: um radio.json fixo com o stream e a programação; mude o subtitle do player com o programa do momento.
• Vídeos: a API do YouTube ou do seu CDN lista os últimos vídeos; use video: com o MP4/HLS direto. Páginas do YouTube não tocam dentro do app; é preciso o arquivo de mídia.

Testar o seu app

1. Abra o TEVIX no navegador (ou na TV) e digite o seu código. Na área do parceiro há o botão Testar meu app agora, que já entra com o código.
2. Navegue com as setas do teclado (ou do controle) e OK/Enter. Voltar: Backspace ou Esc.
3. Mudou um JSON? Vá em Configurações → Limpar cache e recarregar dentro do app.
4. Erro "Não foi possível carregar esta página" mostra a URL e o motivo (404, CORS, JSON inválido). Valide o JSON em um validador online antes de publicar.
5. Em Configurações → Verificar código agora o app consulta o servidor do TEVIX na hora (útil logo após renovar o plano).

Dicas para ficar bom na TV

• Imagens 16:9 e leves (JPG até 150 KB). Sem texto pequeno dentro da imagem.
• Títulos curtos. Na TV o texto é lido a 3 metros.
• Até 8 itens no menu. Comece pelo que o público mais usa (Ao vivo, Início).
• Para ao vivo, use HLS (.m3u8) com 2 ou 3 qualidades. MP4 progressivo serve para vídeos curtos.
• Se você usa o tipo Site, garanta que o site tenha foco visível e funcione com Tab/setas; sem mouse, o usuário só tem o controle.

Planos, teste e vencimento

Para contratar ou renovar, use o contato mostrado na área do parceiro. O código é sempre o mesmo: o seu público não precisa digitar nada de novo.

Área do parceiro

Em /parceiro você entra com o código e a senha escolhida no cadastro. Lá você pode:

• Ver a situação do plano, a validade e quantos aparelhos usaram o app nos últimos 7 dias.
• Trocar a URL do conteúdo, o nome, a cor e o logo. Os aparelhos atualizam na próxima abertura.
• Copiar as instruções prontas para divulgar ao público.
• Testar o app com um clique e trocar a sua senha.

Perguntas frequentes