personal project · open source · Android

An app that
forwards your SMS

SMS Forwarder forwards the SMS from the senders you choose to an HTTPS endpoint. It keeps every message in a local queue, retries until it gets a 200 and, as a safety net, sweeps the inbox every so often. I wrote all of it.

SMS Forwarder: Home screen with the sent, queued and error counters and a list of SMS with a status label for each destination
2.2.0latest version
Android 12+minimum version
MITopen source
What it is

An Android app that forwards SMS to your own HTTPS endpoint

My role

Idea, design and code, all on my own

Status

Version 2.2.0, released on 13 November 2026

Partner

sms-relay, the backend that receives it

// the screens

Four key
screens

Screenshots of the app in Spanish, with test data: the senders, destinations and messages are made up.

SMS Forwarder Home screen: counters for sent today, queued and errors, status filters and a list of SMS with a label for each destination, such as Main 200 or Backup 403
01 · homeHome
SMS Forwarder Rules screen: three rules with a switch, showing the sender, text and SIM they filter on, and a warning on the one that has no destinations
02 · rulesRules
SMS Forwarder Destinations screen: three destinations with their template, standard JSON, Telegram and custom, each with its status and a switch
03 · destinationsDestinations
SMS detail in SMS Forwarder: the text, the status of each destination and the Retry and Delete buttons
04 · detailDetail
// the problem

Never lose
an SMS

An SMS reaches the phone, but whatever needs it lives somewhere else: a server, a chat, a dashboard. If there is no network at that moment, the destination fails or the system kills the app, the message gets lost on the way.

SMS Forwarder keeps it first and delivers it after. Each destination has its own status, and you can see, filter and retry whatever failed.

01

Receives and filters

A receiver listens for incoming SMS. Each rule matches the sender (exact, contains or regular expression) and, if you want, the text and the SIM.

02

Keeps a local queue

Every message goes into a database before it is sent. An SMS you delete from the app is not forwarded, even if it stays in the inbox.

03

Delivers to each destination

A rule can point to several destinations: standard JSON, Telegram, ntfy or a custom request with its own method, headers and body.

04

Retries until the 200

If the destination does not answer, WorkManager retries with a growing wait. A periodic sweep of the inbox recovers what the receiver never saw.

// control

You decide
what goes out

The app handles messages that can carry codes and personal data. So every decision is yours: which senders, to which destination, and when to stop.

// what the destination answers
  • 200sent
  • 5xxretry
  • no networkretry
  • 400 · 401 · 403error, manual retry
No Google servicesIt does not use Google Play Services or trackers. Messages only go to the destinations you configure.
Hidden textYou can hide the SMS content inside the app, and they keep being forwarded.
Pause whenever you wantA switch stops forwarding. The SMS that arrive meanwhile are sent when you resume.
Notifications by typeSeparate notifications for what was recovered, what is stuck and what permissions are missing.
Just the permissions it needsReceive and read SMS and internet, plus notifications, boot and battery to work in the background.
// in numbers

Project
in numbers

11,011lines of Kotlin in 83 files
4destination templates: standard JSON, Telegram, ntfy and custom
3sweep intervals: 15, 30 or 60 minutes
MITopen license, the full code is on GitHub

SMS Forwarder is a personal tool, not client work: there are no business results to report. The numbers come from the repository.

KotlinJetpack ComposeMaterial 3RoomWorkManagerDataStoreOkHttpkotlinx.serializationRobolectricGitHub Actions
// try it
← all toolspersonal project
// your project

Got a project in mind?

Tell me what you need. I reply within 24 hours and, if it is a fit, you get a fixed written proposal.