Installation avancée

#Tous les téléchargements

Les fichiers sont servis depuis Cloudflare R2, et non depuis GitHub Releases, et seules les 10 versions les plus récentes sont conservées. La page de téléchargement les liste toutes.

Les versions jusqu'à 0.1.x ont été publiées sous l'ancien nom, en MOVIE-ADE-<version>-…. Les noms Ferret-… commencent avec la 0.2.0.

#Vérifier le téléchargement (SHA256SUMS signé)

Chaque version est accompagnée d'un fichier SHA256SUMS et de sa signature SHA256SUMS.sig. La signature est faite avec la clé de publication de Ferret, conservée à l'écart du serveur de téléchargement : un installeur modifié sur ce serveur ne peut donc pas être accompagné d'une signature valide. La clé publique n'est pas récupérée depuis le serveur de téléchargement : prenez-la dans le dépôt (build/release-signing/allowed_signers (s'ouvre dans un nouvel onglet)) ou copiez-la ici :

[email protected] ssh-ed25519 AAAAC3NzaC1lZDI1NTE5AAAAIEpXERU8ST0MEOIMbzoL4zShkjIrMB4++NL3xBohKAS9

Son empreinte est SHA256:c7dvwwJQyY9qSstkmrO8JoVZ90DCaFZBAzjqV04N8zQ. Les mêmes fichiers sont joints à chaque version sur GitHub. Vérifiez la signature avec ssh-keygen (inclus dans macOS, Windows 10 et versions ultérieures, et Linux), puis comparez l'empreinte de votre téléchargement avec la liste signée :

# 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

Arrêtez-vous si ssh-keygen n'affiche pas Good "ferret-release" signature ou si l'empreinte ne figure pas dans la liste. La fonction Rechercher des mises à jour de Ferret fait la même vérification avec la clé intégrée à l'application et ne propose pas une version dont la signature ne correspond pas. Sur macOS, vous pouvez aussi vérifier la signature Developer ID et la notarisation avec spctl -a -vv /Applications/Ferret.app. Pour les versions jusqu'à 0.3.0, comparez avec les empreintes de releases/<version>/manifest.json.

#Anciennes versions pour macOS

Pour les versions jusqu'à 0.2.0 build 2 : si macOS indique que le développeur ne peut pas être vérifié, fermez la boîte de dialogue, ouvrez Réglages Système → Confidentialité et sécurité, cliquez sur Ouvrir quand même à côté du message concernant Ferret, puis confirmez avec Ouvrir. Si macOS indique que l'application « est endommagée », supprimez l'attribut de quarantaine :

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

#Compiler depuis les sources

Nécessite Node.js 20+ (la CI et le développement local utilisent la 22), pnpm et 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

Pour produire les installeurs (sortie dans dist/release/, configuration dans electron-builder.config.cjs). La version Linux ne se compile que sous Linux.

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

Les scripts build:<os>:dev produisent uniquement une application non empaquetée (--dir), plus rapide pour les tests en local.

Sous Windows, pnpm install utilise les binaires précompilés fournis avec node-pty au lieu de les recompiler (ce qui exigerait les outils de compilation C++ de Visual Studio). Définissez ADE_FORCE_NATIVE_REBUILD=1 pour forcer la recompilation.

Si le terminal indique que node-pty n'a pas pu être chargé, exécutez pnpm rebuild:native.

#Mises à jour

Ferret ne se met pas à jour automatiquement. Dans le pied de page, ouvrez Mises à jour et cliquez sur Rechercher des mises à jour. Ferret récupère latest.json sur le serveur de téléchargement (R2), compare les versions et vérifie la signature du SHA256SUMS de cette version avec la clé de publication intégrée à l'application. Quand une version plus récente est disponible, cliquez sur Télécharger : Ferret télécharge l'installeur adapté à votre ordinateur, vérifie que son SHA-256 correspond au SHA256SUMS signé, l'enregistre dans votre dossier Téléchargements et l'y affiche. La page de téléchargement fait la même vérification dans votre navigateur avant d'enregistrer un fichier. Rien n'est vérifié tant que vous ne cliquez pas, et rien n'est installé automatiquement.