Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

https://github.com/abhinavdc/cowin-pinger

Get notified on your phone when there is a vaccine slot available at your location, by running a script on your computer. Uses Cowin portal's public API.
https://github.com/abhinavdc/cowin-pinger

automation covid cowin ifttt npm vaccination vaccine-availability

Last synced: 3 months ago
JSON representation

Get notified on your phone when there is a vaccine slot available at your location, by running a script on your computer. Uses Cowin portal's public API.

Lists

README

        

# 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.

![Instructions-GIF](https://github.com/abhinavdc/cowin-pinger/blob/main/img/instructions.gif)

## GETTING STARTED

Install [node](https://nodejs.org/en/download/), if not already installed. Then run the following command:

npx cowin-pinger run --age= --district= --dose=

Replace the arguments above with the required values like mentioned below

- Replace `` with your age.

- Replace `` with your district's id from this [list](#district_list).

- Replace `` with either 1 or 2 for first dose and second dose respectively.

Optional arguments accepted:

- Pass `--vaccine=` to search for specific vaccine. Accepted values are `COVISHIELD`, `COVAXIN` and `SPUTNIK`.
- Pass `--interval=` to change the frequency of calling Cowin API (default is 10 mins).
- Pass `--date=` to search for slots after a particular date. Date must be in dd-mm-yyyy format (default is today's date).
- Pass `--appts=` to specify the number of session details you want to receive in the notification (default is 2).
- Pass `--pin=` to search for available slots based on pin code. (`` is not required and will be ignored if searching by PIN)
- Pass `--type=` to search for vaccine centers based on price. Accepted values are `free`, `paid` and `all`. (default is all)
- Pass `--keep-alive=` 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](https://ifttt.com/) you can recieve the notification on your phone.
Wondering what IFTTT is ? Read here - [#21](https://github.com/abhinavdc/cowin-pinger/issues/21)
- ### Setting Up IFTTT

- Follow the steps mentioned in the [article](https://betterprogramming.pub/how-to-send-push-notifications-to-your-phone-from-any-script-6b70e34748f6) 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= --hook= --age= --district=

- Replace `` with your WebHook Key from IFTTT.

- Replace `` with the name you used for the WebHook in IFTTT.

## District IDs

Andaman & Nicobar Islands

- 3: Nicobar
- 1: North and Middle Andaman
- 2: South Andaman

Andhra Pradesh

- 9: Anantapur
- 10: Chittoor
- 11: East Godavari
- 5: Guntur
- 4: Krishna
- 7: Kurnool
- 12: Prakasam
- 13: Sri Potti Sriramulu Nellore
- 14: Srikakulam
- 8: Visakhapatnam
- 15: Vizianagaram
- 16: West Godavari
- 6: YSR District, Kadapa (Cuddapah)

Arunachal Pradesh

- 22: Anjaw
- 20: Changlang
- 25: Dibang Valley
- 23: East Kameng
- 42: East Siang
- 17: Itanagar Capital Complex
- 24: Kamle
- 27: Kra Daadi
- 21: Kurung Kumey
- 33: Lepa Rada
- 29: Lohit
- 40: Longding
- 31: Lower Dibang Valley
- 18: Lower Siang
- 32: Lower Subansiri
- 36: Namsai
- 19: Pakke Kessang
- 39: Papum Pare
- 35: Shi Yomi
- 37: Siang
- 30: Tawang
- 26: Tirap
- 34: Upper Siang
- 41: Upper Subansiri
- 28: West Kameng
- 38: West Siang

Assam

- 46: Baksa
- 47: Barpeta
- 765: Biswanath
- 57: Bongaigaon
- 66: Cachar
- 766: Charaideo
- 58: Chirang
- 48: Darrang
- 62: Dhemaji
- 59: Dhubri
- 43: Dibrugarh
- 67: Dima Hasao
- 60: Goalpara
- 53: Golaghat
- 68: Hailakandi
- 764: Hojai
- 54: Jorhat
- 49: Kamrup Metropolitan
- 50: Kamrup Rural
- 51: Karbi-Anglong
- 69: Karimganj
- 61: Kokrajhar
- 63: Lakhimpur
- 767: Majuli
- 55: Morigaon
- 56: Nagaon
- 52: Nalbari
- 44: Sivasagar
- 64: Sonitpur
- 768: South Salmara Mankachar
- 45: Tinsukia
- 65: Udalguri
- 769: West Karbi Anglong

Bihar

- 74: Araria
- 78: Arwal
- 77: Aurangabad
- 83: Banka
- 98: Begusarai
- 82: Bhagalpur
- 99: Bhojpur
- 100: Buxar
- 94: Darbhanga
- 105: East Champaran
- 79: Gaya
- 104: Gopalganj
- 107: Jamui
- 91: Jehanabad
- 80: Kaimur
- 75: Katihar
- 101: Khagaria
- 76: Kishanganj
- 84: Lakhisarai
- 70: Madhepura
- 95: Madhubani
- 85: Munger
- 86: Muzaffarpur
- 90: Nalanda
- 92: Nawada
- 97: Patna
- 73: Purnia
- 81: Rohtas
- 71: Saharsa
- 96: Samastipur
- 102: Saran
- 93: Sheikhpura
- 87: Sheohar
- 88: Sitamarhi
- 103: Siwan
- 72: Supaul
- 89: Vaishali
- 106: West Champaran

Chandigarh

108 Chandigarh

Chhattisgarh

- 110: Balod
- 111: Baloda bazar
- 112: Balrampur
- 113: Bastar
- 114: Bemetara
- 115: Bijapur
- 116: Bilaspur
- 117: Dantewada
- 118: Dhamtari
- 119: Durg
- 120: Gariaband
- 136: Gaurela Pendra Marwahi
- 121: Janjgir-Champa
- 122: Jashpur
- 123: Kanker
- 135: Kawardha
- 124: Kondagaon
- 125: Korba
- 126: Koriya
- 127: Mahasamund
- 128: Mungeli
- 129: Narayanpur
- 130: Raigarh
- 109: Raipur
- 131: Rajnandgaon
- 132: Sukma
- 133: Surajpur
- 134: Surguja

Dadra And Nagar Haveli

137 Dadra and Nagar Haveli

Delhi

- 141: Central Delhi
- 145: East Delhi
- 140: New Delhi
- 146: North Delhi
- 147: North East Delhi
- 143: North West Delhi
- 148: Shahdara
- 149: South Delhi
- 144: South East Delhi
- 150: South West Delhi
- 142: West Delhi

Goa

- 151: North Goa
- 152: South Goa

Gujarat

- 154: Ahmedabad
- 770: Ahmedabad Corporation
- 174: Amreli
- 179: Anand
- 158: Aravalli
- 159: Banaskantha
- 180: Bharuch
- 175: Bhavnagar
- 771: Bhavnagar Corporation
- 176: Botad
- 181: Chhotaudepur
- 182: Dahod
- 163: Dang
- 168: Devbhumi Dwaraka
- 153: Gandhinagar
- 772: Gandhinagar Corporation
- 177: Gir Somnath
- 169: Jamnagar
- 773: Jamnagar Corporation
- 178: Junagadh
- 774: Junagadh Corporation
- 156: Kheda
- 170: Kutch
- 183: Mahisagar
- 160: Mehsana
- 171: Morbi
- 184: Narmada
- 164: Navsari
- 185: Panchmahal
- 161: Patan
- 172: Porbandar
- 173: Rajkot
- 775: Rajkot Corporation
- 162: Sabarkantha
- 165: Surat
- 776: Surat Corporation
- 157: Surendranagar
- 166: Tapi
- 155: Vadodara
- 777: Vadodara Corporation
- 167: Valsad

Haryana

- 193: Ambala
- 200: Bhiwani
- 201: Charkhi Dadri
- 199: Faridabad
- 196: Fatehabad
- 188: Gurgaon
- 191: Hisar
- 189: Jhajjar
- 204: Jind
- 190: Kaithal
- 203: Karnal
- 186: Kurukshetra
- 206: Mahendragarh
- 205: Nuh
- 207: Palwal
- 187: Panchkula
- 195: Panipat
- 202: Rewari
- 192: Rohtak
- 194: Sirsa
- 198: Sonipat
- 197: Yamunanagar

Himachal Pradesh

- 219: Bilaspur
- 214: Chamba
- 217: Hamirpur
- 213: Kangra
- 216: Kinnaur
- 211: Kullu
- 210: Lahaul Spiti
- 215: Mandi
- 208: Shimla
- 212: Sirmaur
- 209: Solan
- 218: Una

Jammu & Kashmir

- 224: Anantnag
- 223: Bandipore
- 225: Baramulla
- 229: Budgam
- 232: Doda
- 228: Ganderbal
- 230: Jammu
- 234: Kathua
- 231: Kishtwar
- 221: Kulgam
- 226: Kupwara
- 238: Poonch
- 227: Pulwama
- 237: Rajouri
- 235: Ramban
- 239: Reasi
- 236: Samba
- 222: Shopian
- 220: Srinagar
- 233: Udhampur

Jharkhand

- 242: Bokaro
- 245: Chatra
- 253: Deoghar
- 257: Dhanbad
- 258: Dumka
- 247: East Singhbhum
- 243: Garhwa
- 256: Giridih
- 262: Godda
- 251: Gumla
- 255: Hazaribagh
- 259: Jamtara
- 252: Khunti
- 241: Koderma
- 244: Latehar
- 250: Lohardaga
- 261: Pakur
- 246: Palamu
- 254: Ramgarh
- 240: Ranchi
- 260: Sahebganj
- 248: Seraikela Kharsawan
- 249: Simdega
- 263: West Singhbhum

Karnataka

- 270: Bagalkot
- 276: Bangalore Rural
- 265: Bangalore Urban
- 294: BBMP
- 264: Belgaum
- 274: Bellary
- 272: Bidar
- 271: Chamarajanagar
- 273: Chikamagalur
- 291: Chikkaballapur
- 268: Chitradurga
- 269: Dakshina Kannada
- 275: Davanagere
- 278: Dharwad
- 280: Gadag
- 267: Gulbarga
- 289: Hassan
- 279: Haveri
- 283: Kodagu
- 277: Kolar
- 282: Koppal
- 290: Mandya
- 266: Mysore
- 284: Raichur
- 292: Ramanagara
- 287: Shimoga
- 288: Tumkur
- 286: Udupi
- 281: Uttar Kannada
- 293: Vijayapura
- 285: Yadgir

Kerala

- 301: Alappuzha
- 307: Ernakulam
- 306: Idukki
- 297: Kannur
- 295: Kasaragod
- 298: Kollam
- 304: Kottayam
- 305: Kozhikode
- 302: Malappuram
- 308: Palakkad
- 300: Pathanamthitta
- 296: Thiruvananthapuram
- 303: Thrissur
- 299: Wayanad

Ladakh

- 309: Kargil
- 310: Leh

Lakshwadweep islands

- 796: Agatti Island
- 311: Lakshadweep

Madhya Pradesh

- 320: Agar
- 357: Alirajpur
- 334: Anuppur
- 354: Ashoknagar
- 338: Balaghat
- 343: Barwani
- 362: Betul
- 351: Bhind
- 312: Bhopal
- 342: Burhanpur
- 328: Chhatarpur
- 337: Chhindwara
- 327: Damoh
- 350: Datia
- 324: Dewas
- 341: Dhar
- 336: Dindori
- 348: Guna
- 313: Gwalior
- 361: Harda
- 360: Hoshangabad
- 314: Indore
- 315: Jabalpur
- 340: Jhabua
- 353: Katni
- 339: Khandwa
- 344: Khargone
- 335: Mandla
- 319: Mandsaur
- 347: Morena
- 352: Narsinghpur
- 323: Neemuch
- 326: Panna
- 359: Raisen
- 358: Rajgarh
- 322: Ratlam
- 316: Rewa
- 317: Sagar
- 333: Satna
- 356: Sehore
- 349: Seoni
- 332: Shahdol
- 321: Shajapur
- 346: Sheopur
- 345: Shivpuri
- 331: Sidhi
- 330: Singrauli
- 325: Tikamgarh
- 318: Ujjain
- 329: Umaria
- 355: Vidisha

Maharashtra

- 391: Ahmednagar
- 364: Akola
- 366: Amravati
- 397: Aurangabad
- 384: Beed
- 370: Bhandara
- 367: Buldhana
- 380: Chandrapur
- 388: Dhule
- 379: Gadchiroli
- 378: Gondia
- 386: Hingoli
- 390: Jalgaon
- 396: Jalna
- 371: Kolhapur
- 383: Latur
- 395: Mumbai
- 365: Nagpur
- 382: Nanded
- 387: Nandurbar
- 389: Nashik
- 381: Osmanabad
- 394: Palghar
- 385: Parbhani
- 363: Pune
- 393: Raigad
- 372: Ratnagiri
- 373: Sangli
- 376: Satara
- 374: Sindhudurg
- 375: Solapur
- 392: Thane
- 377: Wardha
- 369: Washim
- 368: Yavatmal

Manipur

- 398: Bishnupur
- 399: Chandel
- 400: Churachandpur
- 401: Imphal East
- 402: Imphal West
- 410: Jiribam
- 413: Kakching
- 409: Kamjong
- 408: Kangpokpi
- 412: Noney
- 411: Pherzawl
- 403: Senapati
- 404: Tamenglong
- 407: Tengnoupal
- 405: Thoubal
- 406: Ukhrul

Meghalaya

- 424: East Garo Hills
- 418: East Jaintia Hills
- 414: East Khasi Hills
- 423: North Garo Hills
- 417: Ri-Bhoi
- 421: South Garo Hills
- 422: South West Garo Hills
- 415: South West Khasi Hills
- 420: West Garo Hills
- 416: West Jaintia Hills
- 419: West Khasi Hills

Mizoram

- 425: Aizawl East
- 426: Aizawl West
- 429: Champhai
- 428: Kolasib
- 432: Lawngtlai
- 431: Lunglei
- 427: Mamit
- 430: Serchhip
- 433: Siaha

Nagaland

- 434: Dimapur
- 444: Kiphire
- 441: Kohima
- 438: Longleng
- 437: Mokokchung
- 439: Mon
- 435: Peren
- 443: Phek
- 440: Tuensang
- 436: Wokha
- 442: Zunheboto

Odisha

- 445: Angul
- 448: Balangir
- 447: Balasore
- 472: Bargarh
- 454: Bhadrak
- 468: Boudh
- 457: Cuttack
- 473: Deogarh
- 458: Dhenkanal
- 467: Gajapati
- 449: Ganjam
- 459: Jagatsinghpur
- 460: Jajpur
- 474: Jharsuguda
- 464: Kalahandi
- 450: Kandhamal
- 461: Kendrapara
- 455: Kendujhar
- 446: Khurda
- 451: Koraput
- 469: Malkangiri
- 456: Mayurbhanj
- 470: Nabarangpur
- 462: Nayagarh
- 465: Nuapada
- 463: Puri
- 471: Rayagada
- 452: Sambalpur
- 466: Subarnapur
- 453: Sundargarh

Puducherry

- 476: Karaikal
- 477: Mahe
- 475: Puducherry
- 478: Yanam

Punjab

- 485: Amritsar
- 483: Barnala
- 493: Bathinda
- 499: Faridkot
- 484: Fatehgarh Sahib
- 487: Fazilka
- 480: Ferozpur
- 489: Gurdaspur
- 481: Hoshiarpur
- 492: Jalandhar
- 479: Kapurthala
- 488: Ludhiana
- 482: Mansa
- 491: Moga
- 486: Pathankot
- 494: Patiala
- 497: Rup Nagar
- 498: Sangrur
- 496: SAS Nagar
- 500: SBS Nagar
- 490: Sri Muktsar Sahib
- 495: Tarn Taran

Rajasthan

- 507: Ajmer
- 512: Alwar
- 519: Banswara
- 516: Baran
- 528: Barmer
- 508: Bharatpur
- 523: Bhilwara
- 501: Bikaner
- 514: Bundi
- 521: Chittorgarh
- 530: Churu
- 511: Dausa
- 524: Dholpur
- 520: Dungarpur
- 517: Hanumangarh
- 505: Jaipur I
- 506: Jaipur II
- 527: Jaisalmer
- 533: Jalore
- 515: Jhalawar
- 510: Jhunjhunu
- 502: Jodhpur
- 525: Karauli
- 503: Kota
- 532: Nagaur
- 529: Pali
- 522: Pratapgarh
- 518: Rajsamand
- 534: Sawai Madhopur
- 513: Sikar
- 531: Sirohi
- 509: Sri Ganganagar
- 526: Tonk
- 504: Udaipur

Sikkim

- 535: East Sikkim
- 537: North Sikkim
- 538: South Sikkim
- 536: West Sikkim

Tamil Nadu

- 779: Aranthangi
- 555: Ariyalur
- 578: Attur
- 565: Chengalpet
- 571: Chennai
- 778: Cheyyar
- 539: Coimbatore
- 547: Cuddalore
- 566: Dharmapuri
- 556: Dindigul
- 563: Erode
- 552: Kallakurichi
- 557: Kanchipuram
- 544: Kanyakumari
- 559: Karur
- 780: Kovilpatti
- 562: Krishnagiri
- 540: Madurai
- 576: Nagapattinam
- 558: Namakkal
- 577: Nilgiris
- 564: Palani
- 573: Paramakudi
- 570: Perambalur
- 575: Poonamallee
- 546: Pudukkottai
- 567: Ramanathapuram
- 781: Ranipet
- 545: Salem
- 561: Sivaganga
- 580: Sivakasi
- 551: Tenkasi
- 541: Thanjavur
- 569: Theni
- 554: Thoothukudi (Tuticorin)
- 560: Tiruchirappalli
- 548: Tirunelveli
- 550: Tirupattur
- 568: Tiruppur
- 572: Tiruvallur
- 553: Tiruvannamalai
- 574: Tiruvarur
- 543: Vellore
- 542: Viluppuram
- 549: Virudhunagar

Telangana

- 582: Adilabad
- 583: Bhadradri Kothagudem
- 581: Hyderabad
- 584: Jagtial
- 585: Jangaon
- 586: Jayashankar Bhupalpally
- 587: Jogulamba Gadwal
- 588: Kamareddy
- 589: Karimnagar
- 590: Khammam
- 591: Kumuram Bheem
- 592: Mahabubabad
- 593: Mahabubnagar
- 594: Mancherial
- 595: Medak
- 596: Medchal
- 612: Mulugu
- 597: Nagarkurnool
- 598: Nalgonda
- 613: Narayanpet
- 599: Nirmal
- 600: Nizamabad
- 601: Peddapalli
- 602: Rajanna Sircilla
- 603: Rangareddy
- 604: Sangareddy
- 605: Siddipet
- 606: Suryapet
- 607: Vikarabad
- 608: Wanaparthy
- 609: Warangal(Rural)
- 610: Warangal(Urban)
- 611: Yadadri Bhuvanagiri

Tripura

- 614: Dhalai
- 615: Gomati
- 616: Khowai
- 617: North Tripura
- 618: Sepahijala
- 619: South Tripura
- 620: Unakoti
- 621: West Tripura

Uttar Pradesh

- 622: Agra
- 623: Aligarh
- 625: Ambedkar Nagar
- 626: Amethi
- 627: Amroha
- 628: Auraiya
- 646: Ayodhya
- 629: Azamgarh
- 630: Badaun
- 631: Baghpat
- 632: Bahraich
- 633: Balarampur
- 634: Ballia
- 635: Banda
- 636: Barabanki
- 637: Bareilly
- 638: Basti
- 687: Bhadohi
- 639: Bijnour
- 640: Bulandshahr
- 641: Chandauli
- 642: Chitrakoot
- 643: Deoria
- 644: Etah
- 645: Etawah
- 647: Farrukhabad
- 648: Fatehpur
- 649: Firozabad
- 650: Gautam Buddha Nagar
- 651: Ghaziabad
- 652: Ghazipur
- 653: Gonda
- 654: Gorakhpur
- 655: Hamirpur
- 656: Hapur
- 657: Hardoi
- 658: Hathras
- 659: Jalaun
- 660: Jaunpur
- 661: Jhansi
- 662: Kannauj
- 663: Kanpur Dehat
- 664: Kanpur Nagar
- 665: Kasganj
- 666: Kaushambi
- 667: Kushinagar
- 668: Lakhimpur Kheri
- 669: Lalitpur
- 670: Lucknow
- 671: Maharajganj
- 672: Mahoba
- 673: Mainpuri
- 674: Mathura
- 675: Mau
- 676: Meerut
- 677: Mirzapur
- 678: Moradabad
- 679: Muzaffarnagar
- 680: Pilibhit
- 682: Pratapgarh
- 624: Prayagraj
- 681: Raebareli
- 683: Rampur
- 684: Saharanpur
- 685: Sambhal
- 686: Sant Kabir Nagar
- 688: Shahjahanpur
- 689: Shamli
- 690: Shravasti
- 691: Siddharthnagar
- 692: Sitapur
- 693: Sonbhadra
- 694: Sultanpur
- 695: Unnao
- 696: Varanasi

Uttarakhand

- 704: Almora
- 707: Bageshwar
- 699: Chamoli
- 708: Champawat
- 697: Dehradun
- 702: Haridwar
- 709: Nainital
- 698: Pauri Garhwal
- 706: Pithoragarh
- 700: Rudraprayag
- 701: Tehri Garhwal
- 705: Udham Singh Nagar
- 703: Uttarkashi

West Bengal

- 710: Alipurduar District
- 711: Bankura
- 712: Basirhat HD (North 24 Parganas)
- 713: Birbhum
- 714: Bishnupur HD (Bankura)
- 715: Cooch Behar
- 783: COOCHBEHAR
- 716: Dakshin Dinajpur
- 717: Darjeeling
- 718: Diamond Harbor HD (S 24 Parganas)
- 719: East Bardhaman
- 720: Hoogly
- 721: Howrah
- 722: Jalpaiguri
- 723: Jhargram
- 724: Kalimpong
- 725: Kolkata
- 726: Malda
- 727: Murshidabad
- 728: Nadia
- 729: Nandigram HD (East Medinipore)
- 730: North 24 Parganas
- 731: Paschim Medinipore
- 732: Purba Medinipore
- 733: Purulia
- 734: Rampurhat HD (Birbhum)
- 735: South 24 Parganas
- 736: Uttar Dinajpur
- 737: West Bardhaman

Daman&Diu

- 138: Daman
- 139: Diu

Himachal Pradesh

- 791: Chamba
- 795: Kangra
- 792: Kinnaur
- 793: Mandi
- 794: Shimla

## Developer Todo
- Option to read config from a local file instead of cli args

### Sample Notification on Phone