magic-wormhole – Secure File Transfer

magic-wormhole provides a secure way to get files from one computer to another using short,...

Networking Tools Linux Open Source

magic-wormhole provides a secure way to get files from one computer to another using short, human-pronounceable codes. It uses PAKE (Password-Authenticated Key Exchange) to establish an encrypted connection without requiring pre-shared secrets or complex setup between the two parties.

The tool generates easy-to-remember wormhole codes like “7-crossover-clockwork” that can be communicated verbally or through any channel. This makes it perfect for transferring sensitive files when you need security but don’t have pre-established trust or infrastructure.

Key Features

  • Human Codes – Easy to speak and type codes
  • PAKE Security – Secure key agreement protocol
  • No Registration – Works without accounts or setup
  • Text and Files – Send messages or files
  • Directory Support – Send entire folders
  • Transit Relay – Works through NAT

Installation

sudo apt install magic-wormhole    # Debian/Ubuntu
pip install magic-wormhole         # Via pip
sudo dnf install magic-wormhole    # Fedora

Basic Usage

# Send a file
wormhole send file.txt
# Outputs: wormhole receive 7-crossword-glossary

# Receive the file
wormhole receive 7-crossword-glossary

# Send text message
wormhole send --text "Secret message"

# Receive text
wormhole receive 3-elephant-notebook

# Send directory
wormhole send mydir/

Use Cases

  • Secure File Sharing – Send sensitive documents
  • Password Sharing – Securely transmit credentials
  • Cross-Platform Transfer – Between different OS
  • Ad-Hoc Sharing – No prior setup needed

Download magic-wormhole

Was this article helpful?