rapla-proxy
is a web service that converts the HTML calendar shown by DHBW's class schedule page (rapla.dhbw.de) into the universally accepted iCalendar format on the fly.
Rapla does not natively offer a (reliable) method to integrate with internet calendar providers (think Outlook, Google Calendar, etc.), thus a 3rd party service like this is needed to bridge the gap.
I host a public instance of rapla-proxy
at rapla.satoqz.net
, powered by fly.io.
To get started synchronizing your schedule to a calendar provider of your choice, follow below steps:
-
Get your Rapla URL ready. This should be a very long URL with
rapla.dhbw.de
as its host, provided to you by DHBW. -
Replace the
dhbw.de
part of the URL withsatoqz.net
, such that it becomesrapla.satoqz.net
. -
Paste the resulting URL into the "New calendar subscription" field of your calendar provider. The name of this feature varies based on your provider.
If you would like to receive the list of events as JSON rather than in the iCalendar format, you can add the &json=true
query parameter to the Rapla URL.
The resulting JSON response contains an array "events"
, where each event is formatted as follows:
Field | Format | Optional |
---|---|---|
date |
YYYY-MM-DD |
No |
start |
HH:MM |
No |
end |
HH:MM |
No |
title |
String | No |
location |
String | Yes |
organizer |
String, comma-separated names | Yes |
description |
String, comma-separated resources | Yes |
A Dockerfile is included for easy deployment.
You can set the RAPLA_PROXY_ADDR
environment variable to configure the socket address that rapla-proxy
binds to.
The default is 127.0.0.1:8080
.