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> --dose=<DOSE-NO>

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.

• Replace <DOSE-NO> with either 1 or 2 for first dose and second dose respectively.

Optional arguments accepted:

• Pass --vaccine=<VACCINE-NAME> to search for specific vaccine. Accepted values are COVISHIELD, COVAXIN and SPUTNIK.
• Pass --interval=<INTERVAL-IN-MINUTES> to change the frequency of calling Cowin API (default is 10 mins).
• Pass --date=<DATE> to search for slots after a particular date. Date must be in dd-mm-yyyy format (default is today's date).
• Pass --appts=<APPOINTMENT-COUNT> to specify the number of session details you want to receive in the notification (default is 2).
• Pass --pin=<YOUR-AREA-PIN-CODE> to search for available slots based on pin code. (<DISTRICT-ID> is not required and will be ignored if searching by PIN)
• Pass --type=<VACCINE-TYPE> to search for vaccine centers based on price. Accepted values are free, paid and all. (default is all)

• Pass --keep-alive=<KEEP-ALIVE-FLAG> to continue search even after slots are found. Accepted values are true and false. (default is false)

  (Note: Search by District is recommended as searching by PINCODE will have lower chances of finding a slot)

  IFTTT Integration (Optional)

  By integrating with IFTTT you can recieve the notification on your phone. Wondering what IFTTT is ? Read here - #21

• 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

Developer Todo

• Option to read config from a local file instead of cli args

Sample Notification on Phone