インストールの詳細

#すべてのダウンロード

ファイルは GitHub Releases ではなく Cloudflare R2 から配っており、残すのは新しい10版だけです。ダウンロードページにそのすべてが並んでいます。

0.1.x までは旧名で、MOVIE-ADE-<version>-… として公開していました。Ferret-… の名前は 0.2.0 からです。

#ダウンロードを検証する（署名付き SHA256SUMS）

どの版にも SHA256SUMS ファイルと、その署名 SHA256SUMS.sig が付いています。署名には Ferret のリリース鍵を使い、この鍵はダウンロードサーバーとは別に保管しています。そのため、ダウンロードサーバー上でインストーラーが書き換えられても、正しい署名は付けられません。公開鍵はダウンロードサーバーから取らないでください。リポジトリ（build/release-signing/allowed_signers （新しいタブで開きます））から取るか、ここからコピーします。

[email protected] ssh-ed25519 AAAAC3NzaC1lZDI1NTE5AAAAIEpXERU8ST0MEOIMbzoL4zShkjIrMB4++NL3xBohKAS9

フィンガープリントは SHA256:c7dvwwJQyY9qSstkmrO8JoVZ90DCaFZBAzjqV04N8zQ です。同じファイルは GitHub の各リリースにも添付しています。ssh-keygen（macOS、Windows 10 以降、Linux に入っています）で署名を確かめ、ダウンロードしたファイルのハッシュを署名済みの一覧と比べます。

# 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

ssh-keygen が Good "ferret-release" signature と出さないとき、またはハッシュが一覧に無いときは、使わずに止めてください。Ferret の 更新を確認 も、アプリに組み込んだ鍵で同じ確認をし、署名が合わない版は案内しません。macOS では spctl -a -vv /Applications/Ferret.app で Developer ID の署名と公証も確かめられます。0.3.0 までの版は、releases/<version>/manifest.json にあるハッシュと比べてください。

#古い版の macOS

0.2.0 build 2 までの版で、macOS が「開発元を検証できません」と出したときは、ダイアログを閉じて システム設定 → プライバシーとセキュリティ を開き、Ferret のメッセージの横の このまま開く を押し、開く で確定します。「壊れている」と出るときは、検疫属性を外します。

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

#ソースからビルドする

Node.js 20 以上（CI と手元の開発では 22）、pnpm、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

インストーラーを作るには次を使います（出力は dist/release/、設定は electron-builder.config.cjs）。Linux 版のビルドは Linux でしか動きません。

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

build:<os>:dev スクリプトは展開済みのアプリだけ（--dir）を作るので、手元での確認には速く済みます。

Windows では、pnpm install は再ビルドせず、node-pty に同梱のビルド済みバイナリを使います（再ビルドには Visual Studio の C++ ビルドツールが要るため）。再ビルドさせたいときは ADE_FORCE_NATIVE_REBUILD=1 を設定します。

ターミナルに node-pty を読み込めなかったと出るときは、pnpm rebuild:native を実行してください。

#アップデート

Ferret は自動ではアップデートしません。フッターの アップデート を開き、更新を確認 を押します。ダウンロードサーバー（R2）から latest.json を取って版を比べ、その版の SHA256SUMS の署名をアプリに組み込んだリリース鍵で確かめます。新しい版があれば ダウンロード を押します。Ferret は自分のパソコン用のインストーラーをダウンロードし、その SHA-256 が署名済みの SHA256SUMS と合うかを確かめてから、ダウンロードフォルダに保存してそこで表示します。ダウンロードページも、ファイルを保存する前にブラウザの中で同じ確認をします。押すまでは何も確認せず、自動で入れることもありません。