diff --git a/README.md b/README.md index e085a0b..f21eff2 100644 --- a/README.md +++ b/README.md @@ -1,5 +1,6 @@ -# 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 phone. Uses Co-Win public APIs. +# CoWIN Auto Booking Slot + +Auto Book when there is a vaccine slot available at your location, by running a script on your phone. ## Getting Started @@ -8,43 +9,34 @@ Get notified on your phone when there is a vaccine slot available at your locati - Install Termux App [Link](https://play.google.com/store/apps/details?id=com.termux&hl=en_IN&gl=US). - - Install Termux:API App on phone to recieve notifications [Link](https://play.google.com/store/apps/details?id=com.termux.api&hl=en). + - Install Termux App ( Required v 0.31 to read SMS ) [Apkpure Link](https://m.apkpure.com/termux-api/com.termux.api/download/31-APK). + - ### Installing Packages and Requirements - - ### Installing Packages - - Install Python + - Step 1 : ( Install git and Clone repo ) - pkg install python - - - Install Termux-API Package - - pkg install termux-api - - - Install Git - - pkg install git - - - Clone Repo - - git clone https://github.com/truroshan/cowin-termux - - - Install Requirements.txt using pip + pkg install git && git clone https://github.com/truroshan/CoWin-Termux.git - pip install -r requirements.txt + - Step 2 : Open Cloned Folder and run install.sh + + cd CoWin-Termux && bash install.sh -## Running Script +## Running Main Script for CoWin Booking -Install [python](https://wiki.termux.com/wiki/Python), if not already installed on Termux. Then run the following command: +Command for script : - python cowin.py --p --a --t - -Replace the arguments above with the required values like mentioned below - - - Replace `--p=` with your pincode. + python cowin.py --m --p --a --t --d --fast + + python cowin.py --m 9966996699 --p 110011 --a 45 --t 1 --d 1 --fast + +Required values like mentioned below + - Replace `--m = MOBILE-NO` with your mobile no. + - Replace `--p = PIN-CODE` with your pincode. Optional arguments accepted: - - Pass `--a=` with your age (default is 18). - - - Pass `--t=` to change the frequency of calling Cowin API (default is 1 min). + - Pass `--a = YOUR-AGE ` with your age (default is 18). + - Pass `--d = DOSE_COUNT` Vaccine First Dose or Second Dose (default dose is 1). + - Pass `--t = INTERVAL-IN-MINUTES` to change the frequency of calling Cowin API (default is 1 min). + - Only Pass `--fast` for direct booking no scheduling.