Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/rbignon/doctoshotgun
Script to automatically book a vaccine slot on Doctolib in the next seven days.
https://github.com/rbignon/doctoshotgun
covid-19 dose-slot-booking vaccination vaccine vaccine-availability
Last synced: 3 months ago
JSON representation
Script to automatically book a vaccine slot on Doctolib in the next seven days.
- Host: GitHub
- URL: https://github.com/rbignon/doctoshotgun
- Owner: rbignon
- License: gpl-3.0
- Created: 2021-05-16T18:36:55.000Z (over 3 years ago)
- Default Branch: master
- Last Pushed: 2021-12-19T22:25:56.000Z (almost 3 years ago)
- Last Synced: 2024-04-27T08:36:23.598Z (7 months ago)
- Topics: covid-19, dose-slot-booking, vaccination, vaccine, vaccine-availability
- Language: Python
- Homepage:
- Size: 172 KB
- Stars: 550
- Watchers: 11
- Forks: 144
- Open Issues: 25
-
Metadata Files:
- Readme: README.md
- License: COPYING
Awesome Lists containing this project
README
# DOCTOSHOTGUN
This script lets you automatically book a vaccine slot on Doctolib in France and in Germany in
the next seven days.
## Python dependencies
- [woob](https://woob.tech)
- cloudscraper
- dateutil
- termcolor
- colorama
- playsound (optional)
## How to use it
You need python3 for this script. If you don't have it, please [install it first](https://www.python.org/).
Install dependencies:
```
pip install -r requirements.txt
```
Run:
```
./doctoshotgun.py []
```
Further optional arguments:
```
--debug, -d show debug information
--pfizer, -z select only Pfizer vaccine
--moderna, -m select only Moderna vaccine
--janssen, -j select only Janssen vaccine
--astrazeneca, -a select only AstraZeneca vaccine
--only-second, -2 select only second dose
--only-third, -3 select only third dose
--patient PATIENT, -p PATIENT
give patient ID
--time-window TIME_WINDOW, -t TIME_WINDOW
set how many next days the script look for slots (default = 7)
--center CENTER, -c CENTER
filter centers
--zipcode CODE
filter centers by zipcode
--center-regex CENTER_REGEX
filter centers by regex
--center-exclude CENTER_EXCLUDE, -x CENTER_EXCLUDE
exclude centers
--center-exclude-regex CENTER_EXCLUDE_REGEX
exclude centers by regex
--include-neighbor-city, -n
include neighboring cities
--start-date START_DATE
first date on which you want to book the first slot (format should be DD/MM/YYYY)
--end-date END_DATE last date on which you want to book the first slot (format should be DD/MM/YYYY)
--weekdays-exclude, -e
exclude weekdays, e.g. "tuesday Wednesday FRIDAY"
--dry-run do not really book the slot
--code CODE 2FA code
--confirm prompt to confirm before booking
```
### With Docker
Build the image:
```
docker build . -t doctoshotgun
```
Run the container:
```
docker run -it doctoshotgun []
```
### Multiple cities
You can also look for slot in multiple cities at the same time. Cities must be separated by commas:
```
$ ./doctoshotgun.py ,, []
```
### Filter on centers
You can give name of centers in which you want specifically looking for:
```
$ ./doctoshotgun.py fr paris [email protected] \
--center "Centre de Vaccination Covid 19 - Ville de Paris" \
--center "Centre de Vaccination du 7eme arrondissement de Paris - Gymnase Camou"
```
### Select patient
For doctolib accounts with more thant one patient, you can select patient just after launching the script:
```
$ ./doctoshotgun.py fr paris [email protected] PASSWORD
Available patients are:
* [0] Roger Philibert
* [1] Luce Philibert
For which patient do you want to book a slot?
```
You can also give the patient id as argument:
```
$ ./doctoshotgun.py fr paris [email protected] PASSWORD -p 1
Starting to look for vaccine slots for Luce Philibert in 1 next day(s) starting today...
```
### Set time window
By default, the script looks for slots between now and next day at 23:59:59. If you belong to a category of patients that is allowed to book a slot in a more distant future, you can expand the time window. For exemple, if you want to search in the next 5 days :
```
$ ./doctoshotgun.py fr paris [email protected] -t 5
Password:
Starting to look for vaccine slots for Roger Philibert in 5 next day(s) starting today...
This may take a few minutes/hours, be patient!
```
### Look on specific date
By default, the script looks for slots between now and next day at 23:59:59. If you can't be vaccinated right now (e.g covid in the last 3 months or out of town) and you are looking for an appointment in a distant future, you can pass a starting date:
```
$ ./doctoshotgun.py fr paris [email protected] --start-date 17/06/2021
Password:
Starting to look for vaccine slots for Roger Philibert in 7 next day(s) starting 17/06/2021...
This may take a few minutes/hours, be patient!
```
### Filter by vaccine
The Pfizer vaccine is the only vaccine allowed in France for people between 16 and 18. For this case, you can use the -z option.
```
$ ./doctoshotgun.py fr paris [email protected] PASSWORD -z
Starting to look for vaccine slots for Luce Philibert...
Vaccines: Pfizer
This may take a few minutes/hours, be patient!
```
It is also possible to filter on Moderna vaccine with the -m option and Janssen with the -j option.
## Development
### Running tests
```
$ pip install -r requirements-dev.txt
$ pytest test_browser.py
```