CoWin Slot Finder - (Pythonic way to search)

An automated tool/Script/Application to find available slots for your age and state/district and pin using CoWin API.

Cowin is the portal for pan-India Covid-19 vaccination drive.

How is it different from others?

• Saves your precious time
• No installation required for windows distributions
• Can find slot by Postal Pin code
• Can find slot as per your dose requirement (i.e. First or Second Dose) so no false alarm
• Easy to use and lightweight
• Continuous tracking of slot. No need of user attention after setup.
• Updates data 3 times in a minute and send you a notification on your notification panel.

This script can search through the entire state and organize the results as per district and date. Moreover, it only shows centres with available slots (prevents clutter). Also in Windows 10 systems it is able to send a notification to the user. You don't need to look at the command line for the whole day.

Screenshot

Working of main script find_slots.py

CLI application Searching by PIN

CLI application Searching by state and district code

Instructions

Users with Windows OS

• Download an exe file from the link as per your requirement Download Releases
• Doubble click on application to start
• Follow the app instructions. Learn More about usageHere
• Tip: If you download the icon along with the executable and place it in same file. Notification will look more beautiful.

Users with python 3.0 or grater on any operating system

• Download Any of the CLI application
• Follow the instructions Learn More about usageHere

For Advanced Users Having python Installed

1. Download find_slots.py or clone the repo.
2. Edit variables in the said file.
3. Run, using the instructions below.

Windows

• Install latest Python form this link. or

choco install python

• Open command prompt (cmd) and run the following-

py -m pip install requests
py "(location)\find_slots.py"

or -You can install all dependencies from repo location using below command.

py -m pip install -r requirements.txt

Linux

sudo apt-get install python3
git clone https://github.com/HDash/cowin-slot-finder.git
pip install -r requirements.txt
python3 <script you want to run>

Contribution

Feel free to pull requests.
Share your feedback, suggestions and bugs. :)

Scopes of Developments

• GUI Application
• Mobile Application

Credits

bhattbhavesh91 - json Parsing and request script for cowin API
SridharJena - CLI adaptation for the script, API request fix

License

MIT