# magic-wormhole Cheatsheet - Launch Pad

__ _______________________ _________._________________________ \_ _____/ \______ \ / _ \ / _____/ / _____/ | | \_ _____/ | __) | _/ / /_\ \ / \ ___ / \ ___ | | | __)_ | \ | | \ / | \ \ \_\ \ \ \_\ \ | |___ | \ \___ / |____|_ / \____|__ / \______ / \______ / |_______ \ /_______ / \/ \/ \/ \/ \/ \/ \/

# magic-wormhole Cheatsheet

← Back to cheatsheets

← Home

magic-wormhole is a secure file transfer tool that uses a short passphrase to establish encrypted connections between two computers. No need to configure firewalls, port forwarding, or exchange keys manually.

## Basic Usage

- wormhole send file.txt - Send file (generates code)

- wormhole receive CODE - Receive file with code

- wormhole send - Send from stdin

- wormhole receive CODE - Receive to stdout

## Directory Transfer

- wormhole send -d directory/ - Send directory

- wormhole receive CODE - Receive directory

- wormhole send -d . - Send current directory

## Text Transfer

- echo "text" | wormhole send - Send text

- wormhole receive CODE - Receive text

- wormhole send --text "message" - Send text message

## Options

- -d, --directory - Send directory instead of file

- -t, --text - Send text message

- -c, --code - Specify code (for receive)

- -o, --output - Output file/directory name

- -v, --verbose - Verbose output

- --relay-url - Custom relay server URL

## Common Examples

### Send File

    wormhole send document.pdf

Send file and get code to share.

### Receive File

    wormhole receive 7-crossover-clockwork

Receive file using code.

### Send Directory

    wormhole send -d project/

Send entire directory.

### Send Text

    echo "secret message" | wormhole send

Send text message.

### Receive to Specific Location

    wormhole receive -o received.pdf CODE

Receive file with custom name.

## Tips

- Codes are single-use and expire after a few minutes

- No need to configure firewalls or port forwarding

- Uses PAKE (Password-Authenticated Key Exchange) for security

- Works through NAT and firewalls automatically

- Great for quick file transfers between machines

- Can send text, files, or directories

- Relay server is only used for initial connection setup