Install
Download the build for your OS, then follow the matching steps below.
Prefer the file named like kalfi-…-mac.dmg (not older names without
-mac).
1. Download & open the installer
- Click Download on the homepage (it detects macOS automatically).
- Wait until the download finishes. Check your browser’s downloads bar or the Downloads folder.
- Double-click the
.dmgfile. A small window opens with the Kalfi icon. - Drag Kalfi onto the Applications folder icon.
- Open Finder → Applications and launch Kalfi.
2. If Mac says “Kalfi is damaged and can’t be opened”
This does not mean the file is broken. macOS is blocking apps that are not Apple-notarized yet. Try Method A first (no Terminal).
Method A — Privacy & Security (easiest)
- Open System Settings (Apple menu → System Settings).
- Click Privacy & Security in the left sidebar.
- Scroll to the Security section.
- If Kalfi is listed as blocked, click Open Anyway.
- Confirm, enter your password if asked, then open Kalfi again from Applications.
Tip: “Open Anyway” often appears only after you tried to open Kalfi once.
Method B — Control-click → Open
- Open Finder → Applications and find Kalfi.
- Hold Control and click Kalfi (or right-click / two-finger click).
- Choose Open, then confirm Open again.
Method C — only if A and B still fail
- Open Terminal (⌘ + Space, type Terminal, Enter).
- Paste this line and press Enter:
xattr -cr /Applications/Kalfi.app
- No output is normal. Open Kalfi again from Applications.
-
Download the Windows installer from the homepage
(
.exe, name likekalfi-…-win-setup.exe). - Double-click the file in your Downloads folder.
- If Windows shows Windows protected your PC (SmartScreen): click More info, then Run anyway.
- Follow the installer (Next → Install).
- Open Kalfi from the Start menu or desktop shortcut.
- Download the
.AppImagefrom the homepage download button (Linux is auto-detected). - Make it executable: right-click → Properties → allow “executable” / run as program (wording varies by desktop).
-
Or from a terminal:
chmod +x kalfi-*.AppImage && ./kalfi-*.AppImage - Launch the app, then continue with first-time setup below.