# KeibiDrop

> KeibiDrop connects exactly two computers and shows each other's shared files
> as a normal folder. Content streams on demand when read; edits sync back in
> under a second. End-to-end encrypted (hybrid ML-KEM-1024 + X25519), no cloud,
> no account. macOS, Linux, Windows. Three interfaces share one engine:
> the desktop app (keibidrop), a terminal REPL (keibidrop-cli), and kd, a
> non-interactive CLI for scripts and AI agents. Every kd command prints one
> JSON line {"ok":true,...}; check the "ok" field, not the exit code.
> kdmcp, an MCP server over stdio with 17 tools, is in the repository now
> and ships as a binary from the next release; until then build it with
> `make build-kdmcp`.
> All documentation pages are plain HTML without scripts.

## Docs
- [Documentation hub](https://keibidrop.com/docs/): all sections, terms table, agent notes

## Tutorials
- [Share a folder between two computers](https://keibidrop.com/docs/tutorials/share-a-folder.html): first session with the desktop app on one network
- [A first session in keibidrop-cli](https://keibidrop.com/docs/tutorials/terminal-session.html): REPL from start to a pulled file
- [Script a file transfer with kd](https://keibidrop.com/docs/tutorials/script-with-kd.html): two daemons on one machine, JSON in and out

## How-to guides
- [Install on macOS](https://keibidrop.com/docs/how-to/install-macos.html): Homebrew or DMG, macFUSE setup, FSKit
- [Install on Linux](https://keibidrop.com/docs/how-to/install-linux.html): .deb, fuse3, user_allow_other
- [Install on Windows](https://keibidrop.com/docs/how-to/install-windows.html): .zip or Chocolatey, WinFsp, drive letter
- [Run KeibiDrop on a NAS](https://keibidrop.com/docs/how-to/run-on-a-nas.html): the serving side in a container, image ghcr.io/keibisoft/keibidrop (amd64, arm64), compose file, one-time pairing
- [Edit from a NAS in DaVinci Resolve](https://keibidrop.com/docs/how-to/edit-from-a-nas-in-davinci-resolve.html): media storage order, Direct I/O off, what loads at import, playback, seek and export, the recorded two minute demo
- [Connect two computers](https://keibidrop.com/docs/how-to/connect-two-computers.html): LAN one-click, fingerprint exchange, contacts
- [Work through firewalls and guest WiFi](https://keibidrop.com/docs/how-to/work-through-firewalls.html): IPv6 check, outbound-only bridge, strict_mode
- [Use git on a shared folder](https://keibidrop.com/docs/how-to/use-git.html): remote repos, clone, the two safety rules
- [Use vim, VS Code, and other editors](https://keibidrop.com/docs/how-to/use-editors.html): save patterns, conflicts, macOS live edits
- [Edit photos in GIMP and other image editors](https://keibidrop.com/docs/how-to/use-image-editors.html): tested save patterns, hand-off
- [Work on video and audio projects](https://keibidrop.com/docs/how-to/video-audio-projects.html): stream media, hand off project files, keep databases local
- [Run ffmpeg on remote files](https://keibidrop.com/docs/how-to/use-ffmpeg.html): transcode and clip without downloading first
- [Edit documents in LibreOffice and Word](https://keibidrop.com/docs/how-to/use-office-documents.html): office files across two machines
- [Work on Blender projects](https://keibidrop.com/docs/how-to/use-blender.html): assets stream, .blend hand-off, caches local
- [Use VS Code on a shared folder](https://keibidrop.com/docs/how-to/use-vscode.html): remote projects without SSH setup
- [Share an Obsidian vault](https://keibidrop.com/docs/how-to/use-obsidian.html): notes on two machines, one device at a time
- [Hand a database between machines](https://keibidrop.com/docs/how-to/hand-off-a-database.html): PostgreSQL and SQLite recipes, the one rule
- [Share a folder read only](https://keibidrop.com/docs/how-to/share-read-only.html): origin-enforced read only, mount-level EROFS, preserving timestamps
- [Handle conflict files](https://keibidrop.com/docs/how-to/handle-conflict-files.html): recognize, resolve, avoid
- [Automate transfers with kd](https://keibidrop.com/docs/how-to/automate-with-kd.html): cron, CI, and agent recipes; check ok not exit codes; the kdmcp MCP server
- [Run two instances on one machine](https://keibidrop.com/docs/how-to/run-two-instances.html): KEIBIDROP_CONFIG_DIR, sockets, ports
- [Collect logs and report a problem](https://keibidrop.com/docs/how-to/collect-logs-and-report.html): log paths, sanitized export
- [Troubleshoot connections](https://keibidrop.com/docs/how-to/troubleshoot-connections.html): discovery, internet, relay limits
- [Troubleshoot the mount](https://keibidrop.com/docs/how-to/troubleshoot-the-mount.html): drivers, permissions, stale mounts
- [Update or uninstall](https://keibidrop.com/docs/how-to/update-and-uninstall.html): per-platform commands, what stays behind

## Explanation
- [How KeibiDrop works](https://keibidrop.com/docs/explanation/how-keibidrop-works.html): two peers, on-demand streaming, relay and bridge roles
- [The security model](https://keibidrop.com/docs/explanation/security-model.html): PQ hybrid crypto, key rotation, relay visibility, honest non-claims
- [Edits, versions, and conflicts](https://keibidrop.com/docs/explanation/edits-versions-conflicts.html): last writer wins, conflict files, no silent loss
- [Network paths](https://keibidrop.com/docs/explanation/network-paths.html): LAN, direct IPv6, outbound-only bridge
- [What KeibiDrop is not](https://keibidrop.com/docs/explanation/what-keibidrop-is-not.html): scope boundaries

## Reference
- [kd command reference](https://keibidrop.com/docs/reference/kd-cli.html): all verbs, JSON envelope, exit-code warning, events, env vars
- [keibidrop-cli command reference](https://keibidrop.com/docs/reference/keibidrop-cli.html): REPL commands and startup
- [Desktop app reference](https://keibidrop.com/docs/reference/desktop-app.html): screens, controls, settings panel
- [Configuration reference](https://keibidrop.com/docs/reference/configuration.html): config.toml keys, env variables, precedence, booleans
- [Files and folders](https://keibidrop.com/docs/reference/files-and-folders.html): state, data, logs, runtime files per platform
- [Network and ports](https://keibidrop.com/docs/reference/network-ports.html): ports, endpoints, timings, limits
- [Platform support](https://keibidrop.com/docs/reference/platform-support.html): OS matrix, FUSE drivers, signing, mobile status
- [Limits and known issues](https://keibidrop.com/docs/reference/limits-and-known-issues.html): two peers, POSIX behavior, concurrent writing
- [Performance numbers](https://keibidrop.com/docs/reference/performance.html): measured throughput and latency with conditions

## Project
- [Releases](https://keibidrop.com/docs/releases.html): version history and current highlights
- [Roadmap](https://keibidrop.com/docs/roadmap.html): direction, no dates

## By trade
- [Remote DFIR triage](https://keibidrop.com/for/dfir.html): mount an evidence share read only across NAT, extract the artifact set, no inbound port, no kernel driver on the evidence machine
- [Post-production handoff](https://keibidrop.com/for/post-production.html): mount camera originals, skip the proxy transcode and the relink, bidirectional saves
- [Datasets on a rented GPU box](https://keibidrop.com/for/ml.html): mount the workstation that holds the data, no bucket, checkpoints write back during the run
- [File exchange between AI agents](https://keibidrop.com/blog/share-files-between-ai-agents.html): kdmcp pairs two machines by code, both agents see one encrypted folder, a 1 MB read out of a 256 MB file moved 16.8 MB instead of the whole file
- [Send files without interruptions](https://keibidrop.com/blog/send-files-without-interruptions.html): a dropped connection does not restart the transfer, it continues from the last block received; a 40 MB download cut at 8 MB finished with matching checksums
- [Video tutorials, one clip per step](https://keibidrop.com/blog/video-tutorials.html): eight short captioned videos, install on a Mac, connect with a code, send a file, save a contact, files as a folder, DaVinci Resolve from a NAS.

## Comparisons
- [All comparisons](https://keibidrop.com/compare/): below you can find sixteen tools with their price, and a measured number where we have one
- [Compared with sshfs](https://keibidrop.com/compare/sshfs.html): sshfs measured 1.33 MB/s at every file size across a 200 ms link, and why
- [Compared with Blip](https://keibidrop.com/compare/blip.html): Blip is free for non-commercial use and US$25 per user per month for commercial work, and it sends files where KeibiDrop can also mount the folder
- [Compared with LocalSend](https://keibidrop.com/compare/localsend.html): LocalSend works on the local network, and KeibiDrop connects across networks and countries and can mount the folder
- [Compared with croc](https://keibidrop.com/compare/croc.html): croc sends one transfer per code phrase from the command line, and KeibiDrop keeps saved peers and mounts the folder
- [Compared with Magic Wormhole](https://keibidrop.com/compare/magic-wormhole.html): Magic Wormhole uses a single-use code typed by hand, and KeibiDrop keeps saved peers and mounts the folder
- [Compared with Syncthing](https://keibidrop.com/compare/syncthing.html): Syncthing keeps a full copy on every device, and KeibiDrop pulls only the bytes you open
- [Compared with rclone](https://keibidrop.com/compare/rclone.html): rclone needs a storage provider, and in one measured run its mount served stale bytes after an in place edit
- [Compared with WeTransfer](https://keibidrop.com/compare/wetransfer.html): WeTransfer uploads to their servers first, and KeibiDrop sends directly with no upload step and no size cap
- [Compared with Warpinator](https://keibidrop.com/compare/warpinator.html): Warpinator works on one local network, and KeibiDrop connects across networks with no VPN and can mount the folder
- [Compared with Send Anywhere](https://keibidrop.com/compare/send-anywhere.html): Send Anywhere issues a 6-digit key per transfer and shows ads in the free app; KeibiDrop keeps saved peers with no ads and can mount the folder
- [Compared with AirDroid](https://keibidrop.com/compare/airdroid.html): AirDroid needs an account and limits file size on its free plan; KeibiDrop has no account and no size limit and can mount the folder
- [Compared with KDE Connect](https://keibidrop.com/compare/kde-connect.html): KDE Connect works on one local network; KeibiDrop connects two computers across networks with no VPN and can mount the folder
- [Compared with Resilio Sync](https://keibidrop.com/compare/resilio-sync.html): Resilio Sync keeps a full copy on every device; KeibiDrop pulls only the bytes you open and its engine is MPL-2.0
- [Compared with PairDrop](https://keibidrop.com/compare/pairdrop.html): PairDrop sends between browsers through a public server; KeibiDrop keeps saved peers, mounts the folder, and has a browser peer for the side with nothing installed
- [Compared with Strada](https://keibidrop.com/compare/strada.html): Strada charges $8 to $45 per user per month, so eleven editors is $495 a month; KeibiDrop has no per-seat price and the commercial edition is 99 EUR a month for the whole team
- [Compared with LucidLink](https://keibidrop.com/compare/lucidlink.html): LucidLink bills per member and per terabyte of their storage, so five people with 20 TB is $1,575 a month; KeibiDrop serves the drive you already own with no storage bill

## Product
- [Homepage](https://keibidrop.com/): what it does, two modes, comparison against croc, LocalSend and Syncthing
- [Getting started](https://keibidrop.com/getting-started.html): install, connect two devices, open the folder
- [Install](https://keibidrop.com/install.html): per-platform commands, Android via the KeibiSoft F-Droid repository, FUSE driver notes, SHA256 verification
- [How to use KeibiDrop](https://keibidrop.com/how-to-use.html): install on both computers, connect once with a switch or a code, send a file or open their files as a folder; short clip per step
- [Feedback](https://keibidrop.com/feedback.html): one to five stars and a message, stored on our own server
- [Send large files for free](https://keibidrop.com/guides/send-large-files-for-free.html)
- [Share files between two computers](https://keibidrop.com/guides/share-files-between-two-computers.html)
- [Mac to Windows file transfer](https://keibidrop.com/guides/mac-to-windows-file-transfer.html)
- [Send files from Android to a PC](https://keibidrop.com/guides/send-files-from-android-to-pc.html)
- [Use cases](https://keibidrop.com/use-cases.html): scenario walkthroughs
- [For companies](https://keibidrop.com/companies.html): self-hosted relay, data sovereignty, commercial licensing
- [About](https://keibidrop.com/about.html): who builds it, credentials and how to verify them, company registration
- [Blog](https://keibidrop.com/blog/): short guides on moving and working with large files

## Legal
- [Terms of service](https://keibidrop.com/terms.html): relay credit purchases, EU consumer law
- [Privacy policy](https://keibidrop.com/privacy.html): no accounts, no telemetry, no cookies on the site
- [Refund policy](https://keibidrop.com/refund.html): prepaid relay credit, OUG 34/2014 and Directive 2011/83/EU

## Optional
- [Repository](https://github.com/KeibiSoft/KeibiDrop): source, releases, SHA256SUMS
- [Engineering blog](https://keibisoft.com/blog.html): measured write-ups on the filesystem, transport and cryptography