Installation

Downloads

Download from cdn.ffffinance.org or the download buttons on the homepage.

Platform	Artifact	Notes
Windows	FFFFinance-Setup.exe	NSIS installer
macOS (Apple Silicon)	FFFFinance-arm64.dmg	M1/M2/M3/M4 Macs
macOS (Intel)	FFFFinance-x64.dmg	2016 MacBook Air and other Intel Macs
Linux	FFFFinance.AppImage	chmod +x to run
Linux	FFFFinance.deb	Debian / Ubuntu
Linux	FFFFinance.rpm	Fedora / RHEL

macOS

Two separate DMGs are available — download the one that matches your Mac:

• Apple Silicon (M1/M2/M3/M4): FFFFinance-arm64.dmg
• Intel (2016 MacBook Air, older iMacs, etc.): FFFFinance-x64.dmg

Unsigned app warning

FFFFinance is not yet signed with an Apple Developer ID certificate. macOS will block the app on first launch.

macOS Sequoia (15+):

xattr -cr /Applications/FFFFinance.app

Or: System Settings > Privacy & Security > Open Anyway.

macOS Sonoma (14) and earlier:

Right-click the app > Open > Open in the confirmation dialog.

Build from source

Prerequisites

Requirement	Why
Node.js 20+	Runtime and build tooling
npm	Package management
Git	Clone the repo
C++ compiler	Required by the native database module

C++ compiler by platform:

• Linux: sudo apt install build-essential (Debian/Ubuntu) or equivalent
• macOS: xcode-select --install
• Windows: Visual Studio Build Tools with "Desktop development with C++"

Steps

git clone https://github.com/megasupersoft/FFFFinance.git
cd FFFFinance_app
npm install

Run in development mode:

npm run electron

Package a distributable:

npm run electron:build

Key scripts

Script	Command	What it does
electron	npm run electron	Compile + launch Electron with Vite dev server
dev	npm run dev	Vite dev server only (browser, mock data)
build	npm run build	TypeScript check + Vite production build
electron:build	npm run electron:build	Full production build + electron-builder package
test	npm test	Run Vitest test suite