Skip to content
This repository has been archived by the owner on Jul 2, 2021. It is now read-only.

This tracks vaccines available at HEB stores near you and notifies you when one is available to sign up for.

Notifications You must be signed in to change notification settings

tannerblair/tx-vaccine-tracker

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

44 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

TX Vaccine Tracker

TX Vaccine Tracker is a Python application for finding vaccination appointments at H-E-B stores in the state of Texas.

Installation

  1. Clone the repository to your computer
  2. If needed, install Python.
  3. Install packages in requirements.txt

Usage

VaccineTracker Parameters

Field Datatype Description
notifiers List[Notifier] What user notifications to call when a vaccine is available.
origin Tuple[float, float] The home coordinates to use when calculating distances.
max_dist int The maximum distance in miles you are willing to travel from home_coords for your vaccine.
min_qty int The minimum number of available vaccines you want to be notified for.
refresh_rate int How often to check for new appointments, in seconds.

Examples

There are examples in the examples directory, and basic usage is shown below:

from vaccinetracker import *

# The coordinates for the Texas Capitol.
home_coords = (30.274915353266977, -97.74035050144215)
app = Application(
    notifiers=[
        WinBeeper(200, 400),  # play a 200Hz tone for 400ms
        ConsolePrinter(home_coords),  # Print appointment info to the console
        LinkOpener()  # Open the link to the signup form
    ],
    origin=home_coords,
    min_qty=1,  # Don't show notifications less than 1
    max_dist=20,  # Search within 20 miles
    rate=10  # update the results every 10 seconds
)
app.run()

Contributing

Pull requests are welcome. For major changes, please open an issue first to discuss what you would like to change.

Please make sure to update tests as appropriate.

License

MIT

About

This tracks vaccines available at HEB stores near you and notifies you when one is available to sign up for.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages