Help
Swell by PT JIJI LABS DIGITAL · iPhone: Swell 1.3.0 beta, build 28.18 · Android: Swell 1.3.6
The short version: Swell is invite-only. You and the person you write to can read your messages, because they are encrypted on your phone before they are sent. If the other phone is offline, a message waits on the server for up to 14 days. You can see what the server saw: tap the time under any message.
- iPhone and Android
- Getting started
- Adding people
- Swell Touch
- Messages
- With no signal
- Calls
- Appearance, avatars and stickers
- Swell AI
- Widgets
- Privacy and what the server sees
- Recovery phrase and a new iPhone
- Notifications
- Block and report
- Deleting your account
- Licence and credits
- Contact
Swell has the same features on iPhone and Android. The paths below are for the iPhone app; Android uses the same names.
iPhone and Android
iPhone: Swell 1.3.0 is a public beta on TestFlight. Join the beta. It is not on the App Store yet. App Store: coming.
Android: Swell 1.3.6 is on Google Play.
On both: chats, groups with group links, polls, stickers, pins, chat lock, voice and video calls, and backups. By default, Swell connects straight to the Swell server. See Privacy and what the server sees.
Only on iPhone for now: Swell Touch (coming to Android). The Live Activity and Dynamic Island are iPhone parts; Android shows calls in the notification.
Getting started
Swell is an invite-only messenger by Jiji Labs. Install Swell and open it. Tap Create account and accept the Terms of Use. Then add the people you want to write to. See Adding people.
Used Swell before on another phone? Choose I have an account. See Recovery phrase and a new iPhone.
There is one Chats screen. Calls is a pill at the top of it. Your mark (your picture, top left) opens privacy, Appearance, Swell AI and settings.
Adding people
Swell is invite-only. Nobody can find you unless you swap an invite with them. Tap + (top right of Chats) to open People. At the top are three ways to add someone:
- Invite: send your friend the link, or let them scan your code. You are connected as soon as they open it.
- In person: choose Scan their code, or Swell Touch (see below).
- New group: make a group of people you have added.
The scan icon next to + opens the code scanner directly. Swell never reads your address book. People you add show a Contact Mark, a picture made from both of your keys. It should look the same on both phones. For a full check, compare the safety number.
Swell Touch Android soon
Swell Touch adds someone who is next to you, without typing anything.
- Both people open +, then In person, then Swell Touch.
- Both phones show a picture. It is new at every meeting. If the pictures look the same, each tap They match.
- Swell makes a one-use code that works for 5 minutes and only for that person, and adds them.
While the screen is open, a phone nearby that runs Swell Touch receives your name and public key. iPhone asks permission for Local Network and nearby devices. It works only while Swell is unlocked and open. If it cannot start, check that Wi-Fi and Bluetooth are on, or use a QR code instead.
Messages
Who can read my messages? You and the person you write to. Messages are encrypted on your phone and can be opened on theirs. Swell uses the Swell Protocol, Jiji Labs' own end-to-end encryption with a post-quantum key exchange, open source under Apache-2.0. See how it works.
Why does a message say Sent and not Delivered? Delivered shows once the other phone has collected the message. Read shows only when both people have read receipts turned on. Until the other phone collects it, a message waits on the server for up to 14 days.
The + in a chat opens a grid: Photos, Camera, Files, Location, Contact, Sticker, Poll and Create image. Under Only on Swell are:
- Time Letter: write today, and choose the day it can be read. Until then it stays closed on their phone.
- Fading: after it is read, the words go away a few at a time.
- View once: a photo or video that is shown once.
Also on both phones:
- Send later: write a message now and choose when it goes.
- Mini apps: a shared list, a plan, or a game of tic-tac-toe, inside the chat.
- Sending nearby: with no internet, send a message to a phone next to you.
You can also reply, react, edit, delete for everyone and search. Private mode and temporary contacts are for chats that should not stay.
With no signal
On iPhone, from build 28.8:
- A message you write with no signal waits on your phone. It goes when the network is back.
- Edits, Delete for everyone, reactions and chat timers made with no signal also reach the other phone later.
- A message the other phone has read never stays at Sending.
- A message you send just before you close Swell still goes.
Calls
Voice and video calls work on iPhone and Android. On iPhone a call also shows as a Live Activity and in the Dynamic Island; on Android it stays in the call notification. Voice rooms let you talk by voice in a room.
Appearance, avatars and stickers
Tap your mark (top left), then Appearance. Choose a theme, such as Pixel, Terminal, Neon or Warm, or follow the system. You can also set the accent colour, text style, chat text size, chat wallpaper and the app icon colour.
To change your picture, tap your mark (top left), then your picture. The Avatar Studio lets you choose an avatar, build one or use a photo. Sticker packs are in the sticker button of the chat grid.
Swell AI
Swell AI runs on the phone itself and makes no network call, so nothing it reads leaves the phone. It needs a newer phone that can run AI on the device.
- Catch me up: a card above your unread messages. It writes a short summary when you tap it.
- Summarize this chat: in the chat's menu.
- Suggested replies: tap Suggest replies above the message field and pick one, or write your own.
- Settings: tap your mark, then Swell AI, to turn it off or ask it a question.
Swell AI is off in chats in Private mode and in locked chats. It can miss things, so check the chat for anything important.
Widgets
Swell has three widgets: Time Letter (when your next letter opens), People (pinned people, with a dot when something is new) and Invite (opens your invite code). Their data stays on this iPhone and is sealed. They never show a message. They show nothing when Lock Swell is on or when alert previews are hidden.
Privacy and what the server sees
You can check this yourself in the app. Tap the time under any message to open its Message Trail: when your phone sealed it, its sealed size, when the server took it and what the server could see. For a full look, tap your mark (top left), then What the server sees. Privacy in the same place has checks, who can reach you, chat lock and blocked people.
On iPhone and Android 10+, Swell connects directly to the server over TLS 1.3, so the server can see your IP address while you are connected. It keeps the address in memory only and writes no IP log. Tor mode in Settings, off by default, hides the address from the server.
The server can see
- A separate random ID for each of your chats. It contains no name.
- How many encrypted messages wait for each chat, how large they are, and when each one arrived.
- Your IP address.
They stay on the server until you collect them, and for at most 14 days.
The server cannot see
- Your name or photo.
- Your contacts.
- What any message says. Everything is encrypted on your phone before it is sent.
- The name of whoever sent a message.
On this iPhone right now
The same page shows your chat IDs, shortened, and how many messages are waiting for each. Nothing is read or changed by looking. If it says it could not check, close the page and open it again later.
Recovery phrase and a new iPhone
Your recovery phrase is 12 words. You can see it at your mark, then Recovery phrase. If you lose your phone or move to a new iPhone:
- Install Swell on the new iPhone.
- Choose I have an account.
Your identity comes back. You then add your contacts again, with new codes.
On Android, Swell also has backups.
Notifications
Notifications are off until you turn them on. They say only "New message", with no name or text, unless you choose to show the sender or the first words, which your iPhone adds itself. Apple delivers them and sees your device token and the time.
If your phone is off or has no signal, messages for you wait on the server for up to 14 days.
If notifications do not arrive as you expect, write to us at support@jijilabsdigital.com. It helps to attach the debug log. See Contact.
Block and report
Every chat has Block and Report. Blocking stops that person from reaching you.
- In a chat: tap the name at the top, then Block or Report this contact.
- One message: press and hold a message you received, then Report (Report sender in a group).
- In a group: tap the group name, then the ... beside a member, then Report or Block.
- From the list: swipe a chat in the list, then Block.
A report reaches Jiji Labs encrypted, with the reason you choose, the messages you tick, and that contact's key and route. Jiji Labs reads reports and removes the reported route when a report shows abuse. Reports of child abuse, threats or extortion are handled first. You can also write to us at support@jijilabsdigital.com. Our rules on child safety are on the Child safety page.
Deleting your account
In the app, tap your mark (top left), scroll to the bottom and tap Delete account. This erases your keys and chats from the phone. More is explained on Delete your data.
Encrypted messages stay on the server until they are collected, and for at most 14 days.
Licence and credits
The Swell Protocol, the encryption library used by Swell, is open source under the Apache License 2.0. Details are on Source code and licences.
From version 1.3.0 the Swell app itself is not open source. It is copyright PT JIJI LABS DIGITAL. Versions 1.2.0 and earlier (Android) were released under the GNU Affero General Public License, version 3, and their source stays available.
Swell comes with absolutely no warranty, to the extent permitted by law.
Copyright © PT JIJI LABS DIGITAL and the authors of the included software. The source code and the licences of the included software are at getswell.org/source.
Contact
Write to us at support@jijilabsdigital.com.
If something does not work, you can send us the debug log. On the Help page in the app, tap Export debug log, then Share the log. The log is a short report for support with the app version, counts and states. It contains no messages, no names, no contacts, no keys and no addresses.