Repository navigation
Getting Started
A short page to get the app running and your first message sent.
Pick whichever matches you:
- F-Droid — follow the Installation Guide — Messages (F-Droid)
- GitHub Releases — download the APK, then follow the Installation Guide From GitHub
If Android complains that the app is "unknown" or Play Protect warns you, that is normal and expected. Both guides explain exactly how to get past it.
The app needs Android 10 or newer.
This is the important one. Android only lets one app handle your texts, so Messages has to be that app or it will not receive anything.
- Open Messages.
- After a moment you will see a prompt asking to Set Messages as your default SMS app.
- Tap Set default and confirm.
If you tap Not now, the app will ask again later. You can also do it by hand at
Settings → Apps → Default apps → SMS app.
If another messaging app is already installed, you will first be asked to uninstall it. That is Android's rule, not the app's.
The app asks for SMS access so it can bring in the messages already on your phone.
When asked, tap Allow. If you skip it, you can still send messages, but conversations that already existed on the device will not appear.
You may also be asked for:
| Permission | Why it needs it |
|---|---|
| Contacts | So chats show names instead of phone numbers, and so you can pick people to message |
| Notifications | So you get told when a message arrives (Android 13 and newer) |
| Phone | Only if you have two SIM cards, so it can tell them apart |
The app does not need the internet, and it asks for no permission that sends your data anywhere.
- Tap the + button at the top of the conversation list.
- Search for a name or type a phone number.
- Tap the person you want.
- Type your message and tap send.
That is it. You can also start a conversation by opening a text from another app and choosing Messages, or by tapping a notification.
Two things most people change straight away. Both are in Settings — tap your avatar at the top right of the conversation list.
Settings → Advanced → Notifications
Turn Receive sound on or off, and use Manage in system settings to pick the sound, vibration and priority Android uses for each category of message. You can hear a sound by tapping it in Android's own picker.
Settings → Theme
Pick Light, Dark, Amoled (pure black), System default to follow your phone, or Dynamic to follow your wallpaper on Android 12 and newer.
Messages live only on your phone. If you uninstall the app, they are gone. So if you have a lot of history worth keeping, make a backup first.
Settings → Backup messages — you choose a PIN of 4 to 16 digits (or leave it blank for an unencrypted copy, with a warning), and the app saves a copy of your messages. You can also turn on Periodic backup in the same dialog, which saves an unencrypted copy automatically every day or week.
Full details, including how to move messages in from another app, are in Backup and Import.
- Conversations — get around the message list
- Settings — everything you can change
- Troubleshooting — if something is not working
Something out of date or unclear? Let us know in a GitHub issue.