Automatisierte Impfterminbuchung auf www.impfterminservice.de.
- Automatisches suchen und buchen von verfügbaren Impfterminen
- Suche bei mehreren Impfzentren gleichzeitig
- Warteschlange umgehen
- 🌟 NEU: Dauerhaft Impf-Code's generieren - egal wo, egal für wen!
- 🌟 NEU: Beta Branch (neue, aber noch nicht final getestete Features)
Windows Version: Windows Beta Version: Linux Version: Linux Beta Version:
- DASDING: Danke für das Feature an Dani Rapp!
Unsere Großeltern möchten sich gerne impfen lassen, aber telefonsich unter 116117 kommen sie nicht durch und das Internet ist auch noch immer irgendwie Neuland. Jetzt kommt es zum Konflikt: einerseits möchte man natürlich gerne bei der Terminbuchung helfen, andererseits hat man aber auch keine Lust, deshalb nun den ganzen Tag vor dem Computer zu hocken und die Seite zu aktualisieren...
Zunächst trägst du deinen "Impf-Code" (Beispiel: A1B2-C3D4-E5F6), die PLZ deines Impfzentrums
und deine Daten (Anschrift, Telefon, Mail) ein, die bei der Terminbuchung angegeben werden sollen.
Du wirst zur Eingabe aufgefordert und deine Daten werden in der Datei ./kontaktdaten.json gespeichert.
Hinweis: Es kann sein, dass für mehrere Impfzentren unterschiedliche Codes benötigt werden (mehr Infos: Auflistung der gruppierten Impfzentren).
Anschließend passiert alles automatisch: vaccipy checkt für dich minütlich, ob ein Termin verfügbar ist
und bucht den erstbeste einen zufälligen.
vaccipy nutzt die selben Endpunkte zur Terminbuchung, wie dein Browser.
- Abruf aller Impfzentren und abgleich, ob für die eingetragene PLZ ein Impfzentrum existiert
- Abruf der Impfstoffe, die im gewählten Impfzentrum verfügbar sind
Zur Terminbuchung werden Cookies benötigt (bm_sz), die im Browser automatisch erzeugt werden.
Damit wir diese auch im Script haben, wird zu Beginn eine Chrome-Instanz (im Prinzip ein separates Chrome-Fenster)
geöffnet und eine Unterseite des Impfterminservices aufgerufen.
Anschließend werden die Cookies extrahiert und im Script aufgenommen.
- Cookies abrufen
- Mit dem Code "einloggen", im Browser ist das der Schritt: Impfzentrum auswählen und Impf-Code eintragen
Die nachkommenden Schritte erfolgen im Loop. Es werden minütlich verfügbare Termine abgerufen und,
sollten Termine verfügbar sein, der erstbeste ein zufälliger ausgewählt.
Dieser Prozess kann eine längere Zeit. Sobald die Cookies abgelaufen sind, wird wieder ein Chrome-Fenster geöffnet und neue Cookies erstellt.
-
Termine abrufen: Wenn Termine verfügbar sind, springe zu Schritt 8
-
(Option 1) Eine Minute warten
oder
- (Option 2) bei Ablauf Cookies erneuern
Wenn ein Termin verfügbar ist, wird dieser mit den eingetragenen Daten gebucht.
Achtung! Im nächsten Schritt wird ein verbindlicher Impftermin gebucht!
- Buchen des Impftermins
Nachdem dein Termin erfolgreich gebucht wurde, erhälst du eine Mail, in der du zunächst deine Mail-Adresse bestätigen musst. Nachdem du die Mail bestätigt hast, erhälst du zu jedem Termin eine Buchungsbestätigung. That's it!
Du kannst alternativ deine Buchung auch im Browser einsehen. Dazu musst du dich auf www.impfterminservice.de begeben, dein Impfzentrum auswählen und anschließend rechts-oben auf "Buchung verwalten" klicken.
- Python 3 (getestet mit Python 3.8 und 3.9)
- pip (zur Installation der Python-Module, getestet mit pip3)
- Google Chrome oder Chromium
Die notwendigen Python-Module können mittels pip installiert werden.
pip3 install -r requirements.txtvaccipy kannst du über die Kommandozeile oder in einer beliebigen python-Entwicklungsumgebung
ausgeführen.
Nach dem Programmstart kannst du interaktiv auswählen, ob du einen Impf-Code generieren möchtest,
oder einen Termin suchen möchtest.
python3 main.pyAlternativ kannst du Subkommandos verwenden, um deine Auswahl zu treffen:
# Kontaktdaten (für Impf-Code) eingeben und in kontaktdaten.json speichern:
python3 main.py code --configure-only
# Kontaktdaten (für Impf-Code) eingeben und in beliebiger Datei speichern:
python3 main.py code --configure-only -f max-mustermann.json
# Impf-Code generieren:
python3 main.py code
# Impf-Code generieren und dafür die Kontaktdaten aus beliebiger Datei verwenden:
python3 main.py code -f max-mustermann.json
# Kontaktdaten (für Terminsuche) eingeben und in kontaktdaten.json speichern:
python3 main.py search --configure-only
# Kontaktdaten (für Terminsuche) eingeben und in beliebiger Datei speichern:
python3 main.py search --configure-only -f max-mustermann.json
# Termin suchen:
python3 main.py search
# Termin suchen und dafür die Kontaktdaten aus beliebiger Datei verwenden:
python3 main.py search -f max-mustermann.jsonVACCIPY_CHROMEDRIVER: Name oder relativer Pfad der chromedriver Programmdatei, die du verwenden möchtest. Dies kann verwendet werden, falls du deine eigene chromedriver-Installation verwenden möchtest und wird z. B. auf NixOS benötigt. Beispiel:chromedriver
Für eine bessere Nutzererfahrung erstellen wir verschiedene Distributionen, die ohne installation von Python direkt ausgeführt werden können.
Die Unterfolder von dist/ sind jeweils Distributionen die geteilt werden können und eigenständig funktionieren.
Zum Ausführen des Programms, einfach die passende Distribution (basierend auf dem eigenen Betriebssysstem) auswählen und die folgende Datei ausführen.
Hinweis: Es wird jeweils immer der gesamte Ordner benötigt!
Verfügbare Distributionen:
Ausführung Windows:
- .zip Ordner entpacken
- Im
windows-terminservice\-Ordner diewindows-terminservice.exeausführen.
Für mehr Info zum Verteilen und Erstellen der Distributionen: Shipping
Um den Buildprozess zu vereinfachen gibt es verschiedene Buildpipelines, welche bei push Events in den Masterbranch ausgeführt werden.
Die pipelines sind im .github/workflows Ordner zu finden.
Aktuelle Pipelines:
Zum Erstellen der Distributionen wird pyinstaller verwendet.
Schritte zum Erstellen einer Distribution:
-
Erstelle eine .spec Datei für die main.py (einmalig)
⚠️ ACHTUNG⚠️ : Beim erstellen der .spec den python code fürcloudscrapernicht löschen! -
Erstelle die Distribution basierend auf der erstellten .spec Datei:
pyinstaller --clean specs/SPECNAME.spec
Nachdem mit pyinstaller die Distribution erstellt wurde, ist diese in im
dist/folder zu finden.
.spec Datei erstellen und anschließend Distribution erstellen:
cloudscraper nicht löschen!
pyi-makespec main.py --specpath "specs//" --add-binary "..\tools\chromedriver\chromedriver-windows.exe;tools\chromedriver\" --name windows-terminservice --hidden-import plyer.platforms.win.notification --hidden-import cloudscraper
pyinstaller --clean specs/windows-terminservice.specpyi-makespec main.py --specpath "specs//" --add-binary "../tools/chromedriver/chromedriver-linux-64:tools/chromedriver/" --name linux-64-terminservice --hidden-import cloudscraper
pyinstaller --clean specs/linux-64-terminservice.spec
Es gibt noch ein paar Features, die cool wären. Die Ideen werden hier mal gesammelt und werden (von uns oder euch - feel free!) irgendwann hinzukommen:
- Datum eingrenzen bei der Terminwahl
- Github Pages
- Macosx Build / Pipeline (Mac currently blocks the app: Branch)
- Code Zertifikate für Windows (gegen Virusmeldung)
- Artifacts, Packages und Releases
vaccipy dient lediglich als Unterstützung bei der Impftermin-Buchung EINER EINZELNEN PERSON,
weshalb folgende Automatisierungen und Erweiterungen NICHT kommen werden:
- Möglichkeit zum Eintragen mehrerer Impf-Codes und Kontaktdaten
- Headless Selenium Support
.. musst du dich nicht. Es freut uns sehr, wenn wir dir die Terminsuche etwas erleichtern konnten.
Für den Fall, dass du dein Dank gerne in Geld ausdrücken möchtest, haben wir hier eine Spendenaktion eingerichtet. ÄRZTE OHNE GRENZEN leistet weltweit medizinische Nothilfe in Krisen- und Kriegsgebieten und nach Naturkatastrophen.
Es wäre mega cool, wenn du dich daran beteiligst - ist aber vollkommen freiwillig, also no pressure 😉
save da world. my final message. goodbye.