Skip to content

Repository files navigation

📤 SMS Telebot

Android License: AGPL v3 Privacy Policy

SMS Telebot is an Android app that automatically forwards incoming SMS to Telegram bots, ntfy topics, email addresses via SMTP, or phone numbers via outgoing SMS. It can also notify you about incoming calls, low battery, and charger connection status changes.

⭐ Features

  • Flexible Forwarding Rules: Create as many forwarding rules as you need and route events to a Telegram bot, an ntfy server, an SMTP server, or a phone number (via SMS). You can add multiple destinations!

  • Event Selection: Choose exactly what to forward: incoming SMS, incoming calls, low battery alerts, or charger connection updates.

  • Custom Filters: Set up filters based on sender or message text inside each rule to control which events are forwarded. Support for regular expressions is included.

  • Always-on Background Mode: Keep monitoring active with a persistent notification for maximum delivery reliability on stricter Android builds.

  • Auto Retry: If forwarding fails because of temporary issues (like no internet), the app automatically retries in the background.

  • Secure Storage: Passwords and tokens are stored in encrypted form for better security.

🛠️ Getting Started

  • Set Up Telegram: If you do not have a bot yet, create one with @BotFather (quick and free), then open a chat with your bot and send any message so the app can fetch chat ID automatically.

  • Set Up ntfy: Pick a topic name on any ntfy server (e.g., ntfy.sh or your own instance). To ensure privacy, use a long, random string so that no one else can subscribe to your topic.

  • Set Up SMTP: Use any SMTP-enabled email account (for example Gmail). A dedicated mailbox is recommended, and in most cases you will need an app password from your email account security settings.

  • Choose Events: In the app settings, pick the events you want to forward, grant required permissions, and save your changes.

  • Create Forwarding Rules: Create one or more forwarding rules by selecting a destination (Telegram, ntfy, SMTP, or SMS). Test each configuration, save it, and then enable it from the rules list.

  • Start Forwarding: All set! Tap 'Start' to begin forwarding your messages and events.

🔍 Using Filters

You can establish filters to control which messages are forwarded based on the sender or the message text. Filters can be set to trigger when the sender's number or name, or the message content, contains specific characters.

  • Whitelist Mode: Messages will be forwarded if they match at least one filter.

  • Blacklist Mode: Messages will not be forwarded if they match any filter.

To verify if a specific message will be forwarded, simply enter the sender and/or message in the provided fields and check the results.

🚀 What's Next?

  • Push notifications forwarding
  • Custom message templates
  • Proxy settings

📝 Important Notes

  • OS Variations: Android vendors apply background limits and security policies differently, so behavior may vary across devices and OS versions.

  • Battery Optimization: The app runs in the background, which may cause the system to restrict its functionality to conserve battery. To avoid this, consider disabling battery optimization for the app in your device settings.

  • System Events: If you rely on low battery or charger connection alerts, always-on background mode is highly recommended because these notifications depend on system events.

  • Permissions: All permissions are requested on-demand, strictly when you enable a specific feature that requires them (e.g., enabling SMS forwarding will prompt for SMS access).

  • Security & Transparency: Because the app automates SMS and event forwarding, some security scanners or Play Protect might trigger a false positive, incorrectly identifying the app as a potential threat. The app is entirely open-source, contains zero trackers or hidden servers, and routes data strictly to user-configured destinations. For full details, see the Privacy Policy and Security Policy.

  • Chinese Firmwares: On firmwares with aggressive background management (often found on some Chinese-brand devices), enabling always-on background mode is recommended for reliable delivery. It keeps the app running as a foreground service with a persistent notification, making it much less likely that the system silently pauses monitoring.

  • Verification Codes: On Huawei EMUI or Xiaomi MIUI, you may need to turn off Verification Code Protection to forward SMS with verification codes, but be aware that doing so can pose a security risk.

Support

If you find SMS Telebot useful, any support is much appreciated. Your contributions help maintain the app and develop new features.

License

Copyright (c) 2025-2026 Pavel D. (teslor)

This project is licensed under the GNU Affero General Public License v3.0 (AGPL-3.0).
See the LICENSE file for the full text.

Commercial Use & Customization

If you represent a company and wish to use SMS Telebot in a closed-source commercial environment without AGPL restrictions, or if you need a White-Label build, please contact me for a Commercial License.

About

Android app to automatically forward SMS, calls, battery and charger alerts to Telegram, email or SMS

Topics

Resources

Security policy

Stars

56 stars

Watchers

1 watching

Forks

Releases

Sponsor this project

Packages

Used by

Contributors

Languages