Launcher de jogos para Windows 11 com experiência de console: gamepad-first, temas Fullscreen do Playnite 10 e integração com o Windows Full Screen Experience (FSE). Status: planejamento / Marco 0.
- Produto e backlog:
docs/PRD.md - Por onde começar:
docs/ROADMAP.md - Biblioteca, metadados e artes:
docs/metadados.md - Criar temas (API de temas e
tako theme check):docs/themes/ - Como contribuir (Git Flow, commits, PRs, DoD, arquitetura):
CONTRIBUTING.md - Decisões de arquitetura:
docs/adr/
Na página de releases, no mesmo formato do Console Mode:
- Instalador:
Tako-Setup-x64.exe— instala para o seu usuário (sem administrador), com atalho no Menu Iniciar; dados em%LOCALAPPDATA%\Tako.
Depois de instalado, o Tako se atualiza sozinho: ao abrir, baixa a versão nova em segundo plano (conferida pelo SHA-256 do GitHub) e instala ao reiniciar ou ao sair. Para gerar localmente os pacotes: .\build\rust\Package-Tako.ps1 (o instalador do Windows precisa do Inno Setup 6).
crates/
tako/ executável principal e ponto de entrada
tako-app/ composição da aplicação e ciclo de vida
tako-core/ biblioteca, catálogo, persistência e i18n
tako-platform/ integrações com SO (janela, áudio, monitores, FSE)
tako-sources/ leitores de lojas (Steam, Epic, Playnite, ROMs)
tako-themes/ motor de temas
tako-ui/ interface nativa (Slint)
tako-web/ hospedeiro web (Chromium/CEF)
web/ interface web em React + TypeScript
design/ (fora do git) worktree da branch `design-system`, ver abaixo
build/
rust/ scripts de empacotamento (Package-Tako.ps1, package.sh, instaladores)
packaging/ arquivos de empacotamento e manifesto FSE
O design system (prévias, tokens, fontes, ícones e o protótipo) vive só na branch design-system, fora da main e
da develop. Para trabalhar nele junto do código, faça o checkout dela em design/ (já ignorada pelo git):
git fetch origin design-system
git worktree add design design-systemO build não precisa dela: web/src/ traz a cópia gerada por npm run sync:design.
Requer Rust (edição 2024, ver rust-toolchain.toml), Node 24 e npm (para a interface web). No Windows, o CMake do Visual Studio Build Tools pode ser necessário para compilações com SDL3.
Rodar o launcher (biblioteca real: jogos da Steam + adicionados):
cargo run -p takoControle Xbox (XInput), controle PlayStation (DualSense, DualSense Edge ou DualShock 4, por USB ou Bluetooth, lido direto por HID), teclado ou mouse.
| Ação | Controle Xbox | PlayStation | Teclado |
|---|---|---|---|
| Navegar | Direcional ou analógico esquerdo | Direcional ou analógico esquerdo | Setas |
| Selecionar / voltar | A / B | ✕ / ○ | Enter / Esc |
| Favoritar · buscar | X · Y | □ · △ | F · / |
| Trocar de seção | LB / RB | L1 / R1 | Q / E |
| Configurações (ou ações da capa em foco) | Menu (☰) | Options | M |
| Central de Controle (abrir e fechar, durante o jogo) | segurar View + Y por meio segundo | segurar Create + △ (Share + △ no DualShock 4) | Ctrl+Shift+Tab |
O atalho da Central muda em Configurações › "Abrir a Central de Controle no controle" e "… no teclado" (há "Restaurar atalhos padrão"). O Guia/PS e o Shift+Tab não abrem mais a Central: o Guia abre a Barra de Jogo do Xbox e a Steam, e o Shift+Tab é a sobreposição da Steam. Com um jogo em janela ou em tela cheia sem bordas, a Central abre por cima do jogo, que continua rodando atrás; em tela cheia exclusiva, o Tako vem para a frente com a arte do jogo (detalhes no DESIGN.md, Menu rápido).
Dados do usuário e caches ficam em %LOCALAPPDATA%\Tako na versão instalada, ou em Tako_Data ao lado do executável ao rodar em desenvolvimento; nenhuma arte de jogo vai para o repositório.
Comandos de validação e testes:
cargo fmt --all --check
cargo clippy --workspace --all-targets -- -D warnings
cargo test --workspaceInterface web:
cd web
npm install
npm run typecheck
npm run buildAGPL-3.0-only, a mesma do Console Mode, de onde vêm partes do código. Fontes sob a SIL OFL 1.1 e o tema padrão do Playnite sob MIT, cada um com o aviso na própria pasta.
