Support
Need help? Most questions are answered below. If not, email apps@sfx.dev and include your device's model and the app version from Settings.
Sending
Open the Send tab and choose Photos, Files, or Text, or tap Paste to send what's on your clipboard. Wormhole shows a code such as 7-guitarist-revenge and a QR code. Give the code to the other person; the transfer starts when they enter it.
You can also send from other apps: tap the Share button and choose Wormhole.
Receiving
Open the Receive tab and type the code (suggestions appear as you type), tap the paste button, or scan a QR code with the button at the top left. Wormhole shows the name and size before you accept.
Received files go to Files › On My iPhone › Wormhole unless you choose another folder in Settings or on the transfer itself.
On the Mac
Send and Receive are in the sidebar. You can also drop files on the Send page or on Wormhole's Dock icon, or choose Wormhole from the Share menu in Finder.
The Mac can't scan QR codes, so type or paste the code. To have a phone scan yours instead, click Show Code on the Receive page.
Received files go to your Downloads folder unless you choose another folder in Settings or on the transfer itself. Transfers open on the main window; to give each its own window, change Show Transfers in Settings.
With a computer
Wormhole works with the magic-wormhole command-line tool on Mac, Windows, and Linux. Install it with pipx install magic-wormhole (or brew install magic-wormhole on a Mac), then:
Phone to computer: send from Wormhole, then run wormhole receive <code>.
Computer to phone: run wormhole send <file> and enter the code it prints in Wormhole's Receive tab.
Common questions
The transfer says it's waiting for the other device.
Codes are typed exactly as shown, including the number. Each code works once: if a transfer failed or was cancelled, start a new one to get a new code.
It says no one else is on the code yet.
The other device hasn't connected to that code. Check that it's typed exactly as shown, and that the other side is still waiting. Wormhole keeps waiting in case they're on their way.
"The other device stopped responding."
Data stopped arriving for 30 seconds, usually because the other device went to sleep or lost its connection. Start the transfer again once both are awake and online.
"The codes didn't match" or a security error.
The code was mistyped, or someone else tried it first. Nothing was sent. Start a new transfer.
Transfers are slow.
When the devices can't reach each other directly, data goes through a relay server. Putting both devices on the same Wi-Fi, and keeping Direct Connections on in Settings, is usually much faster.
Can I keep a transfer going if I leave the app?
Yes. Transfers continue in the background, and you can hide a transfer's sheet and keep using the app. The History tab shows what's in progress.
Is it private?
Transfers are end-to-end encrypted with a key only the two devices know. See the privacy policy for details.