📆 rapla-proxy

• Introduction
• Usage as Calendar Synchronizer
• Usage as JSON API
• Self-Hosting
• Configuration

Introduction

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.

Usage as Calendar Synchronizer

To get started synchronizing your schedule to a calendar provider of your choice, follow below steps:

1. Get your Rapla URL ready. This should be a very long URL with rapla.dhbw.de as its host, provided to you by DHBW.

2. Replace the dhbw.de part of the URL with satoqz.net, such that it becomes rapla.satoqz.net.

3. Paste the resulting URL into the "New calendar subscription" field of your calendar provider. The name of this feature varies based on your provider.

Usage as JSON API

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

Self-Hosting

A Dockerfile is included for easy deployment.

Configuration

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.