49 lines
2.1 KiB
Markdown
49 lines
2.1 KiB
Markdown
# Ausweisstatus
|
|
|
|
A small application to check the status of IDs like _Personalausweis_ and _Reisepass_ on https://ausweisstatus.regioit.de/aachen automatically and send notifications on changes.
|
|
|
|
Tested with the status page for Aachen but _should_ work for other cities using _regioit.de_
|
|
|
|
## Why?
|
|
I wanted to know when my _Personalausweis_ was ready for collection without manually checking the page periodically.
|
|
|
|
## Usage
|
|
|
|
### With Docker
|
|
A `Dockerfile` is provided containing everything necessary to send Discord notifications on status changes.
|
|
|
|
Before building the Docker image, adjust the `WEBHOOK_URL` (see [here](https://support.discord.com/hc/en-us/articles/228383668-Intro-to-Webhooks) for creation instructions), _Passauswahl_ (_P_, _R_, or _ID_, see below), _Seriennummer_ and _Geburtsdatum_ in the `crontab` file.
|
|
|
|
Then, build and start the container with `docker compose up -d --build` on a machine with high availability.
|
|
You will now be notified when the status of your document is changed.
|
|
|
|
### Without Docker
|
|
First, install the dependencies, I recommend using [`uv`](https://docs.astral.sh/uv/):
|
|
```bash
|
|
uv venv
|
|
source .venv/bin/activate
|
|
uv pip install -r requirements.txt
|
|
```
|
|
The provided script `ausweisstatus.py` can be used to retrieve the current status of your document.
|
|
|
|
```
|
|
./ausweisstatus.py <P|R|ID> <Seriennummer> <Geburtsdatum>
|
|
```
|
|
|
|
- _P_ for _Personalausweis_
|
|
- _R_ for _Reisepass_
|
|
- _ID_ for eID-Karte
|
|
|
|
Example:
|
|
```bash
|
|
$ ./ausweisstatus.py P L712345678 01.01.1970
|
|
bei Bundesdruckerei erfasst
|
|
```
|
|
|
|
To automatically receive notifications on status changes, you can periodically run the `notify.sh` script (requires _curl_) with the same arguments and a `WEBHOOK_URL` env var containing a Discord webhook URL.
|
|
You can modify the `notify()` function in it to use other notification services.
|
|
|
|
To run the script periodically, you can use [_systemd/Timers_](https://wiki.archlinux.org/title/Systemd/Timers) or [_cron_](https://wiki.archlinux.org/title/Cron).
|
|
|
|
## Note for other Cities
|
|
The URL https://ausweisstatus.regioit.de/aachen is hard-coded in `ausweisstatus.py`, make sure to change it. |