Skip to content

Latest commit

 

History

History
130 lines (103 loc) · 5.92 KB

File metadata and controls

130 lines (103 loc) · 5.92 KB

📮 Bulk SMS

A simple tool to send SMS messages over the carrier's network from an Android phone using the Android Debug Bridge.

License pre-commit pre-commit.ci Style Guide markdownlint commitlint flake8 bandit

🎉 Features

  • 🗜️ Small (~121 lines)
  • 🐍 Pure Python
  • 🔌 Working with multiple devices
  • 📌 Save SMS as Draft
  • 🔥 Delete SMS after sending

🌻 Motivation

Probably just for fun at first 🙃. Secondly, for low-cost SMS marketing campaigns without any equipment or external services.

✨ Getting Started

📚 Prerequisites

Firstly you will need to install Android Debug Bridge and Messages application from Google Play. Next, you will need to turn on Developer Options on your Android phone. After the Developer Options are enabled, turn on Stay Awake and USB Debugging. Finally, plug your phone into your computer using a USB cable, copy a message to the clipboard on your phone and check that you have enough credit to send SMS 😅, so here we go! 🚀.

📦 Installation

  1. Clone the Repository
  2. Install this Package (./setup.py install) or install dependencies from Pipfile (pipenv install)

👀 Usage

bulk-sms --help # Show help and exit
echo "+380XXXXXXXXX\n+380XXXXXXXX1" | bulk-sms # Send multiple SMS, E.164 format
echo "+380XXXXXXXXX" | bulk-sms -d # Save SMS as Draft
echo "+380XXXXXXXXX" | bulk-sms -x # Delete SMS after sending
echo "+380XXXXXXXXX" | bulk-sms -s XXXXXXXXXXXXXX # Set device serial number

🛠️ Tech Stack

EditorConfig Markdown Python androidviewclient click tqdm pre-commit markdownlint commitlint Shields.io Git GitHub

✍️ Contributing

👍🎉 First off, thanks for taking the time to contribute! 🎉👍

Contributions are what make the open source community such an amazing place to be learn, inspire, and create. Any contributions you make are greatly appreciated.

  1. Fork the Project
  2. Create your Feature Branch (git checkout -b feature/awesome-feature)
  3. Commit your Changes (git commit -m 'Add awesome feature')
  4. Push to the Branch (git push origin feature/awesome-feature)
  5. Open a Pull Request

💖 Like this project?

Leave a ⭐ if you think this project is cool or useful for you.

⚠️ License

bulk-sms is licenced under the MIT License. See the LICENSE for more information.