This fork

• Add Github Action to build and release APK
  • Set Repository secrets KEYSTORE to output of openssl base64 < /path/to/your/keystore | tr -d '\n'
• Accept CA certificates added by user
• Add QUERY_ALL_PACKAGES permission to allow listing all installed apps (Google doesn't like it however)
• Correctly serialize JSON template to prevent from producing invalid JSON
• Add contact to SMS message (not available as template, only present in "Enhanced Data")
• Fix syntax error of getLatestIncomingNumber in phone call handler
• Fix call handler with code borrowed from NotifyMe
  • The old implementation reads the last call from call log on Android 10+, on my Android 15 phone the incoming phone number is always stuck with an old entry. However NotifyMe works flawlessly on my phone, thus I merged the code from NotifyMe and gave it priority while preserving existing code.
  • Revert to 1.3.0+1 APK if this doesn't work for you. The version number of the APK in releases page was not bumped, you should be able to try different versions by "updating" the app without uninstalling or losing your existing config.

Outstanding issues

• Missing fields in default template
  • %content% in push notification
  • %receivedStamp% in SMS message
• Custom Fields with pure variable are ignored. For example, a custom field with a value of %sim% will be ignored but %sim% - %text% will be kept.
• ForwardingRuleEditActivity.java is a mess, attempt to fix the previous issues didn't success
• When "Use Chunked Transfer Encoding" is disabled, java.net.ProtocolException: expected * bytes but received *
• All screens except the main/home screen have too much padding on the top and too little on the bottom, Android navigation bar covers "Test" and "Save" buttons on the bottom
• "Advanced Options" are missing in "App Webhooks"
• When "Enhanced Data" is enabled, "JSON Template" should be hidden to avoid confusion

Whishlist

• Add battery/charging info to Enhanced Data
• Allow selecting multiple apps in push notification rules, or
• Allow copying/cloning existing rule
• Backup and restore

---

Incoming SMS, Calls & Notifications Gateway

This is a free, open-source Android app that automatically forwards incoming SMS messages, phone calls, and push notifications to specified URLs as JSON via HTTP POST.

Features

• SMS Forwarding: Forward SMS from specific numbers or all senders
• Call Monitoring: Forward incoming call information with caller details and contact names
• Push Notification Forwarding: Forward notifications from specific apps
• Flexible Filtering: Configure rules for specific phone numbers, apps, or monitor all sources
• Modern UI: Material Design 3 interface with structured configuration
• Template Customization: Build custom JSON payloads with template variables
• HTTP Headers: Configure custom headers for webhook requests
• Retry Logic: Failed requests retry with exponential backoff
• SSL Options: Option to ignore SSL certificate errors
• Built-in Testing: Test webhook configurations before saving
• No Cloud Dependencies: All processing happens locally on your device

Activity Types

SMS Messages

Forward incoming text messages with sender information, message content, timestamps, and SIM slot details.

Available template variables:

• %from% - Sender phone number
• %text% - Message content
• %sentStamp% - Message sent timestamp
• %receivedStamp% - Message received timestamp
• %sim% - SIM slot identifier

Phone Calls

Monitor incoming calls and forward caller information including contact names when available.

Available template variables:

• %from% - Caller phone number
• %contact% - Contact name (if available in contacts)
• %timestamp% - Call timestamp
• %duration% - Call duration (0 for incoming calls)

Push Notifications

Forward notifications from specific apps with title, content, and app information.

Available template variables:

• %package% - App package name
• %title% - Notification title
• %content% - Notification content
• %text% - Combined notification text
• %sentStamp% - Notification timestamp

Download apk

Download apk from release page

Development & Release Management

This project includes automated version management and release scripts for streamlined development:

Quick Release

# Complete release workflow (recommended)
./release.sh minor "Add new features and improvements"

# Version bump only
./version_bump.sh patch "Fix critical bug"

Available Scripts

• version_bump.sh - Automated version bumping with git commits and tags
• release.sh - Complete release workflow with APK building and GitHub releases
• Semantic versioning support (major/minor/patch)
• Automatic changelog generation
• Build verification and rollback capabilities

For detailed documentation, see VERSION_MANAGEMENT.md.

Building from Source

# Debug build
./gradlew assembleDebug

# Release build
./gradlew assembleRelease

How to use

Set up App Permissions for you phone after installation. For example, enable "Autostart" if needed and "Display pop-up windows while running in the background" from Xiaomi devices.

Set sender phone number or name and URL. It should match the number or name you see in the SMS messenger app. If you want to send any SMS to URL, use * (asterisk symbol) as a name.

Every incoming SMS will be sent immediately to the provided URL. If the response code is not 2XX or the request ended with a connection error, the app will try to send again up to 10 times (can be changed in parameters). Minimum first retry will be after 10 seconds, later wait time will increase exponentially. If the phone is not connected to the internet, the app will wait for the connection before the next attempt.

If at least one Forwarding config is created and all needed permissions granted - you should see F icon in the status bar, means the app is listening for the SMS.

Press the Test button to make a test request to the server.

Press the Syslog button to view errors stored in the Logcat.

Request info

HTTP method: POST
Content-type: application/json; charset=utf-8

Sample payload:

{
     "from": "%from%",
     "text": "%text%",
     "sentStamp": "%sentStamp%",
     "receivedStamp": "%receivedStamp%",
     "sim": "%sim%"
}

Available placeholders: %from% %text% %sentStamp% %receivedStamp% %sim%

Request example

Use this curl sample request to prepare your backend code

curl -X 'POST' 'https://yourwebsite.com/path' \
     -H 'content-type: application/json; charset=utf-8' \
     -d $'{"from":"1234567890","text":"Test"}'

Send SMS to the Telegram

1. Create Telegram bot and channel to receive messages. There is short tutorial how to do that.
2. Add new forwarding configuration in the app using this parameters:
   1. Any sender you need, * - on the screenshot
   2. Webhook URL - https://api.telegram.org/bot<YourBOTToken>/sendMessage?chat_id=<channel_id> - change URL using your token and channel id
   3. Use this payload as a sample {"text":"sms from %from% with text: \"%text%\" sent at %sentStamp%"}
   4. Save configuration

Process Payload in PHP scripts

Since $_POST is an array from the url-econded payload, you need to get the raw payload. To do so use file_get_contents:

$payload = file_get_contents('php://input');
$decoded = json_decode($payload, true);

Screenshots

Main Interface

The main screen showing the clean, modern Material Design 3 interface when no forwarding rules are configured yet.

The main screen displaying an active forwarding rule configuration with the status indicator showing the app is listening for incoming activities.

Adding New Forwarding Rules

The rule creation interface where users can configure new forwarding rules for SMS, calls, or notifications with sender/app filtering options.

Template Configuration

The template editor showing how to customize JSON payloads using template variables like %from%, %text%, %sentStamp%, etc. for flexible webhook integration.

HTTP Headers Configuration

The HTTP headers configuration screen allowing users to add custom headers for authentication or other webhook requirements.

Settings and Configuration

Settings screen for configuring SIM card names and identifiers, useful for dual-SIM devices to distinguish between different carriers.

Additional settings options including operator-specific configurations and advanced forwarding parameters.

Credits

This is fully refactored and updated version of Konstantin B's repo.

Much thanks to him for the inspiration.