COWIN VACCINE AVAILABILITY NOTIFIER

Get notified on your phone when there is a vaccine slot available at your location, by running a script on your computer. Uses Co-Win public APIs.

Update: Now works without IFTTT by playing a notification sound when a slot is found.

GETTING STARTED

Install node, if not already installed. Then run the following command:

npx cowin-pinger run --age=<YOUR-AGE> --district=<DISTRICT-ID>

Replace the arguments above with the required values like mentioned below

• Replace <YOUR-AGE> with your age.

• Replace <DISTRICT-ID> with your district's id from this list.

Optional arguments accepted:

• Pass --interval=<INTERVAL-IN-MINUTES> to change the frequency of calling Cowin API (default is 15 mins).
• Pass --appts=<APPOINTMENT-COUNT> to specify the number of session details you want to receive in the notification (default is 2).

IFTTT Integration (Optional)

By integrating with IFTTT you can recieve the notification on your phone.

• Setting Up IFTTT

  • Follow the steps mentioned in the article to setup IFTTT.

  • Install IFTTT App on phone to recieve notifications

  • Test if you receive notification like mentioned in the article above.

• Run Cowin-Pinger with IFTTT Configuration

  npx cowin-pinger run --key=<IFTTT-KEY> --hook=<IFTTT-WEBHOOK-NAME> --age=<YOUR-AGE> --district=<DISTRICT-ID>
  

  • Replace <IFTTT-KEY> with your WebHook Key from IFTTT.

  • Replace <IFTTT-WEBHOOK-NAME> with the name you used for the WebHook in IFTTT.

District IDs

Andaman & Nicobar Islands Andhra Pradesh Arunachal Pradesh Assam Bihar Chandigarh Chhattisgarh Dadra And Nagar Haveli Delhi Goa Gujarat Haryana Himachal Pradesh Jammu & Kashmir Jharkhand Karnataka Kerala Ladakh Lakshwadweep islands Madhya Pradesh Maharashtra Manipur Meghalaya Mizoram Nagaland Odisha Puducherry Punjab Rajasthan Sikkim Tamil Nadu Telangana Tripura Uttar Pradesh Uttarakhand West Bengal Daman&Diu Himachal Pradesh

Developer Todo

• Add option for Pin Code search
• Improve cli interface

Sample Notification on Phone