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

@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

@htilburgs i guess your modules are missing the minimal requirements for MagicMirror modules in the packages.json file.

I managed to lower the requirements…

@htilburgs the script looks if it is under an magicmirror/modules folder and takes this as root folder for modules.
otherwise it will take /opt/magic_mirror/modules

if your setup is different you need to adapt the script.

the script itself can be placed independently

@htilburgs now it should work for all installed modules

@htilburgs my main objection was to support the module development. so yes, at the moment it’s a per module check,