Skip to content
mrrizkin edited this page Oct 31, 2026 · 2 revisions

Usage

CLI

qd receive [--out DIR] [--policy ask|auto|deny]
qd peers [--timeout 4s]
qd send <PATHS...> --to <PEER> [-j 4]
qd trust [add <ID> | rm <ID> | list]
qd id

--to takes a device name, device id prefix, hostname, IP, or ip:port. Hostnames resolve through DNS, so a MagicDNS name or a Tailscale 100.x address works when UDP 53320 is reachable between the devices. Sending by address skips discovery and certificate pinning.

Folders are walked recursively; symlinks are skipped, relative paths are recreated on the receiver, and an existing file becomes name (1).ext.

State

State lives in ~/.config/quicdrop (override with QD_CONFIG_DIR):

  • identity
  • name.txt
  • trusted.json

Incoming offers from unknown devices prompt on the terminal, or are rejected when there is no terminal. Deleting the directory creates a new device.

Desktop app

cargo run --manifest-path apps/desktop/Cargo.toml

It embeds the daemon (quicdropd, loopback API on port 53319) and serves a static ui/. Peer rows show the device id; sends target the id so the certificate is pinned. The Add device dialog accepts a hostname or address with an optional label and port. Tailscale peers are not discovered automatically, so add them by address. File and folder actions accept multiple selections per send.

Clone this wiki locally