openLitfass

Build your own events calendar

openLitfass is a digital advertising pillar you put together for yourself. Pick the sources you care about – venues, clubs, feeds, your own events – and it collects them in one calendar: lightweight, fast, without accounts and without tracking. Keep it for yourself or share it publicly.

The weissens.ee instance showing a weekend in two columns: event cards with time, category, title and venue, one of them marked as cancelled.

Features

Everything that's on, in one list

Organisers keep publishing where they always have. openLitfass picks their events up automatically and turns them into a calendar you actually want to use.

Many kinds of source

RSS, iCalendar, JSON APIs, WordPress calendar plugins and plain web pages without a feed – configured in JSON, no custom code.

Duplicates merged

The same event announced by several sources appears once. Cancelled events stay visible, clearly marked.

Filters that make sense

Day, weekend or week; categories and groups such as culture; attributes like free, family-friendly or ticket required.

Search with suggestions

Finds venues, categories and events across all dates, tolerant of accents and ß/ss.

Places and maps

A directory of venues with their upcoming events, map links to OpenStreetMap and calendar export as .ics.

Saved events

Star events straight from the list. Kept in the browser only – no sign-up, no account.

Installable web app

Works on phones, tablets and wide screens; installable as a PWA and usable offline with the last loaded events.

Easy to find

Optional static event pages with schema.org data, a sitemap and today's events already in the HTML.

How it works

From scattered announcements to one calendar

No database, no API server. A small Go program fetches, cleans and builds; what comes out is a set of static files any web server can serve.

Collect

fetch reads every configured source on a schedule (every six hours by default) and maps its fields to a common event format.

RSSiCalJSONHTMLWordPressInbox

Clean up

Filters drop what doesn't belong, duplicates are merged and categories assigned. A failing source never wipes out the rest – the last good data is kept.

Publish

build-site writes the web app, event data and optional SEO pages. serve switches a new build live only once it is complete.

Event days

Talks, workshops, many slots

Not only for ongoing events: openLitfass also works for your own event days – a hackerspace's open day, a club congress, a barcamp, a festival or any occasion where talks are given.

  • Bring the schedule as it isImport an iCalendar export from your planning tool, or add single talks by hand through the inbox.
  • Rooms and tracksRooms become places, tracks become categories – filterable, searchable, each with its own icon.
  • Several days side by sideWeekend and week views show the days in columns; talks in progress are highlighted.
  • A personal timetableVisitors star the talks they want to see and add them to their own calendar.

Made for visitors

Respectful by design

  • No tracking, no cookies, no accountsPreferences and saved events live in the visitor's own browser.
  • Light and dark modeFollows the system setting or the visitor's choice.
  • Today at a glanceEvents in progress are highlighted, finished ones fade out.
  • Your lookEach instance brings its own colours, logo and texts through a small theme file.
weissens.ee in dark mode: a single day with event cards for a children's farm, a picture-book cinema, toddler groups and an exhibition.

Run your own

Your own calendar in five steps

The core lives in one repository; each calendar is an instance in a repository of its own that holds only configuration, sources and styling.

  1. Copy example-instance/ into a new, empty repository.
  2. Fill in instance.json and adapt the legal notice and privacy policy.
  3. Add sources: copy a template in sources/ and adjust URL and field mapping.
  4. Style it: override the design tokens in site/css/theme.css, add your logo.
  5. Start the container – it serves the site and keeps it up to date.
# one instance per container: serves on :8080, fetches every 6 hours
docker run -d --restart unless-stopped \
  -v ./my-instance:/instance -p 8080:8080 \
  ghcr.io/schreibtischhelden/openlitfass

Images for amd64 and arm64. A health endpoint and Prometheus metrics are built in; GitHub Actions and GitHub Pages work too.

The user interface is currently available in German only.

In use

Instances

weissens.ee

Berlin-Weißensee: libraries, cinemas, galleries, a children's farm, sports clubs and more.

Get involved

openLitfass is free software. Report a bug, suggest an idea or a source type, or start a calendar of your own.