MMM-MensaBER

A module for MagicMirror² to display the daily menu of Berlin universities (and other canteens supported by OpenMensa).

This module is a fork/adaptation of MMM-Mensamuc by wiesty, rewritten to use the OpenMensa API, specifically targeting Berlin canteens (Studierendenwerk Berlin).

Dependencies

• An installation of MagicMirror²

Installation

1. Clone this repository into your ~/MagicMirror/modules directory:

   cd ~/MagicMirror/modules
   git clone https://github.com/Thxlx/MMM-MensaBER.git

2. Install dependencies (if any are added in the future, currently none extra required beyond standard MM setup):

   cd MMM-MensaBER
   npm install

Configuration

Add the module to the modules array in the config/config.js file:

{
  module: "MMM-MensaBER",
  position: "top_right",
  config: {
    canteenId: 2019, // ID of your canteen (see below)
    dishTypeFilter: ["Suppen", "Aktionen", "Essen"], // Categories to show
    excludedDishes: ["Hartkäse", "1/2 Sahniger Milchreis"] // Dishes to hide by name (partial match)
  }
}

Configuration Options

Option	Type	Default	Description
canteenId	Integer	2019	The OpenMensa ID of the canteen. Default is TU Berlin Hardenbergstraße.
dishTypeFilter	Array or String	["Suppen", "Aktionen", "Essen"]	List of categories to display. Use "ALL" to show everything.
excludedDishes	Array	["Hartkäse", "1/2 Sahniger Milchreis"]	List of dish names (or parts of names) to exclude from the list. Case-insensitive.

Supported Canteens

You can find the ID of your canteen on OpenMensa.org. Here are some common Berlin canteens:

Name	ID
Mensa TU Hardenbergstraße	2019
Mensa HU Süd	2025
Mensa HU Nord	2023
Mensa FU II	2031
Mensa Charité Zahnklinik	2022
Mensa HfM Charlottenstraße	2026

Features

• Dietary Indicators: Uses emojis to indicate diet types based on API notes:
  • 🥦 Vegan
  • 🥕 Vegetarian
  • 🍖 Meat (if explicitly mentioned)
• Filtering: Filter by category (e.g., only main dishes) and exclude specific unwanted items.

Credits

• Original module MMM-Mensamuc created by wiesty.
• Adapted for OpenMensa/Berlin by Thilo Schaeffer.
• Data provided by OpenMensa.

License

This project is licensed under the MIT License - see the LICENSE file for details.