Skip to content

whosFritz/mensa-food-feed-ical

Repository files navigation

Mensa Food Feed iCal

This project provides an ICS feed for various Mensa locations, fetching meal data periodically and storing it in a MongoDB database. The data is served as ICS files via an Express.js API.

The meal data is provided by the MensaHub API, which is a free and open API for meal data for Leipzig's student cafeterias in Germany.

Supported Platforms

  • Calendar MacOS, iOS and IPad OS:
    • if u add the calendar to iCloud, it will be synced

Features

  • Fetches meal data for multiple Mensa locations.
  • Provides an ICS feed for each Mensa.
  • Dockerized for easy deployment.

Requirements

  • Docker
  • Docker Compose
  • Node.js
  • MongoDB

Installation

  1. Clone the repository:

    git clone https://github.com/whosFritz/mensa-food-feed-ical.git
    cd mensa-food-feed-ical
  2. Set up environment variables:

    Create a .env file in the root directory and add the following variables:

    NODE_PORT_INTERN=24ereqew
    NODE_PORT_EXTERN=13123313123
  3. Build and start the Docker containers:

    docker-compose up --build
  4. Contributing

  • Fork the repository
  • Create a feature branch (git checkout -b feature-branch)
  • Commit your changes (git commit -am 'Add new feature')
  • Push to the branch (git push origin feature-branch)
  • Create a new Pull Request