Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/mrd0ll4r/darmstadt-city-service-bot

A Telegram Bot to Notify You of Available Appointments at the Darmstadt Einwohnermeldeamt
https://github.com/mrd0ll4r/darmstadt-city-service-bot

Last synced: 21 days ago
JSON representation

A Telegram Bot to Notify You of Available Appointments at the Darmstadt Einwohnermeldeamt

Awesome Lists containing this project

README

        

# Darmstadt City Service Appointments Bot

An **unofficial(!)** Telegram bot to notify you when there are appointments for a service at the Meldebehörde.
I'm not responsible or liable for you and your appointments.

The bot will try to find appointments every five minutes.

## Running

Either run this directly via `poetry install` and `poetry run python main.py` or, preferably, within Docker.

## Configuration

Configured via environment variables, optionally loaded from a `.env` file:
```
TELEGRAM_BOT_TOKEN=""
TELEGRAM_CHAT_ID=""
SERVICE_ID="" # e.g., cnc-2008 is for Anmeldung, cnc-1940 is to change your KfZ-Schein
LOCATION_ID= # e.g., 44 is for Luisencenter
USER_AGENT="Mozilla/5.0 (X11; Ubuntu; Linux x86_64; rv:108.0) Gecko/20100101 Firefox/108.0; [email protected]" # Add your email to this to be nice
LOG_LEVEL="INFO" # Or some other level.
```

Fill out the Telegram details and add your email address to the user agent, to be nice.
You can figure out the IDs of services and locations from the website.
This bot currently only supports appointments at the Meldebehörde (https://tevis.ekom21.de/stdar/select2?md=4).

### CNC and Location Values

Valid as of: **2024-06-25**

Services:
- Anmeldung (Einzelperson): `cnc-2099`
- Anmeldung (Familie): `cnc-2097`
- Ummeldung (Einzelperson): `cnc-2101`
- Ummeldung (Familie): `cnc-2123`
- Änderung KFZ-Schein bei Ummeldung: `cnc-2122`
- Antrag Personalausweis: `cnc-2111`

Locations:
- Luisencenter: `46`

## License

MIT, see [LICENSE](LICENSE).