---
title: "sms-forwarder: Android app that forwards SMS · Lázaro Santana"
description: "sms-forwarder: open-source Android app that forwards SMS to an HTTPS endpoint, with a local queue and retries. Kotlin and Jetpack Compose."
url: https://lazarosantana.dev/en/projects/sms-forwarder/
---

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.

[Download the APK](https://github.com/Lacho00/sms-forwarder/releases/latest) [View the code](https://github.com/Lacho00/sms-forwarder)

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.0** latest version

**Android 12+** minimum version

**MIT** open 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](https://lazarosantana.dev/en/projects/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 · home **Home**

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 · rules **Rules**

SMS Forwarder Destinations screen: three destinations with their template, standard JSON, Telegram and custom, each with its status and a switch

03 · destinations **Destinations**

SMS detail in SMS Forwarder: the text, the status of each destination and the Retry and Delete buttons

04 · detail **Detail**

// 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

- `200`*sent*
- `5xx`*retry*
- `no network`*retry*
- `400 · 401 · 403`*error, manual retry*

**No Google services** It does not use Google Play Services or trackers. Messages only go to the destinations you configure.

**Hidden text** You can hide the SMS content inside the app, and they keep being forwarded.

**Pause whenever you want** A switch stops forwarding. The SMS that arrive meanwhile are sent when you resume.

**Notifications by type** Separate notifications for what was recovered, what is stuck and what permissions are missing.

**Just the permissions it needs** Receive and read SMS and internet, plus notifications, boot and battery to work in the background.

// in numbers

## Project in numbers

**11,011** lines of Kotlin in 83 files

**4** destination templates: standard JSON, Telegram, ntfy and custom

**3** sweep intervals: 15, 30 or 60 minutes

**MIT** open 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.

Kotlin Jetpack Compose Material 3 Room WorkManager DataStore OkHttp kotlinx.serialization Robolectric GitHub Actions

// try it

[Download the APK](https://github.com/Lacho00/sms-forwarder/releases/latest) [View the code](https://github.com/Lacho00/sms-forwarder)

[← all tools](https://lazarosantana.dev/en/#p-tools) personal 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.

[Request a quote](https://lazarosantana.dev/en/contact/#form) [See services](https://lazarosantana.dev/en/services/)
