MMM-Webuntis

[HeikoGr]

@Eli the module surely isn‘t running properly.

I think the module MMM-Remote-Control tries to run git to get the npm module untis (which is required by my module) and has no success.

But this is only a guess… could be totally wrong

[OliWer]

Hey,

first let me say thanks for this module and your work!
I have a similar issue as Eli:
I only get info “all according to plan”. Even if I use “showRegularLessons”: true, I’m not getting anything else.
in the startuplog I get this error for MMM-Webuntis:
1|MagicMirror | [2025-01-22 09:02:11.901] [LOG] [MMM-Webuntis] ERROR for : TypeError: Cannot read properties of undefined (reading ‘0’)

My config is as follow (removed real data from URL:

{
                        module:"MMM-Webuntis",
                        position:"bottom_left",
                        header:"Emma Schule",
                        config: {
                                students: [
                                                {
                                                title:"",
                                                qrcode:"untis://setschool?url=ikarus.webuntis.com&school=12345&user=MyChild&key=Realkey&schoolNumber=123456789",
                                                days:"10",
                                                },
                                          ],
                                showRegularLessons: true
                                }
                },

Any help is much appreciated, cause I find the idea really good!

[HeikoGr]

Note to myself: enhance error handling

I did a clean reinstall on my machine and it worked with your config (and our qr code).

Maybe the school doesn’t publish personal timetables?

Can you try to set useClassTimetable: true,

[OliWer]

@HeikoGr
added that to my config, but nothing changed.
When I login to WebUntis via Browser, I can see a “My Timetable” (Mein Stundenplan). Not sure if there is a language difference or something.
When I change the login information, I get error messages in the log, so the login itself seems to work and it gets data, even if it is just “all according to plan”. But not the data.

What I also noticed is that there are two “My Timetable” in the web overview - one marked with beta.
URL for non-beta: https://ikarus.webuntis.com/timetable-students-my/
URL for beta: https://ikarus.webuntis.com/timetable-new/my-student

URL for class: https://ikarus.webuntis.com/timetable-classes/

So I think the school allowed the timetables you are asking for.

Thanks for taking your time! Let me know if I can provide further information.

[kurkarte]

Hello,
I am experiencing an issue with your MMM-WebUntis module. Despite following the setup instructions and providing the correct credentials, I am unable to log in. After testing, I believe the issue may be related to the presence of an umlaut (e.g., ö) and/or a whitespace in the school name.

My Setup:
MagicMirror Version: v2.29.0
MMM-WebUntis Module Version: Latest from repository
School Name: Contains an umlaut (ö) and a space
Login Method: My school uses iserv (iserv.de) for authentication. I do not have direct login credentials for the WebUntis portal but instead rely on the QR code provided by the school, which works in the official WebUntis app.

Configuration:

Here is an example of my configuration (with pseudodata replacing sensitive values):

{
  module: "MMM-Webuntis",
  position: "top_right",
  header: "WebUntis Schedule",
  config: {
    students: [
      {
        title: "Student1",
        qrcode: "untis://setschool?url=kadmos.webuntis.com&school=schulname with ö and space&user=username&key=ABC12345&schoolNumber=1234567",
        useClassTimetable: true
      }
    ],
    days: 10,
    mode: "verbose"
  }
}

Error Messages:

Here are the errors I encountered:

When using the QR code:

[LOG]   ERROR for Student1: Error: Request failed with status code 400

Debugging with the check.js script

Error: getaddrinfo ENOTFOUND undefined

When manually entering the school name, username, and password instead of using qrcode:

Error: Failed to login. {"jsonrpc":"2.0","id":"Awesome","error":{"message":"bad credentials","code":-8504}}

Observations:

The QR code provided by webuntis contains the following (copied directly from the QR code content):
You see, the miscoding of the ö.

untis://setschool?url=example.webuntis.com&school=school name with � and space&user=username&key=ABC12345&schoolNumber=1234567

Notably:
The umlaut (ö) in the school name seems to cause issues.
There is also a whitespace in the school name.

Even when encoding the URL (e.g., using %C3%B6 for ö and %20 for the whitespace), I still encounter errors. I tried various configurations, including:

"school%20name%20with%20%C3%B6%20and%20space"
"schoolname with ö and space"
"schoolname+with+oe+and+space"
 ...

The QR code works perfectly in the WebUntis app, so I believe the credentials and format are correct. But my school uses iserv for authentication, meaning I do not have a standard WebUntis username and password.

[HeikoGr]

@kurkarte you can try to search your school at https://webuntis.com/ . On the next site the school name in the URL could work if you replace empty spa es with „+“ signs.

[HeikoGr]

@OliWer i pushed a fix to github.

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

[OliWer]

Data is getting displayed now, will play around with it more later. Thank you very much!

[Eli]

@HeikoGr
Hi, I am running on an RPI normally. The test system is running on Windows, yes. But both show the same issue.
I install modules the standard way, fro a git console by pulling and npm install.

I also tried without remote control module - same issue.

[Eli]

@HeikoGr Smashing, Heiko! Works perfect now! Many thanks!