wormhole

Send a file

$ wormhole send [file]

$ wormhole send [directory/]

$ wormhole send --text "[message]"

$ wormhole send --code [custom-code] [file]

$ wormhole receive [code]

$ wormhole receive --accept-file [code]

$ wormhole receive --output-file [filename] [code]

wormhole command [options] [arguments]

Magic-Wormhole provides secure, simple file transfer between two computers. The sender generates a short, human-readable code that the receiver types to establish an encrypted connection.
Security is based on SPAKE2+ password-authenticated key exchange, ensuring strong encryption from a simple code. Data transfers directly peer-to-peer when possible; otherwise, an encrypted relay tunnels the data. Neither servers see unencrypted content.
Directories are automatically zipped for transfer and unzipped on receipt. Text messages can be sent for quick sharing of passwords or small data.

send

Send a file, directory, or text message.

Receive a file or text message.

Send a text message instead of file.

Use a specific wormhole code instead of generating one.

Number of words in generated code.

Request receiver to verify data checksum.

Automatically accept incoming file (use with caution).

Save received data to specified filename.

Use a custom rendezvous server.

Don't show progress bar during transfer.

Display help message.

Display version information.

Both sender and receiver must have wormhole installed. The wormhole code must be communicated securely (ideally spoken or via trusted channel). Using --accept-file with untrusted senders is risky as files are saved without confirmation.

Magic-Wormhole was created by Brian Warner and first released in 2015. It was designed to solve the problem of securely transferring files between computers without complex setup. The PAKE-based security model allows strong encryption from easy-to-type codes. Alternative implementations exist in Go (wormhole-william) and Rust.

scp(1), rsync(1), croc(1), ffsend(1)