A simple java program that uses web scrapping technology to determine if a vaccine is available in your location and sends you an email.
This version has great behind the scene improvements. It increases reliability and handles errors better. It also checks for valid data and gives appropriate error messages. This version also removes old dependencies and adds a Javadoc and comments to the source code. Click here to view the Javadoc.
Fixed a bug where emails would not send and combined setup and checker into a single java file and jar file. To run the setup, just pass the file path to the java program. Also, added the user's name to the email.
This version includes bug fixes, the ability to includes a date for when a vaccine needs to be scheduled, multiple email addresses for a person being checked, and config file updates. In order to use this new version with your current config file, please run the vaccine-checker set up and run the upgrade command. Please report any issues and bugs you encounter.
This is a simple program which allows for easy adding, modifying, and removing of people and email address. This program is in beta and could result in data loss in the config file. Please backup your config file before using it. If you experience data loss, please report an issue and describe how the data loss occurred. The VaccineCheckerSetup jar file takes a single argument, the full path to the config file. Please make sure the file config file exists before running the program.
The only dependency is Java 15+
Any fields with a '*' are required and the program will not work if they are not provided. Any field with a '?' is optional and can be used to get a more accurate update of vaccine availability. Any other keys in the JSON file will be ignored but the program will run the same, as long as the conf file is valid.
This program uses Microsoft Edge Chromium to perform web scraping. You will need to make sure Microsoft Edge Chromium is downloaded on your computer. To download it click here. If you want to run this program on a Linux distribution, you will need to download the Insider Build of edge, which can be found here
Once the web browser is installed you will need to download the selenium web driver for the exact version of your edge install. Click here to download the right version.
After having the conf file setup and the browser downloaded with the web driver, then you can run the program. The program takes 2 arguments.
- Path to the conf file. Make sure to copy the full path for this
- Path to the web driver. Make sure to copy the full path for this and make sure the path is to the actual driver, not the folder. It should either have no file extension or a .exe extension
The command to run the program is java -jar VaccineChecker.jar conf.json msedgedriver
The recommended way to run this program automatically is by creating a crontab. On Linux type crontab -e
to edit your local crontab. I would recommend having the program run every 2 minutes. Crontab syntax for every two minutes is */2 * * * *
then the command. Make sure you pass the full file path for the config file and the web driver. If you need help with the crontab syntax I recommend this website
Special thanks to the covid vaccine spotter GitHub project for making this possible. Please check them out @GUI
Any questions, comments, concerns, feedback, or improvements are appreciated. Add an issue and I will determine how to accommodate any feedback or improvements.