https://github.com/scriptraccoon/berlin-termin-buchung
Regularly checks if appointments are available in Berlin for getting a new ID card
https://github.com/scriptraccoon/berlin-termin-buchung
Last synced: 9 days ago
JSON representation
Regularly checks if appointments are available in Berlin for getting a new ID card
- Host: GitHub
- URL: https://github.com/scriptraccoon/berlin-termin-buchung
- Owner: ScriptRaccoon
- License: mit
- Created: 2024-06-05T10:35:59.000Z (about 2 years ago)
- Default Branch: main
- Last Pushed: 2024-06-17T18:33:46.000Z (almost 2 years ago)
- Last Synced: 2025-03-03T03:16:57.823Z (over 1 year ago)
- Language: JavaScript
- Homepage:
- Size: 28.3 KB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Berlin Termin Buchung
It is not so easy to get an appointment in Berlin to request a new ID card, for example. The [website](https://service.berlin.de/terminvereinbarung/termin/all/120703) often does not display any appointments at all, and if so they are gone quite fast.
This script checks if any appointment is available. If yes, it sends an email to you to check the website. A GitHub action runs the script every 10 minutes.
Notice that you are not allowed (and it is not possible) to book an appointment programmatically. This script here just lets you know when you have the chance to book an appointment manually. It does so by opening and analysing the website in a headless browser.
## How to use
1. Clone the repository.
2. If you are looking for a different service than getting an ID card, change the `BOOKING_URL` in `main.js` accordingly.
3. Install [pnpm](https://pnpm.io/installation) if you haven't done already.
4. Install the dependencies with `pnpm install`.
5. Create the `.env` file and add the secrets (see below) in it.
6. Add the same secrets to the GitHub repository under `https://{YOUR_REPOSITORY}/settings/secrets/actions`.
7. Uncomment the schedule in the workflow file `main.yaml`. When you got an appointment, comment the schedule.
## Secrets
- `EMAIL_USER` = the sender email address
- `EMAIL_PASS` = the corresponding password\*
- `EMAIL_SERVICE` = your email provider (for example, gmail)
- `RECIPIENT_EMAIL` = the recipient email address
- `DATE_BEFORE` = the date before which you want to get an appointment\*\*
\*This needs to be an [app password](https://support.google.com/mail/answer/185833) if you have two-factor authentication enabled.
\*\*This is optional. This date is useful to filter out some emails about appointments which are too late for you anyway.