normantud / impfterminvergabe

A simple proof of concept automation for getting a vaccination appointment against COVID-19 in Saxony, Germany

impfterminvergabe

A simple proof of concept automation for getting a vaccination appointment against COVID-19 in Saxony, Germany.

Idea

This project provides a simple automation build on top of selenium which launches a new Chrome window and submits the form for getting a vaccination appointment. In case you get a suggestion for an available appointment the automation stops and leaves you with an open Chrome window, in which case you can decide to accept or decline and complete the procedure manually.

Quick Start

1. Generate a user account at https://sachsen.impfterminvergabe.de/.

   Make sure to save the username ("Vorgangskennung") and password of your account. You might also want to generate a second user, if you want to get an appointment together with someone other.

2. Make sure you have Google Chrome (or Chromium) installed on your machine. Get the exact version number of Chrome installed on your machine. Simple click the three dots in the upper right corner of Chrome and select Help > About. You should find a version number like Version 90.0.4430.212 (Offizieller Build) (64-Bit).

3. Download the appropriate Chrome Webdriver for your Chrome version and operating system. Afterwards, extract the chromedriver (or chromedriver.exe) file from the zip archive.

4. Create a virtual environment using virtualenv and install the selenium package.

   $ python3 -m venv env
   $ source ./env/bin/activate # or .\env\Scripts\activate on Windows
   $ pip install selenium beepy

   Otherwise, just use the integration of an IDE like PyCharm to get you started.

5. Run the script.

   $ python3 main.py --username="hallo" --password="welt" --impfzentrum="Dresden"
   $ python3 main.py --username="hallo" --password="welt" --impfzentrum "Dresden" "Belgern"

Windows Version

Try the main.exe on Windows, though I cannot properly test it, it should work.

Legal Disclaimer

Copyright © 2021 Felix Kästner

Permission to use, copy, modify, merge, publish, distribute, 
sublicense, and/or sell copies of this software and associated 
documentation files (the “Software”) is hereby not granted to 
any person.

The above copyright notice and this permission notice shall be
included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED “AS IS”, WITHOUT WARRANTY OF ANY KIND,
EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES
OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT
HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
OTHER DEALINGS IN THE SOFTWARE.