Instalação avançada

#Todos os downloads

Os arquivos são servidos pelo Cloudflare R2, não pelo GitHub Releases, e só as 10 versões mais recentes são mantidas. A página de download lista todas elas.

As versões até a 0.1.x foram publicadas com o nome antigo, como MOVIE-ADE-<version>-…. Os nomes Ferret-… começam na 0.2.0.

#Verificar o download (SHA256SUMS assinado)

Cada versão tem um arquivo SHA256SUMS e a assinatura dele, SHA256SUMS.sig. A assinatura é feita com a chave de release do Ferret, que fica separada do servidor de download; assim, um instalador alterado no servidor de download não pode vir acompanhado de uma assinatura válida. A chave pública não é obtida do servidor de download: pegue-a no repositório (build/release-signing/allowed_signers (abre em uma nova aba)) ou copie daqui:

[email protected] ssh-ed25519 AAAAC3NzaC1lZDI1NTE5AAAAIEpXERU8ST0MEOIMbzoL4zShkjIrMB4++NL3xBohKAS9

A impressão digital dela é SHA256:c7dvwwJQyY9qSstkmrO8JoVZ90DCaFZBAzjqV04N8zQ. Os mesmos arquivos estão anexados a cada release no GitHub. Verifique a assinatura com o ssh-keygen (incluído no macOS, no Windows 10 e posteriores e no Linux) e depois compare o hash do arquivo baixado com a lista assinada:

# the download server (currently the R2 public URL; it may move to a custom domain)
BASE=https://pub-588d93b3e875464f98d6cf98dc711a0c.r2.dev
VERSION=$(curl -s $BASE/latest.json | jq -r .version)
curl -sO $BASE/releases/$VERSION/SHA256SUMS
curl -sO $BASE/releases/$VERSION/SHA256SUMS.sig

# save the public key above as allowed_signers, then:
ssh-keygen -Y verify -f allowed_signers -I [email protected] -n ferret-release -s SHA256SUMS.sig < SHA256SUMS
# → Good "ferret-release" signature for [email protected] …

# macOS
shasum -a 256 -c SHA256SUMS --ignore-missing
# Linux
sha256sum -c SHA256SUMS --ignore-missing

# Windows (PowerShell): compare with the line for your file in SHA256SUMS
Get-FileHash .\Ferret-<version>-win-x64.exe -Algorithm SHA256

Pare se o ssh-keygen não exibir Good "ferret-release" signature ou se o hash não estiver na lista. O Verificar atualizações do Ferret faz a mesma verificação com a chave embutida no app e não oferece uma versão cuja assinatura não confere. No macOS, você também pode verificar a assinatura Developer ID e a notarização com spctl -a -vv /Applications/Ferret.app. Para as versões até a 0.3.0, compare com os hashes em releases/<version>/manifest.json.

#Versões antigas no macOS

Para as versões até a 0.2.0 build 2: se o macOS disser que não é possível verificar o desenvolvedor, feche a caixa de diálogo, abra Ajustes do Sistema → Privacidade e Segurança, clique em Abrir Mesmo Assim ao lado da mensagem sobre o Ferret e confirme com Abrir. Se aparecer que o app "está danificado", remova o atributo de quarentena:

xattr -dr com.apple.quarantine /Applications/Ferret.app

#Compilar a partir do código-fonte

Requer Node.js 20+ (a CI e o desenvolvimento local usam a 22), pnpm e git.

git clone https://github.com/JapanMarketing-Dev/ferret.git
cd ferret
pnpm install          # postinstall prepares node-pty for Electron
pnpm dev              # run in development mode

Para gerar os instaladores (saída em dist/release/, configuração em electron-builder.config.cjs). A versão para Linux só pode ser gerada no Linux.

pnpm dist:mac     # dmg (arm64, x64)
pnpm dist:win     # NSIS installers (x64, arm64)
pnpm dist:linux   # AppImage + deb (x64)

Os scripts build:<os>:dev geram apenas o app descompactado (--dir), o que é mais rápido para testes locais.

No Windows, o pnpm install usa os binários pré-compilados que acompanham o node-pty em vez de recompilá-lo (o que exigiria as ferramentas de build C++ do Visual Studio). Defina ADE_FORCE_NATIVE_REBUILD=1 para forçar a recompilação.

Se o terminal informar que não foi possível carregar o node-pty, execute pnpm rebuild:native.

#Atualizações

O Ferret não se atualiza automaticamente. No rodapé, abra Atualizações e clique em Verificar atualizações. Ele busca o latest.json no servidor de download (R2), compara as versões e verifica a assinatura do SHA256SUMS daquela versão com a chave de release embutida no app. Quando houver uma versão mais nova, clique em Baixar: o Ferret baixa o instalador para o seu computador, confere se o SHA-256 dele corresponde ao SHA256SUMS assinado, salva-o na pasta Downloads e o mostra lá. A página de download faz a mesma verificação no navegador antes de salvar um arquivo. Nada é verificado até você clicar, e nada é instalado automaticamente.