Instalação
Instalação via npm
O jeito recomendado de instalar, em macOS, Windows e Linux.
Com Node.js 18+:
npm i -g @gustavofsilva/kraa && kraa start
O pacote npm é só um instalador. No postinstall ele baixa do
GitHub Release o binário da mesma
versão do pacote, confere o SHA-256 contra o checksums.txt do release e o instala no
diretório do usuário (sem sudo).
Onde o app fica instalado
| SO | Caminho | Arquitetura |
|---|---|---|
| macOS | ~/Applications/Kraa.app | universal (arm64 + x64) |
| Windows | %LOCALAPPDATA%\kraa\kraa.exe | x64 |
| Linux | ~/.local/share/kraa/kraa | x64 e arm64 |
Dependências do sistema
O npm não instala pacotes do sistema. Confira o que o seu SO precisa:
O binário usa GTK3 + WebKit2GTK 4.1. No X11, o xdotool faz a captura e a colagem automáticas:
sudo apt install libgtk-3-0 libwebkit2gtk-4.1-0 # obrigatórias
sudo apt install xdotool # X11Nenhum requisito adicional.
Nenhum pacote extra. Na primeira execução, conceda a permissão de Acessibilidade (veja macOS).
Se o download falhar
Sem internet no momento do npm i, a instalação não quebra: o pacote é instalado sem o
binário. Depois, rode:
kraa install
kraa start também baixa o binário automaticamente se ele ainda não existir.
Variáveis de ambiente
| Variável | Efeito |
|---|---|
KRAA_SKIP_DOWNLOAD=1 | Pula o download no postinstall (útil em CI). |
KRAA_REPO | Repositório dono/repo de onde baixar o release (forks). |
Atualizar e desinstalar
npm i -g @gustavofsilva/kraa@latest # atualiza (baixa o binário da nova versão)
kraa stop
npm rm -g kraa # remove a CLI
O npm rm remove só a CLI. Para apagar o app, remova também o diretório da tabela acima e,
se quiser, a configuração. Desligue antes o início automático
com kraa autostart off.
