zsyed91 / vaccine-spotter

scrape vaccinespotter.org for vaccine availability in your zip code

vaccine-spotter

• Checks COVID-19 Vaccine Spotter for COVID-19 vaccine appointments
• Beeps a bunch when it finds one

Prerequisites

You need to have Ruby:

• macOS instructions
• Windows instructions

After you install Ruby, you also need to install bundler. To install, run this on your command line:

gem install bundler

Short instructions (if you're familiar with Ruby / command line tools)

1. Clone this repo
2. bundle
3. bundle exec ruby vaccine.rb --state <state code> --zipcodes <list of zipcodes> (for example bundle exec ruby vaccine.rb --state CA --zipcodes 94022,94024)
4. For all options run bundle exec ruby vaccine.rb --help

Longer instructions (if this stuff is alien to you)

1. Clone this repo or download as a .zip file
2. Open a command line tool (e.g. Terminal.app / iTerm.app on Mac)
3. Change to the vaccine-spotter directory; for example

   cd ~/Downloads/vaccine-spotter

   On macOS, if you don't know the exact path, you can just type cd and then drag the folder from Finder into the Terminal window, then press return
4. Run bundle to install dependencies
5. Run bundle exec ruby vaccine.rb --state <state code> --zipcodes <list of zipcodes> to start

   Example: bundle exec ruby vaccine.rb --state CA --zipcodes 94022,94024

   • state is the 2 letter abbreviation (examples: CA, NY, IL, etc)
   • zipcodes is a comma-separated list of zip codes, and you'll be alerted if there's a vaccine in any of them
6. Make sure your volume is ALL THE WAY UP so you can hear the beeps even if you're sleeping