Reveja qualquer sessão da Fórmula 1 como se estivesse no muro dos boxes.
Mapa da pista ao vivo, tabela de tempos, telemetria, estratégia de pneus e muito mais, em português e rodando no seu computador.
▶ Ver o vídeo em alta qualidade (MP4)
É o chamado que todo fã conhece: quando o engenheiro quer o piloto nos boxes, ele diz pelo rádio “box, box”. O nome resume a ideia do projeto: trazer para a sua tela a visão de quem acompanha a corrida pelos dados, do pit wall. O logo segue a mesma ideia, com um balão de rádio e duas setas de entrada do pit, uma para cada “box”.
![]() |
![]() |
| Temporada: cada etapa com o desenho da pista | Replay: mapa, tabela e controles |
![]() |
![]() |
| Telemetria de pilotos selecionados | Estratégia de pneus de toda a grade |
![]() |
![]() |
| Campeonato “se a ordem ficar assim” | Modelo de pneus ajustado à corrida |
![]() |
![]() |
| Safety Car simulado no fim da corrida | Análise de voltas ao lado do mapa, com telemetria ao vivo |
O Box Box não guarda dados de ninguém nem depende de um servidor central. Cada sessão é baixada e processada uma única vez no seu computador e depois abre na hora.
| Fonte | Para quê | Precisa de conta? |
|---|---|---|
| OpenF1 | Voltas, posições, telemetria, pneus, pit stops e direção de prova (2023 em diante) | Não |
| F1 TV (via FastF1) | Dados direto da F1, sessões mais recentes e a transmissão | Sim, assinatura F1 TV |
| Jolpica | Classificação do campeonato | Não |
| MultiViewer | Traçado e curvas de cada circuito | Não |
Sem login, o app usa o OpenF1 automaticamente. As corridas mais recentes podem levar alguns dias para chegar lá; se você tiver F1 TV, é só entrar pelo botão F1 TV no topo para baixá-las direto da F1.
Você só precisa do Docker Desktop.
1. Baixe o projeto
git clone https://github.com/Wedrock/Projetos-F1.git
cd Projetos-F1/box-box
2. Crie o arquivo de configuração
cp .env.example .env
Abra o .env e preencha F1TV_SECRET_KEY com uma chave aleatória. É ela que protege o seu login do F1 TV, caso você use. Para gerar uma:
openssl rand -hex 32
3. Suba o app
docker compose up -d
4. Abra http://localhost:8000, escolha uma etapa e uma sessão. Na primeira vez, a sessão leva alguns minutos para baixar; depois disso, abre na hora.
Prefere um programa normal, sem Docker? O Box Box também roda como app de Windows: um instalador, um ícone no menu Iniciar e o app abre na própria janela.
1. Baixe o instalador BoxBox-Setup-<versão>.exe na página de Releases (ou nos Artifacts de uma execução do workflow App para Windows, na aba Actions).
2. Instale. Não pede senha de administrador. Se o Windows SmartScreen avisar que o app é desconhecido, clique em Mais informações → Executar assim mesmo (o instalador não é assinado).
3. Abra o Box Box pelo menu Iniciar ou pela área de trabalho. Ele sobe o servidor sozinho, só para este computador, e fecha junto com a janela.
%LOCALAPPDATA%\BoxBox e não são apagados ao atualizar ou desinstalar.%LOCALAPPDATA%\BoxBox\.env com as mesmas chaves do .env.example. Não é obrigatório preencher F1TV_SECRET_KEY: sem ela, o app gera uma chave no seu perfil do Windows.%LOCALAPPDATA%\BoxBox\boxbox.log.Gerar o instalador você mesmo. No Windows, com Python 3.11, Node.js 20 e Inno Setup 6 instalados:
cd box-box\desktop
.\build-windows.ps1
O resultado fica em box-box\desktop\dist. Pelo GitHub, rode o workflow App para Windows na aba Actions, ou crie uma tag v* (por exemplo v2.5.1) para publicar o instalador numa Release.
As opções ficam no .env. Todas têm um valor padrão sensato; mude só o que precisar.
| Variável | O que faz | Padrão |
|---|---|---|
PORT |
Porta do app no seu computador | 8000 |
DATA_SOURCE |
auto usa o OpenF1 sem login e o F1 TV com login; openf1 ou f1tv forçam uma fonte |
auto |
F1TV_SECRET_KEY |
Chave que criptografa o login do F1 TV salvo | — |
F1_USERNAME / F1_PASSWORD |
Login do F1 TV pelo arquivo, em vez de pela tela | — |
AUTO_PRECOMPUTE |
Baixa sessões sozinho nos fins de semana: off, race, race+qual ou all |
race+qual |
BIND_ADDRESS |
Quem pode acessar a porta; 0.0.0.0 libera a rede local |
127.0.0.1 |
ALLOWED_HOSTS |
Endereços aceitos pelo servidor, separados por vírgula | localhost,127.0.0.1 |
AUTH_ENABLED / AUTH_PASSPHRASE |
Pede uma frase de acesso para abrir o app | desligado |
TEAM_RADIO_CAPTIONS / TEAM_RADIO_MODEL |
Legendas do rádio e o modelo Whisper usado | ligado / small.en |
GEMINI_API_KEY |
Legendas do rádio em português e inglês, pelo Gemini (chave grátis em aistudio.google.com). Também dá para colar a chave no app: Configurações → Rádio das equipes → Legendas em português (dentro de um replay) | — |
OPENROUTER_API_KEY |
Liga os recursos de IA (correção de legendas e sincronização por foto) | — |
STORAGE_MODE |
local ou r2 (Cloudflare R2) para guardar as sessões |
local |
127.0.0.1 e o servidor só responde a localhost, o que protege contra acesso pela rede e contra ataques de DNS rebinding. Para abrir na rede local, ajuste BIND_ADDRESS e ALLOWED_HOSTS e ligue AUTH_ENABLED: quem acessa o app pode usar o seu login do F1 TV.GEMINI_API_KEY ou OPENROUTER_API_KEY. Com o Gemini, o áudio dos rádios vai para o Google; no plano grátis, o Google pode usar esse conteúdo para melhorar os modelos dele.box-box/
├── backend/ API em Python (FastAPI)
│ ├── routers/ Rotas: sessões, replay, telemetria, análises, circuitos...
│ ├── services/
│ │ ├── f1_data.py Monta o replay a partir dos dados da sessão
│ │ ├── openf1_source.py Usa o OpenF1 como fonte quando não há login
│ │ ├── tyre_model.py Modelo bayesiano de desgaste dos pneus
│ │ ├── standings.py Classificação do campeonato
│ │ └── circuits.py Nomes e traçados dos circuitos
│ └── tests/ Testes automáticos
├── frontend/ Interface em Next.js, React e Tailwind
│ └── src/
│ ├── app/ Páginas: início, replay, ao vivo, recursos, sobre
│ ├── components/ Mapa, tabela, telemetria, painel de análises...
│ └── lib/ Desenho da pista, modelo de pneus, utilidades
├── desktop/ App para PC: janela própria, PyInstaller e instalador
├── docs/media/ Vídeo e capturas deste README
├── Dockerfile Um único contêiner com frontend e backend
└── docker-compose.yml
O frontend é compilado como site estático e servido pelo próprio backend, então tudo roda em um só contêiner e em uma só porta.
Rodar os testes do backend sem instalar Python, usando o Docker:
docker run --rm -v "$(pwd)/backend:/app" -w /app python:3.12-slim sh -c "pip install -q numpy httpx pytest && python -m pytest -q tests"
Checar os tipos do frontend:
cd frontend && npm ci && npx tsc --noEmit
O Box Box nasceu da junção de dois projetos de código aberto, ambos sob a licença MIT:
Também agradecemos ao FastF1, ao OpenF1, ao Jolpica e ao MultiViewer pelos dados.
O código está sob a licença MIT. Os dados do OpenF1 seguem a licença CC BY-NC-SA 4.0, ou seja, são para uso pessoal e não comercial.
O Box Box é um projeto independente de fãs. Não é oficial e não tem nenhuma ligação com as empresas da Fórmula 1.