SWELL

Home / Guide

The SWELL guide

Send your first file in a couple of minutes. The pictures are from iPhone; the Mac and browser apps have the same parts.

The tabs

1. Your SWELL address

The first time you open SWELL, it makes your identity on your device. Your SWELL address (it starts with swell1) is what other people send to. It isn't secret: share it like an email address. There's no account, email or password.

Your private keys never leave your device. Keep your recovery key somewhere safe if the app offers you one: without it, a lost device means a lost identity.

2. Send a file

  1. Open Transfer and pick Send.
  2. Tap the box or Choose Files or Folder. On a Mac you can drop files on it.
  3. Choose the recipient from your contacts, or paste their SWELL address.
  4. Send. SWELL seals the file on your device, then sends it straight to their device or through the relay.

If the recipient is new, you can also share the transfer's share info with them yourself, in any messaging app. It holds a claim code, not the file.

Send: choose files or a folder, then a contact or SWELL address

3. Receive a file

Transfers sent to your SWELL address show up on their own in Manifest under Incoming, with a notification if you've turned them on.

If someone gave you share info instead:

  1. Open Transfer and pick Receive.
  2. Tap Paste Share Info, or paste the claim code.
  3. Tap Start Download. The file is unlocked on your device and checked against the sender's signature.
Receive: paste share info or a claim code, then start the download

4. Know it arrived (Landfall)

Your transfer appears in Manifest under Outgoing. When the other device has rebuilt the file and proved it, the transfer turns Delivered. Until then it shows how far along it is.

Send a newer version of the same file later and SWELL sends only what changed (Drift).

Good to know

How long does a transfer wait?

A transfer waits on the relay for about a day. If the recipient hasn't collected it by then, send it again.

Do both of us need to be online?

No. When you're both online on the same network, the file goes directly between your devices. Otherwise it waits, locked, on the relay until the recipient collects it.

Can I cancel a transfer?

Yes, from Manifest. Cancelling tells the other side and asks the relay to delete the locked pieces.

Can I send to someone on a different platform?

Yes. Mac, iPhone, iPad, the browser app and Windows all use the same protocol. Windows can receive today; sending from Windows is in development.

Does SWELL work on a slow connection?

Yes. Files travel in pieces, and with Drift an update sends only the parts that changed.

Something not covered here? Get help.