Instalasi

#Unduh

Ambil file untuk OS dan CPU Anda dari halaman Unduh. File disajikan dari Cloudflare R2, bukan GitHub Releases, dan hanya 10 versi terbaru yang disimpan.

Rilis hingga 0.1.x diterbitkan dengan nama lama, sebagai MOVIE-ADE-<version>-…. Nama Ferret-… dimulai sejak 0.2.0.

#Memverifikasi unduhan (SHA256SUMS bertanda tangan)

Setiap rilis memiliki file SHA256SUMS beserta tanda tangannya, SHA256SUMS.sig. Tanda tangan dibuat dengan kunci rilis Ferret, yang disimpan terpisah dari server unduhan, sehingga installer yang diubah di server unduhan tidak mungkin disertai tanda tangan yang valid. Kunci publiknya tidak diambil dari server unduhan: ambil dari repositori (build/release-signing/allowed_signers (terbuka di tab baru)) atau salin dari sini:

[email protected] ssh-ed25519 AAAAC3NzaC1lZDI1NTE5AAAAIEpXERU8ST0MEOIMbzoL4zShkjIrMB4++NL3xBohKAS9

Fingerprint-nya adalah SHA256:c7dvwwJQyY9qSstkmrO8JoVZ90DCaFZBAzjqV04N8zQ. File yang sama juga dilampirkan pada setiap rilis di GitHub. Periksa tanda tangannya dengan ssh-keygen (sudah tersedia di macOS, Windows 10 ke atas, dan Linux), lalu bandingkan hash unduhan Anda dengan daftar yang ditandatangani:

# 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

Hentikan jika ssh-keygen tidak mencetak Good "ferret-release" signature atau hash-nya tidak ada di daftar. Periksa Pembaruan di Ferret melakukan pemeriksaan yang sama dengan kunci yang tertanam di aplikasi dan tidak menawarkan versi yang tanda tangannya tidak cocok. Di macOS, Anda juga bisa memeriksa tanda tangan Developer ID dan notarisasi dengan spctl -a -vv /Applications/Ferret.app. Installer Windows dan Linux belum ditandatangani kodenya oleh Microsoft maupun distribusi Linux. Rilis hingga 0.3.0 diterbitkan sebelum penandatanganan dimulai dan hanya memiliki hash tanpa tanda tangan di releases/<version>/manifest.json.

#macOS

1. Buka file .dmg lalu seret Ferret.app ke /Applications.
2. Jalankan. Aplikasi ini ditandatangani dengan Developer ID dan dinotarisasi oleh Apple (tiketnya sudah di-staple), sehingga terbuka tanpa peringatan.

Untuk memeriksa tanda tangannya sendiri:

spctl -a -vv /Applications/Ferret.app
# accepted
# source=Notarized Developer ID

Khusus versi lama (0.2.0 build 2 dan sebelumnya) yang belum ditandatangani. Untuk versi tersebut, macOS menyatakan bahwa pengembangnya tidak dapat diverifikasi: tutup dialognya, buka Pengaturan Sistem → Privasi & Keamanan, klik Tetap Buka di samping pesan tentang Ferret, lalu konfirmasi dengan Buka. Jika muncul pesan bahwa aplikasi "rusak", hapus atribut karantinanya:

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

#Windows

1. Jalankan Ferret-<version>-win-<arch>.exe.
2. Saat SmartScreen menampilkan "Windows melindungi PC Anda", klik Info selengkapnya, lalu Tetap jalankan.
3. Pilih folder instalasi. Installer membuat pintasan di desktop.

#Linux

AppImage:

chmod +x Ferret-<version>-linux-x86_64.AppImage
./Ferret-<version>-linux-x86_64.AppImage

Debian / Ubuntu:

sudo apt install ./Ferret-<version>-linux-amd64.deb

Paket deb memasang paket dan perintah ferret.

Di Ubuntu 23.10 ke atas, AppImage bisa berhenti saat diluncurkan dengan error sandbox, karena AppArmor membatasi user namespace yang dipakai sandbox Electron. Gunakan .deb sebagai gantinya; paket ini menyiapkan helper sandbox.

#Build dari kode sumber

Memerlukan Node.js 20+ (CI dan pengembangan lokal memakai 22), pnpm, dan 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

Untuk membuat paket installer (hasilnya di dist/release/, konfigurasinya di electron-builder.config.cjs). Build Linux hanya berjalan di Linux.

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

Skrip build:<os>:dev hanya menghasilkan aplikasi yang belum dipaketkan (--dir), yang lebih cepat untuk pengujian lokal.

Di Windows, pnpm install memakai binary prebuilt bawaan node-pty alih-alih membangun ulang (yang memerlukan Visual Studio C++ build tools). Atur ADE_FORCE_NATIVE_REBUILD=1 untuk memaksa build ulang.

Jika terminal melaporkan bahwa node-pty tidak dapat dimuat, jalankan pnpm rebuild:native.

#Pembaruan

Ferret tidak memperbarui dirinya secara otomatis. Di footer, buka Pembaruan lalu klik Periksa Pembaruan. Ferret mengambil latest.json dari server unduhan (R2), membandingkan versinya, dan menautkan ke halaman unduhan. Sejak 0.4.0, Ferret juga memeriksa tanda tangan SHA256SUMS versi tersebut dengan kunci rilis yang tertanam di aplikasi, dan tidak menawarkan versi yang tanda tangannya tidak dapat diverifikasi. Tidak ada yang diperiksa sampai Anda mengklik, dan tidak ada yang dipasang secara otomatis.