README.md

SMS Forwarding

Android app that listens for incoming SMS text messages and conditionally forwards them to other numbers.

Screenshots:

Preferences:

• Enable Service checkbox:
  • used to enable/disable this service
• ADD ActionBar menu item:
  • adds new recipient to whitelist
• whitelist entries are defined as follows:
  • Forwarding recipient:
    • a valid phone number (without any punctuation)
  • Sender must end with:
    • this value specifies a phone number (without any punctuation)
      • a match occurs when the sender of an incoming SMS message ends with this exact value
      • a special match-all glob pattern * is supported
    • this value acts as a filter
      • Forwarding recipient will only receive copies of incoming SMS messages that match this value
• whitelist entries can be modified
  • clicking on an existing recipient opens a dialog with options to:
    • edit field values, and save changes
    • delete

Caveats:

• Google Voice:
  • if:
    • the Google Voice app is installed on the phone
    • the Google Voice account that the app is logged into:
      • registers the real mobile phone number as a forwarding number
      • configures incoming SMS text messages to be forwarded as well
  • when:
    • a SMS text message is sent to the Google Voice virtual mobile phone number
  • then:
    • the phone receives an incoming SMS text message
  • but:
    • the sender of the SMS message will always be a number belonging to the Google Voice backend infrastructure

Notes:

• minimum supported version of Android:
  • Android 3.0 (API level 11)

Legal:

• copyright: Warren Bank
• license: GPL-2.0