Docs / Reference

Files and Folders Reference

Everything KeibiDrop writes to disk, and where.

Configuration and state

All state lives in one directory: ~/.config/keibidrop/ on every platform (Windows: C:\Users\<you>\.config\keibidrop\).

FileContents
config.tomlSettings. See the configuration reference.
identity.encYour identity key pair, encrypted with ChaCha20-Poly1305.
contacts.encSaved contacts, encrypted the same way.
.master.keyThe master key file (mode 0600). Present only when the OS keychain is not available, for example on headless systems.

The master key is looked up in this order: OS keychain (macOS Keychain, Windows Credential Manager, Linux Secret Service), then the .master.key file, then a passphrase when passphrase_protect is on. Incognito mode writes none of these files.

KeibiDrop does not regenerate identity files by itself. That would silently discard your saved contacts.

Do not sync ~/.config/keibidrop/ to a cloud drive as-is. It holds your identity keys. If the directory must live on synced storage, turn on passphrase_protect first.

Data folders

FolderDefaultPurpose
Save path~/KeibiDrop/ReceivedWhere pulled and received files land.
Mount path~/KeibiDrop/MountThe shared folder while connected in FUSE mode. Empty when not connected.

On Windows the mount is a drive letter, for example K:. The Windows mount point must not already exist. WinFsp creates it at mount time.

On macOS the mount also appears in Finder as the KeibiDrop volume.

Logs

PlatformLog file
macOS~/Library/Logs/KeibiDrop/keibidrop.log
Linux~/.local/share/keibidrop/keibidrop.log
WindowsC:\Users\<you>\.local\share\keibidrop\keibidrop.log

Note the Windows path: it is under .local\share in your user profile, not under AppData. To export a sanitized copy, see Collect logs and report a problem.

Runtime files

FilePurpose
/tmp/kd.sockThe kd daemon socket. Removed on clean shutdown. Override with KD_SOCKET.
<file>.kdbitmapSidecar next to a partial download. It records which blocks arrived, so an interrupted download resumes instead of restarting. Removed when the download completes. In incognito mode, resume across a disconnect does not work.

Release artifacts

Every release on GitHub Releases ships:

ArtifactPlatform
keibidrop-<version>-darwin-arm64.dmgmacOS, Apple Silicon. Signed and notarized.
keibidrop-<version>-<os>-<arch>.tar.gzmacOS and Linux archives.
keibidrop_<version>_<arch>.debDebian and Ubuntu package.
keibidrop-<version>-windows-amd64.zipWindows archive.
SHA256SUMSChecksums for all artifacts.

Each archive contains the three binaries: keibidrop (desktop app), keibidrop-cli (terminal client), and kd (CLI for scripts and agents).

What each package manager installs and what an uninstall leaves behind is covered in How to update or uninstall.