Skip to content

README.md

Latest commit

 

History

History
113 lines (93 loc) · 3.76 KB

README.md

File metadata and controls

113 lines (93 loc) · 3.76 KB

SMS Forwarding

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

Notes:

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

Screenshots:

SMS-Forwarding SMS-Forwarding SMS-Forwarding

Configuration

Forwarding Rules:

  • Enable Service checkbox:
    • used to enable/disable this service
  • ADD ActionBar menu item:
    • adds new forwarding rule
  • forwarding rule 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,
          which can either be manually entered into the field
          or automatically set when the field is left empty
      • this value acts as a filter
        • Forwarding recipient will only receive copies of incoming SMS messages that match this value
  • forwarding rule entries can be modified
    • clicking on an existing recipient opens a dialog with options to:
      • edit field values, and save changes
      • delete

Forwarding Rules (Advanced Usage):

  • Forwarding recipient field:
    • supports:
      • comma-separated list of values
        • example: 
            8001190000,8002290000,8003390000
      • line-separated list of values
        • example: 
            8001190000
  8002290000
  8003390000
  • Sender must end with field:
    • supports:
      • <whitelist><list-separator><blacklist>
        • where:
          • both <whitelist> and <blacklist> are a comma-separated or line-separated list of values
          • <whitelist> is required
            • special case:
              • when the value of a list item is the single character: *
                …all other values in <whitelist> are ignored
          • <blacklist> is optional
          • <list-separator> is an optional special token that denotes the start of <blacklist>
            • supported tokens:
              • any of the following single characters: !/#
              • an empty line
        • examples (comma-separated):
          • 8001190000,8002290000,8003390000
          • */8001190000,8002290000,8003390000
          • 0000/8001190000,8002290000,8003390000
          • 0000/90000
        • example (line-separated): 
            *

  8001190000
  8002290000
  8003390000

Build Flavors:

  • english
    • includes string resources for only the English language
  • withAllLanguageTranslations
    • includes string resources for additional languages
  • noContactName
    • "Forwarded from: <sender_phone>"
  • withContactName
    • "Forwarded from: <sender_name> <sender_phone>"
      • if sender_phone is found in the local contacts list,
        and the contact has a name associated with it
    • "Forwarded from: <sender_phone>"
      • otherwise

Caveats:

  • Google Voice:
    • when an SMS is sent from a Google Voice number to the SIM card number
      • everything works as expected
    • when an SMS is sent to a Google Voice number
      • the sender of the SMS message will always be a number belonging to the Google Voice backend infrastructure
      • keep this in mind when setting forwarding filters

Legal: