This python script will help you book the slots for the vaccines on CoWIN portal very fast ⚡. It notifies the user as soon as the slots are available for booking.
While India is working very hard to provide every means to vaccinate everyone, still there is a big shortage of doses available to people. Due to high demand and low supplies vaccination slots are filled in a very short time. It's very tiring, frustrating and time consuming to sit in front of your phone or desktop and refresh every now and then to look for the open spots and still we can miss them. It's better to automate this job and let software handle this task. Also, most of the available options for tracking either notify very late or have bugs in them.
Script uses a telegram bot to notify you as soon as a slot is available for booking. As you get the notification you can easily login to CoWIN portal and book your slots. Thus saving a lot of time spent on clicking/refreshing the page for the repetitive job. Also, because it's a raw python script, it has the room for modifications.
- A good selection of filters, notified only when it's time. 📳 ✔️
- Takes very less resources in the background, no CPU loading at all. 🔋
- Minimal approach, easy to understand, low latency. ⏱️
- Can be modified to integrate with multiple broadcasting channels.(Bots, email, SMS, etc.) 💬
- Selectable refresh frequecy, upto 100 API calls in 5 min. (1 in every 3 sec) 🔁
- Properly formatted data, easy to read. 📃
- No repetitive notifications, notifies only on change. 📲
- Automatic date capture, no need to change dates at midnight, sleep well Tommy. 😌
- Micro-computer compatible. Ex. Raspberry Pi, BeagleBone etc. 💻
- Create a Python virtual environment in a separate directory and activate it.
- python -m venv venv
- source venv/bin/activate
- Clone the repo, install all the requirements from requirements.txt
- git clone 'repo-address'
- cd Fastest-CoWin-First
- pip install -r requirements.txt
- Download and Install Telegram on your phone/desktop form here.
- Create a Telegram bot using BotFather. (Follow the article from references.)
- Configure your bot on desktop using -
- telegram-send --configure
- Set the pin-code and filters in the script.
- Run the script in the background.
- python fastest-covin-first.py
- In case if telegram error notifications are enabled, the script would notify you only once. Make sure to debug the connection in case of an error.
- The design of script is such that it notifies/logs only if there is a change in response compared to previous responses.
- You can switch the Telegram notifications on/off, but terminal logs are always enabled.
- On terminal a num_req variable shows the number of times script tried to hit the API with last recieved response above it.
- Always remember to maintain a good internet connection on both sides, your notification receiving device and the device running the script.
This script only notifies you when there is an empty slot. It does not book slots for you. For booking you have to manually login and select the slot. The booking API is restricted by the government for the official use only. So, it's not possible todo so.
Filters are very easy to understand by reading comments in code. A proper list of usecase will be available soon.
You can follow this article for that. It's very easy, given you have a phone and a desktop with a working internet connection.