Pls Give Vaccine

A script to spam yourself with vaccine notifications.
Explore the docs »

View Demo · Report Bug · Request Feature

Table of Contents

• About the Project
  • Built With
• Getting Started
  • Installation
• Usage
• Roadmap
• Contributing
• License
• Contributors

About The Project

Spam yourself with messages and calls (potentially) upon availability of vaccines (in India).

Built With

• Python

Getting Started

To get a local copy up and running follow these simple steps.

Prerequisites

• python

Installation

1. Clone the Repo

git clone https://github.com/roerohan/pls-give-vaccine.git
cd pls-give-vaccine

Usage

To start the script, run the following command:

• Using district ID

python src/main.py --district <district-id> --telegram <telegram-username> --dose <dose-number>

• Using pincode

python src/main.py --pincode <pincode> --telegram <telegram-username> --dose <dose-number>

To get a list of possible options, run -h.

$ python src/main.py -h                                           


To receive calls, visit https://api2.callmebot.com/txt/login.php and authenticate using telegram.


usage: main.py [-h] [--district district] [--pincode pincode] --telegram telegram [--dose dose]

Command Line Arguments for Pls Give Vaccine

optional arguments:
  -h, --help           show this help message and exit
  --district district  District ID
  --pincode pincode    Pincode
  --telegram telegram  Telegram username
  --dose dose          Dose Number (1 or 2)

Roadmap

See the open issues for a list of proposed features (and known issues).

Contributing

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/AmazingFeature)
3. Commit your Changes (git commit -m 'feat: Add some AmazingFeature')
4. Push to the Branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

You are requested to follow the contribution guidelines specified in CONTRIBUTING.md while contributing to the project 😄.

License

Distributed under the MIT License. See LICENSE for more information.

Contributors ✨

Thanks goes to these wonderful people (emoji key):

Siddharth Singha Roy 📖 💻

Rohan Mukherjee 📖 💻

This project follows the all-contributors specification. Contributions of any kind welcome!