Docs / How-to guides

Install on macOS

Homebrew or DMG, plus the macFUSE setup for the shared folder.

Requirements

Install with Homebrew

Run these three commands:

brew tap keibisoft/keibidrop
brew trust keibisoft/keibidrop
brew install keibidrop

brew trust is required. Homebrew asks for it before it loads formulas from a third-party tap.

This installs all three commands on your PATH: keibidrop (the app), keibidrop-cli (the terminal client), and kd (the CLI for scripts and agents).

Install from the DMG

If you prefer a normal app install, and your Mac is Apple Silicon:

  1. Download keibidrop-<version>-darwin-arm64.dmg from GitHub Releases.
  2. Open it and drag KeibiDrop to Applications.

The app and every binary inside it are signed with a Developer ID and notarized by Apple. Gatekeeper opens them without warnings.

On an Intel Mac, use Homebrew, or download keibidrop-<version>-darwin-amd64.tar.gz and unpack it.

With the DMG install, the two command-line tools live inside the app bundle: /Applications/KeibiDrop.app/Contents/MacOS/kd and .../keibidrop-cli.

Enable the shared folder (macFUSE)

The shared folder is a virtual filesystem. macOS needs the macFUSE driver for it, installed once:

  1. Download macFUSE from macfuse.github.io and run the installer. Use the official download, not a package manager copy.
  2. Open System Settings, then Privacy & Security.
  3. Scroll down to the message "System software from developer Benjamin Fleischer was blocked". Click Allow. Benjamin Fleischer is the macFUSE maintainer.
  4. Reboot once. macOS loads the driver only after a restart.

If the Allow button does not appear on an Apple Silicon Mac, enable kernel extensions first: shut down, hold the power button to enter Recovery, open Startup Security Utility, and select Reduced Security with kernel extensions. Then repeat the steps above.

You do this once, and again only after a macFUSE update.

macOS 15.4 and later: FSKit

On macOS 15.4 and later, macFUSE can run through Apple's FSKit backend. It runs in user space. No kernel extension, no reboot cycle.

Enable it in System Settings, macFUSE pane, "Use FSKit".

Verify the download

Every release publishes a SHA256SUMS file. To check a downloaded file, put both in one directory and run:

shasum -a 256 --ignore-missing -c SHA256SUMS

The output must say OK for your file.

Next steps