Wormhole Transfer

end-to-end encrypted · SPAKE2 + AES-GCM · magic-wormhole

Tutorial — Sending & Receiving Files

No sign-up required. No software to install. Just a browser on both ends and a short code to share.

Part A — Sending a File

  1. Open the transfer page at transfer.titanium-spirit.net.
  2. Drop a file onto the Send a File panel, or click it to browse. Any file type up to 512 MB is accepted.
  3. Wait for upload. A progress bar shows the file being uploaded to the relay. This takes a few seconds depending on file size and your connection.
  4. A wormhole code appears — something like:
    7-piano-dagger
  5. Share the code with your recipient by any means — text message, voice call, email. The code is short enough to read aloud.
  6. Wait. The page will show Waiting for recipient… until they enter the code. Once they do, transfer begins automatically.
  7. Done. You will see a transfer complete confirmation. The file is gone from the server.

Part B — Receiving a File

  1. Open the transfer page at transfer.titanium-spirit.net.
  2. Find the Receive a File panel below the Send panel on the same page.
  3. Type the wormhole code you received from the sender into the input field. Format: number-word-word (e.g. 7-piano-dagger).
  4. Click [ receive ] or press Enter.
  5. Wait while connecting. The status will update as the SPAKE2 handshake completes and the transfer begins. This is automatic — no action needed.
  6. A download link appears when the transfer is complete. Click it to save the file.
  7. The link is one-time use. Download it before closing the tab.

Tips

  • Both sender and receiver should have the transfer page open at the same time. The sender must keep their tab open until the recipient enters the code.
  • The code expires once used or if the sender closes the tab.
  • There are no file type restrictions — archives, images, documents, executables all work.
  • If the transfer fails, simply start over. Each attempt generates a fresh code.
  • For very large files (>100 MB) make sure both parties have a stable connection before starting.

Command-Line Alternative

Advanced users can also use the wormhole CLI directly against this server's relay:

# Send
wormhole send --relay-url ws://127.0.0.1:4000/v1 myfile.zip

# Receive
wormhole receive --relay-url ws://127.0.0.1:4000/v1 7-piano-dagger
      

The web UI and CLI are fully interoperable — a CLI sender can pair with a browser receiver and vice versa.