Giter Club home page Giter Club logo

bulk-sms's Introduction

๐Ÿ“ฎ 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.

bulk-sms's People

Contributors

malokhvii-eduard avatar pre-commit-ci[bot] avatar

Stargazers

 avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar

Watchers

 avatar  avatar

bulk-sms's Issues

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.