https://github.com/ashish-r/cowin-vaccinator
CoWIN: Vaccinator đź’‰ A browser extension for superfast automated booking of vaccine slots on CoWIN.
https://github.com/ashish-r/cowin-vaccinator
automation browser-extension chrome-extension covid-19 cowin javascript vaccine-tracker
Last synced: 27 days ago
JSON representation
CoWIN: Vaccinator đź’‰ A browser extension for superfast automated booking of vaccine slots on CoWIN.
- Host: GitHub
- URL: https://github.com/ashish-r/cowin-vaccinator
- Owner: ashish-r
- License: apache-2.0
- Created: 2021-06-05T09:31:29.000Z (almost 4 years ago)
- Default Branch: main
- Last Pushed: 2023-01-07T08:09:08.000Z (over 2 years ago)
- Last Synced: 2023-02-28T21:56:32.708Z (about 2 years ago)
- Topics: automation, browser-extension, chrome-extension, covid-19, cowin, javascript, vaccine-tracker
- Language: JavaScript
- Homepage: https://cowin.ashish.link
- Size: 1.53 MB
- Stars: 9
- Watchers: 2
- Forks: 3
- Open Issues: 6
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# CoWIN: Vaccinator đź’‰
A browser extension for superfast automated booking of vaccine slots on [CoWIN](https://selfregistration.cowin.gov.in/).
## Installation
### Chrome web store
[CoWIN: Vaccinator đź’‰](https://chrome.google.com/webstore/detail/cowin-vaccinator-%F0%9F%92%89/edjhnplefifonpibnpeieioopodfloio) is available on the [chrome web store](https://chrome.google.com/webstore/detail/cowin-vaccinator-%F0%9F%92%89/edjhnplefifonpibnpeieioopodfloio). Just click on **Add to Chrome** to add this extension to your browser.
### Manual install
To manually install this extension, you need to enable the _Developer mode_.
Open extensions([chrome://extensions/](chrome://extensions/)) and check the box for "Developer mode" in the top right. For more details, [click here](https://developer.chrome.com/docs/extensions/mv3/faq/#faq-dev-01).
You can now [drag and drop](#drag-and-drop) or [load the unpacked directory of files](#load-unpacked) to install.
#### Drag and drop
**Download** the packed `crx` file from [here](https://raw.githubusercontent.com/ashish-r/cowin-vaccinator/build/bin/cowin-vaccinator.crx).
Open extensions, or visit [chrome://extensions/](chrome://extensions/) and _drag-and-drop_ the downloaded `crx` file on this page.
#### Load unpacked
**Download** the zipped `zip` file from [here](https://raw.githubusercontent.com/ashish-r/cowin-vaccinator/build/bin/cowin-vaccinator.zip).
Unzip/extract files in a folder.
Open extensions, or visit [chrome://extensions/](chrome://extensions/) and click on "Load unpacked" to select the folder where you have extracted the `zip` file contents.
## Uses
After installation, visit the [CoWIN self-registration portal](https://selfregistration.cowin.gov.in/).
You'll see a button to start the bot. Click on that button, fill in your details, and click on book my vaccine.
The bot will automatically fill in all your details on the CoWin website, and you only need to enter the OTP.
Once you enter the OTP, the bot will continuously search for available slots, and if found, it will auto-book it for you.
In case the bot is stuck or behaves unexpectedly, stop the bot and try refreshing the page.
All the data provided by you always stay on your computer. It is not stored/shared anywhere else.
### Advanced Features
#### Superfast login
The bot saves your mobile number so, in case of log out, you only need to provide the OTP for a superfast login experience.
#### Multiple Pin Code
You can enter multiple comma(,) separated pin codes. The bot will search for the vaccine availability at all provided pin codes one by one.
#### Search By State & District
You can also search for vaccine availability with State & District. You can only search with pin codes or state and district.
#### Multi-User Accounts
The bot supports accounts with multiple registered members. You need to select the correct Member Number On Dashboard. Example: If you have 3 registered members in one account, you can use this bot to book vaccines for all the 3 members one by one. You just need to provide the correct member number(the order in which they are present on the dashboard) for every member on the dashboard.
#### Dose 2
The bot also supports automated superfast booking for the second dose of vaccine.
#### Vaccine Preference
You can select the vaccine type from Covishield / Covaxin / Sputnik. You can also limit your search for only free vaccines.
#### Choose Vaccine Centre
If Let Me Choose The Vaccination Center is checked, the bot will hide all unavailable slots so you can choose the vaccine center from the list of all available centers, based on your preference.
#### Autobook
If Autobook is selected, the bot will automatically select the available vaccination center and a time slot to autocomplete the booking for you.
#### Retry Interval
The interval after which the bot should retry searching. CoWIN allows 20 searches within 15 mins, please provide this value responsibly.
#### Rate Limit Pause
If selected, the bot automatically pauses after it reaches the 20 search rate limit in 15 mins and it automatically continues after the cool-down period.
#### Audio Alerts
You get an audio alert when a slot is found or when you need to enter your OTP so that you never miss the opportunity to book a slot.
## Screenshots
## Development
Clone the repository from [github.com/ashish-r/cowin-vaccinator](https://github.com/ashish-r/cowin-vaccinator). [](https://deepscan.io/dashboard#view=project&tid=10012&pid=17476&bid=401367)
### npm run build
Transpiles the code to es5, bundles with `manifest.json`, and creates a zip file under the `bin` directory.