FreeFBM

An Electron application by hidders

---

Download

Pre-built installers for all platforms are available on the Releases page.

Platform	File
macOS (Apple Silicon & Intel)	FreeFBM-x.x.x-mac-*.dmg
Windows	FreeFBM-x.x.x-windows-setup.exe
Linux	FreeFBM-x.x.x-linux-x64.AppImage or .deb

---

Development

Prerequisites

• Node.js v20 or later
• npm v9 or later

Install dependencies

npm install

Run in development

npm start

Build locally

# All platforms (requires appropriate OS or cross-compile toolchain)
npm run dist

# Per platform
npm run build:mac
npm run build:win
npm run build:linux

Build output is written to the dist/ directory.

---

Releasing

Releases are automated via GitHub Actions. To publish a new release:

1. Tag a commit following semver:

   git tag v1.0.0
   git push origin v1.0.0

2. The workflow will build installers for all three platforms and publish them to a GitHub Release automatically.

Pre-release versions (e.g. v1.0.0-beta.1) are marked as pre-releases on GitHub.

---

Code Signing (optional)

To enable code signing and notarization, add the following secrets to your GitHub repository:

macOS:

Secret	Description
APPLE_CERTIFICATE	Base64-encoded .p12 Developer ID certificate
APPLE_CERTIFICATE_PASSWORD	Password for the .p12 file
APPLE_ID	Your Apple ID email
APPLE_APP_SPECIFIC_PASSWORD	App-specific password for notarization
APPLE_TEAM_ID	Your Apple Developer Team ID

Without these secrets, macOS builds will be unsigned. Users will need to allow the app via System Settings > Privacy & Security.

Windows: Code signing can be added via the WIN_CSC_LINK and WIN_CSC_KEY_PASSWORD secrets using a standard .p12 certificate.

---

License

MIT © 2026 hidders