Installazione avanzata

#Tutti i download

I file sono distribuiti da Cloudflare R2, non da GitHub Releases, e vengono conservate solo le 10 versioni più recenti. La pagina di download le elenca tutte.

Le release fino alla 0.1.x sono state pubblicate con il vecchio nome, come MOVIE-ADE-<version>-…. I nomi Ferret-… partono dalla 0.2.0.

#Verificare il download (SHA256SUMS firmato)

Ogni release ha un file SHA256SUMS e la sua firma SHA256SUMS.sig. La firma è creata con la chiave di release di Ferret, conservata separatamente dal server di download: un programma di installazione modificato sul server di download non può quindi avere una firma valida. La chiave pubblica non va presa dal server di download: prendila dal repository (build/release-signing/allowed_signers (si apre in una nuova scheda)) oppure copiala da qui:

[email protected] ssh-ed25519 AAAAC3NzaC1lZDI1NTE5AAAAIEpXERU8ST0MEOIMbzoL4zShkjIrMB4++NL3xBohKAS9

La sua impronta è SHA256:c7dvwwJQyY9qSstkmrO8JoVZ90DCaFZBAzjqV04N8zQ. Gli stessi file sono allegati a ogni release su GitHub. Controlla la firma con ssh-keygen (incluso in macOS, Windows 10 e successivi e Linux), poi confronta l'hash del file scaricato con l'elenco firmato:

# 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

Fermati se ssh-keygen non stampa Good "ferret-release" signature o se l'hash non è nell'elenco. Verifica aggiornamenti di Ferret esegue lo stesso controllo con la chiave integrata nell'app e non propone una versione la cui firma non corrisponde. Su macOS puoi anche controllare la firma Developer ID e la notarizzazione con spctl -a -vv /Applications/Ferret.app. Per le release fino alla 0.3.0, confronta con gli hash in releases/<version>/manifest.json.

#Versioni precedenti per macOS

Per le versioni fino alla 0.2.0 build 2: se macOS dice che lo sviluppatore non può essere verificato, chiudi la finestra di dialogo, apri Impostazioni di Sistema → Privacy e sicurezza, fai clic su Apri comunque accanto al messaggio su Ferret e conferma con Apri. Se dice che l'app "è danneggiata", rimuovi l'attributo di quarantena:

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

#Compilare dai sorgenti

Servono Node.js 20+ (la CI e lo sviluppo locale usano la 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

Per creare i programmi di installazione (output in dist/release/, configurazione in electron-builder.config.cjs). La build per Linux funziona solo su Linux.

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

Gli script build:<os>:dev producono solo un'app non impacchettata (--dir), più veloce per i test in locale.

Su Windows, pnpm install usa i binari precompilati inclusi in node-pty invece di ricompilarli (servirebbero gli strumenti di compilazione C++ di Visual Studio). Imposta ADE_FORCE_NATIVE_REBUILD=1 per forzare la ricompilazione.

Se il terminale segnala che non è stato possibile caricare node-pty, esegui pnpm rebuild:native.

#Aggiornamenti

Ferret non si aggiorna automaticamente. Nel footer apri Aggiornamenti e fai clic su Verifica aggiornamenti. L'app scarica latest.json dal server di download (R2), confronta le versioni e controlla la firma del file SHA256SUMS di quella versione con la chiave di release integrata nell'app. Quando è disponibile una versione più recente, fai clic su Scarica: Ferret scarica il programma di installazione per il tuo computer, controlla che il suo SHA-256 corrisponda al file SHA256SUMS firmato, lo salva nella cartella Download e te lo mostra lì. La pagina di download esegue lo stesso controllo nel browser prima di salvare un file. Nulla viene controllato finché non fai clic, e nulla viene installato automaticamente.