MMM-Mensa

A MagicMirror² module to display daily menu information from Munich university canteens (Studierendenwerk München Oberbayern).

Note: This module is an improved fork of MMM-Mensamuc by wiesty. Many thanks to the original creator for the foundation!

Data provided by eat-api by TUM-DEV

Features

• Daily menu display from Munich university canteens
• Diet indicators with intuitive emojis:
  • 🍖 Meat dishes
  • 🥕 Vegetarian dishes
  • 🌱 Vegan dishes
• Dish type filtering - show only specific menu categories
• Dessert section - automatically grouped separately
• Clean, minimal UI - matches MagicMirror aesthetic
• Auto-refresh - updates hourly

Requirements

• An instance of MagicMirror²

Installation

1. Navigate to your MagicMirror modules directory:

cd ~/MagicMirror/modules

2. Clone this repository:

git clone https://github.com/daniensi/MMM-Mensa.git

3. Add the configuration to your config.js (see below)

Configuration

Add the module to your config.js:

{
    module: "MMM-Mensa",
    position: "bottom_right",
    config: {
        canteen: "mensa-garching",                          // Your canteen
        dishTypeFilter: ["Tagesgericht", "Aktionsessen"]    // Filter dish types
    }
}

Configuration Options

Option	Type	Default	Description
canteen	String	"mensa-garching"	Required. The canteen API key (see table below)
dishTypeFilter	Array	["ALL"]	Filter by dish type. Use ["ALL"] to show everything

Common Dish Type Filters

Filter	Description
"ALL"	Show all dishes
"Tagesgericht"	Daily specials (numbered 1-4)
"Aktionsessen"	Special/promotional dishes
"Beilagen"	Side dishes
"Dessert"	Desserts (automatically grouped)

Supported Canteens

Name	API Key	Address
Mensa Arcisstraße	mensa-arcisstr	Arcisstraße 17, München
Mensa Garching	mensa-garching	Boltzmannstraße 19, Garching
Mensa Leopoldstraße	mensa-leopoldstr	Leopoldstraße 13a, München
Mensa Lothstraße	mensa-lothstr	Lothstraße 13d, München
Mensa Martinsried	mensa-martinsried	Großhaderner Straße 6, Planegg-Martinsried
Mensa Pasing	mensa-pasing	Am Stadtpark 20, München
Mensa Weihenstephan	mensa-weihenstephan	Maximus-von-Imhof-Forum 5, Freising
StuBistro Arcisstraße	stubistro-arcisstr	Arcisstraße 12, München
StuBistro Goethestraße	stubistro-goethestr	Goethestraße 70, München
StuBistro Großhadern	stubistro-großhadern	Butenandtstraße 13, München
StuBistro Rosenheim	stubistro-rosenheim	Hochschulstraße 1, Rosenheim
StuBistro Schellingstraße	stubistro-schellingstr	Schellingstraße 3, München
StuBistro Martinsried	stubistro-martinsried	Großhadernerstr. 9a, Planegg-Martinsried
StuCafé Adalbertstraße	stucafe-adalbertstr	Adalbertstraße 5, München
StuCafé Akademie Weihenstephan	stucafe-akademie-weihenstephan	Alte Akademie 1, Freising
StuCafé Weihenstephan-Maximus	stucafe-weihenstephan-maximus	Maximus-von-Imhof-Forum 5, Freising
StuCafé Boltzmannstraße	stucafe-boltzmannstr	Boltzmannstraße 15, Garching
StuCafé in der Mensa Garching	stucafe-garching	Boltzmannstraße 19, Garching
StuCafé Karlstraße	stucafe-karlstr	Karlstraße 6, München
StuCafé Pasing	stucafe-pasing	Am Stadtpark 20, München
FMI Bistro Garching	fmi-bistro	Boltzmannstraße 3, Garching
IPP Bistro Garching	ipp-bistro	Boltzmannstraße 2, Garching

Project Structure

MMM-Mensa/
├── MMM-Mensa.js        # Main module logic
├── MMM-Mensa.css       # Styling
├── LICENSE             # MIT License
└── README.md           # This file

How It Works

1. Data Fetching - Retrieves weekly menu from the TUM eat-api
2. Day Filtering - Shows only today's menu items
3. Type Filtering - Applies dish type filters from configuration
4. Diet Detection - Identifies meat/vegetarian/vegan based on labels
5. Section Grouping - Automatically separates desserts into their own section
6. Auto-Refresh - Updates every hour to catch menu changes

Improvements Over Original

This fork adds several enhancements over the original MMM-Mensamuc:

• Cleaner UI - Refined styling matching the MMM-MVG aesthetic
• Dessert grouping - Desserts automatically shown in a separate section
• Better emoji indicators - 🌱 for vegan (instead of 🥦)
• Compact layout - Optimized spacing and typography
• Improved filtering - Better handling of Aktionsessen variants

Menu Availability Note

If you see "No menu available yet", this is normal behavior. The menus are typically refreshed at the beginning of each week. The module will automatically update when new menus are published.

License

MIT License - See LICENSE for details.

---

Original module by wiesty • Data by TUM-DEV • Enhanced by dani for the MagicMirror community