I would like to promote “my” MMM-WebUntis module. My version was forked from r3wald and originally created by thyed. Full credit goes to these developers for laying the groundwork - I would never be able to start this module myself!

Description

This module is ideal if your school is using WebUntis software to manage timetables. It retrieves data via the WebUntis API and displays irregular lessons, cancellations, and more—all configurable to your needs.

• Support for Multiple Students: Display timetable changes for multiple students simultaneously, making it perfect for families with school-aged children.
• Multiple Instances: Run several instances of the module to organize and display schedules independently.
• Upcoming Exams: Stay ahead by showing upcoming exams or assessments directly on your MagicMirror.

Screenshot

Download
MMM-WebUntis

@OliWer i pushed a fix to github.

I was able to reproduce your error.
it should work now.

start little ‘advertising’ … (this is what you get when you ask AI to promote your project…)

Stop juggling terminals and fighting file permissions. With MMM-DevContainer you can develop MagicMirror in VS Code using either Docker Compose or Dev Containers — your choice.

Why it’s better:

One workspace for everything: modules, config and css all in one place. No more multiple windows or scattered folders.
Works with Docker Compose and/or VS Code Dev Containers: pick the workflow that fits your setup.
No file-rights hassle: edit and save directly from VS Code without sudo/chmod pain (unlike editing inside a running MM Docker container - if you’ve ever tried that).
Reproducible, clean environment: consistent installs, easy onboarding, and less “it works on my machine.”
Great DX: built-in terminals, IntelliSense, debugging, and Git — all inside the container.
npm install runs automatically on first start, so you can get coding faster.
Get started: https://github.com/HeikoGr/MMM-DevContainer

Quick start

• Clone the repo:
  git clone --depth=1 https://github.com/HeikoGr/MMM-DevContainer.git
cd MMM-DevContainer
• Add your module:
  Create your module inside modules/YourModule (or add it as a Git submodule).
• Keep MagicMirror core, your modules, and config together in this single workspace.
• Choose your workflow from below:

Option A — Docker Compose
docker compose up --build
Open the app in your browser (e.g., http://localhost:8080)
Stop when done: docker compose down

Option B — VS Code Dev Container
Install VS Code + the “Dev Containers” extension.
Open the MMM-DevContainer folder in VS Code.
Reopen in Container when prompted (or use Command Palette: “Dev Containers: Reopen in Container”).

Notes:
At the moment it’s only testet on linux (or windows with ssh on linux…)
Dependencies: npm install runs automatically on first start (via the devcontainer/compose setup). If your module needs extra dependencies, you can still run npm install inside the container terminal.
All source folders are mounted into the container; edits happen from VS Code without permission issues.
Suggestions and feedback welcome!

Have ideas to improve the setup? Issues and PRs are very welcome.
Tell me what works well for you and what could be smoother.

@codac API 2.5 had different endpoints, but this version is deprecated. It could go offline at any time (since june 2024).

API 3.0 only supports the endpoint „onecall“

For more details you need to read the API docs yourself

@RobertMuc did you run npm install? i was able to reconstruct your error message by uninstalling the npm package.

I am obsessed with the modul checker on the MagicMirror² 3rd Party Modules list…

so, i asked github copilot to implement an instant modul checker script.

technically it clones the modul checker repo, and the local files to /tmp/mm-modul-checker… and installs the deps.

you can find it in recently most active repo:
https://github.com/HeikoGr/MMM-Webuntis/blob/master/scripts/magicmirror-check.mjs

run it: node scripts/magicmirror-check.mjs and you will get:

> mmm-webuntis@0.6.1 check:mm
> node scripts/magicmirror-check.mjs

🔍 Setting up MagicMirror checker...
Fetching checker repository (git-free) via `degit` (first time only)...
📦 Installing dependencies...
✓ Copying local files (excluding node_modules)...
✓ Checking MMM-Webuntis (including uncommitted changes)
🔎 Running full module checks...
🔍 Running ESLint check on package.json...

================================================================================
MMM-Webuntis - MagicMirror Module Check Results
================================================================================

📋 Issues found (1):
  1. Information: There are updates for 1 dependencie(s):
- prettier  ^3.8.0  →  ^3.8.1

================================================================================
📄 Results saved to: magicmirror-check-results.md
Compare with: https://modules.magicmirror.builders/result.html
================================================================================

💡 Tip: Use --cleanup to remove checker files after check

@codac MMM-WeatherChart did also update to API 3.0

did you update your subscription for openweathermap?
Unfortunately you need to add a credit card. 1000 calls per day are free.

On my system the weather modules are working (with my api key)

the MMM-SoccerLiveScore has another API problem. not related to the magic mirror release. See: https://github.com/0m4r/MMM-SoccerLiveScore/issues/13

Hello @RobertMuc,

did this error occur when you run npm check?
unfortunately i was not able to adopt the check.js file from https://github.com/r3wald/MMM-Webuntis

@htilburgs it‘s the original script. My script only tries to run this script locally on demand

@rabbit83ka I got it working, with a few modifications, so i can use the qr codes from my kids (our school uses MS365 Accounts for login, so unfortunately the username + password didn’t work…). You can find it here: https://github.com/heikogr/MMM-WebUntis wich is forked from https://github.com/r3wald/MMM-Webuntis wich is forked from https://github.com/thyed/MMM-Webuntis

i filed an issue: https://github.com/jens-maus/node-ical/issues/495

it could be an edge case on my side.
@inteeraymee by any chance: did you use emClient anytime in the past?

only workaround for my setup is to pin to v2.34.0 .
Updating the calendars might be the best solution for me…

@sdetweil @inteeraymee

I have the same issue after updating from MagicMirror 2.34.0 to 2.35.0.

In my case this is not a general calendar config problem and not an auth/fetch problem either. Some calendars still load fine, others fail right after the update, which pointed me to a parser regression.

What I found:

MagicMirror 2.34.0 used node-ical 0.22.1
MagicMirror 2.35.0 uses node-ical 0.25.6
The affected calendars are fetched successfully with HTTP 200
The failure happens during ICS parsing
These are the two of the log lines I get:

[ERROR] [calendar] https://<server>/remote.php/dav/calendars/xx1/?export - iCal parsing failed: Cannot parse: 1-01-15T12:00:00Z
[DEBUG] [calendar] Parsed iCal data from https://<server>/remote.php/dav/calendars/xx2/?export with 130 entries.

The important detail in the broken ICS files is this VTIMEZONE block:

BEGIN:VTIMEZONE
TZID:W. Europe Standard Time
BEGIN:DAYLIGHT
DTSTART:00010325T020000
TZOFFSETFROM:+0100
TZOFFSETTO:+0200
RRULE:FREQ=YEARLY;BYDAY=-1SU;BYMONTH=3
END:DAYLIGHT
BEGIN:STANDARD
DTSTART:00011028T030000
TZOFFSETFROM:+0200
TZOFFSETTO:+0100
RRULE:FREQ=YEARLY;BYDAY=-1SU;BYMONTH=10
END:STANDARD
END:VTIMEZONE

I tested the exact same ICS file with both node-ical versions:

node-ical 0.22.1: parses successfully
node-ical 0.25.6: fails with Cannot parse: 1-01-15T12:00:00Z
I also verified that if I remove only that W. Europe Standard Time VTIMEZONE block from the failing ICS, the file parses again with node-ical 0.25.6.

So the problem seems to be a regression in node-ical 0.25.x when resolving VTIMEZONE definitions with year 0001 in DTSTART. The calendar fetch itself succeeds; the crash happens while parsing timezone metadata.

This may especially affect calendars coming from Outlook/Exchange/Nextcloud imports, because W. Europe Standard Time looks like a Microsoft-style timezone definition.

@meralith Danke für die Rückmeldung. Ich habe node.js in der Version 20.18.1 jetzt mal als Bedingung in der Readme formuliert.

Falls du noch irgendwoe Probleme, Fragen oder Anregungen hast - einfach melden!

@meralith die Fehler:

0|mm | [2839:0309/111715.890708:ERROR:gbm_wrapper.cc(79)] Failed to get fd for plane.: Datei oder Verzeichnis nicht gefunden (2)
0|mm | [2839:0309/111715.891030:ERROR:gbm_wrapper.cc(262)] Failed to export buffer to dma_buf: Datei oder Verzeichnis nicht gefunden (2)

kommen sicher nicht vom MMM-Webuntis Modul sondern vom Chrome / Electon und sind vermutlich harmlos.

• Welches Version von Node.js läuft bei dir (node -v)?
• Hast du npm ci --omit=dev (oder npm install ausgeführt?)
• Hast du Sonderzeichen im Anmeldenamen?

Alternativ kannst du mal den qrcode login ausprobieren.

@magicghost our school doesn’t offer this untis feature for us, so i can’t implement and test it. youcan add this feature if you want/can do it

i recently messed up the github repository.

If your last update was ~2 weeks ago you should be fine.
Otherwise your update may fail.

You can get the most recent versions in this way:
There was no new feature in the last days. Only a more robust session management (hopefully) and internal changes.

cd ~/MagicMirror/modules/MMM-Webuntis

# Reset to match the remote repository
git fetch origin
git reset --hard origin/master
npm ci --omit=dev

I’m sorry for any inconvenience!

you can change the encoding in winscp to utf-8 then it should work again

@magicghost yes, just define two modules. or maybe there are some fancy css hacks possible? i choose the first option for my two kids.

@magicghost

this should work as minimum working example for your requirements.

    {
      module: "MMM-Webuntis",
      position: "top_right",
      config: {
        displayMode: 'grid',
        grid: {
          nextDays: 1, // today plus tomorrow = 2 days
          maxLessons: 0, // max lessons per day (0 = no limit)
        },
        students: [
          {
            title: "NAME",
            qrcode: "untis://setschool?...", //your qrcode
          },
        ],
      }
    },

@htilburgs it‘s the original script. My script only tries to run this script locally on demand