Skip to content

Latest commit

 

History

History
101 lines (77 loc) · 4.08 KB

README.md

File metadata and controls

101 lines (77 loc) · 4.08 KB
Raw

ShellMS Logo ShellMS

ShellMS - Android Debug Bridge Shell SMS Application

ShellMS is the simplest and easiest ADB Shell Messaging Application. If you don't know what ADB or SDK is you definitely don't need this app. For the others it's useful tool to speed up messaging when you're working on your computer.

Screenshot

Download => APK is availible on F-Droid:

Usage:

  • with mobile phone numbers:
    • adb shell am startservice --user 0 -n com.android.shellms/.sendSMS -e contact +123456789 -e msg "Message"
  • with display names from phone:
    • adb shell am startservice --user 0 -n com.android.shellms/.sendSMS -e contact "Contact's DISPLAY NAME" -e msg "MSG"

Special features:

  • Secret SMS (don't store sms in outbox; useful when you send many sms):
    • append " --esn secret " to the end of the service call above

Hints / Notes:

  • If you're using a new cyanogenmod version => ! disable Privacy Guard for ShellMS ! (otherwise the app can't search in your phonebook for the contact-names and can't add sent messages to the outbox)
  • When you use the app with names, the programm will only searching if it matches the phone's DisplayName from your contact. If the name matches then it searches ONLY for mobile phone numbers. Other numbers will not be processed.

Used permissions:

  • android.permission.SEND_SMS => surprisingly to send sms
  • android.permission.READ_SMS => to store in the outbox
  • android.permission.WRITE_SMS => to store in the outbox
  • android.permission.READ_CONTACTS => to get the names from the phone

Templates:

Changelog:

v1.5 (20180526)

  • gradle build structure & cleanup

v1.4 (20180523)

  • updated target version to 27
  • updated minimum version to 21
  • code cleanup

v1.3 (20150118)

  • updated target version to 21
  • removed deprecated "PhoneNumberUtils.formatNumber" function.
  • phone number validation optimized

v1.2 (20131107)

  • disabled the delivery reports for sent sms - it produces costs for some providers.

v1.1 (20130704)

  • fixed crash when sending long SMS
  • improved shell template

v1.0 (20130425)

  • first release

License: GPLv3+

ShellMS - Android Debug Bridge Shell SMS Application
https://github.com/try2codesecure/ShellMS

This program is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation, either version 3 of the License, or
any later version.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU General Public License for more details.

You should have received a copy of the GNU General Public License
along with this program. If not, see <http://www.gnu.org/licenses/>.

Bug found? PLEASE report it =>

Debugging:

  • Debug Mode (hopefully, you'll never need it)
    • append " --esn debug " to the end of the service call above. Enables more output to logcat
  • Use logcat to see the service output
    • adb logcat | grep ShellMS_Service_sendSMS
    • adb logcat -d -s -C ShellMS_Service_sendSMS:*
  • or the main outpput
    • adb logcat | grep com.android.shellms

Roadmap / to do (planned improvements in the future):

  • improve the sendsms function => with reply value if it's sent correct (BroadcastReceivers)
  • template for windows (power)shell
  • password secured service execution => right now, every user/process on the phone can execute it.