Vaccine spotter for India using pincode

Vaccine spotter is a simple tool for tracking the availability of Covid vaccines in any state in India by pincode or district code. It uses the api from COWIN site to monitor for vaccine availability and sent an immediate email ✉️ to user. ✨

Features

Check availability of vaccine by providing pincode or district code of your area
Run in the terminal and monitor the vaccine availability
Send email to email address set by user immediately when there is vaccines available
set age range to check availability in that range.

Set Up

Vaccine-spotter requires python3 to run

Project dependencies can be installed using the following command:

pip install -r requirements.txt

Note 📓 For gmail, the less secure apps connection needs to be turned on for email to work from here. for other mail providers the smpt address should be modified.

Usage

For running these scripts you've to set the email details in config file file. Edit following part of code in config file file

email:
  sent_from : "<sender_email>" 
  email_password : "<sender_password>"

  # [edit] enter receiver email details
  to : ["<receiver_email_id>"]

There are two ways in which you can see vaccine availability

Using pincode.

Set your area pincode in config file file as shown below. Find pincode of your area here

area_info:
# [edit] enter your district code or pincode
  __district_code : "<district_code>" 
  __pincode : "<pincode>"

Edit vaccineSpotter file and set

query_type = "pincode"

Run

python3 vaccineSpotter.py

Then it'll search for vaccine availability in your area.

Using district code

Set district code in the config file file. To know your district code follow these steps:

First see your state code here
Now edit your state code in this url https://cdn-api.co-vin.in/api/v2/admin/location/districts/{your_state_code} e.g. https://cdn-api.co-vin.in/api/v2/admin/location/districts/16 for karnataka
click on the url for your state you can see your district code by searching your district name.

Enter the district code in config file file

area_info:
# [edit] enter your district code or pincode
  __district_code : "<district_code>"

Edit vaccineSpotter file and set

query_type = "district_code"

Run the script after setting the values

python3 vaccineSpotter.py

It'll search for availibility of vaccine centers in that area.

Development

Want to contribute? Great! Feel free to raise a pull request 🤗