MMM-Untis

WORK IN PROGRESS - CURRENTLY NO WORKING VERSION

Goal of MMM-Untis is to provide a timetable for several school kids. Maybe it will end up in a complete rewrite. These are the very first steps. The code is based on thyed/MMM-Webuntis - thank you very much!!!

outdated documentation

This an extension for the MagicMirror. It allows to display your kids' cancelled and irregular lessons for schools using Untis software to organize school's timetables. You are able to configure acccess for each of your kids.

Installation

1. Navigate into your MagicMirror's modules folder and execute git clone https://github.com/thyed/MMM-Webuntis.git.
2. Navigate into the new folder MMM-Webuntis and execute npm install to generate the node dependencies.

Using the module

To use this module, add it to the modules array in the config/config.js file:

modules: [
	{
		module: "MMM-Webuntis",
		position: "top_right",
		header: "Untis",
		config: { // see 'Configuration options' for more information
			students: [
				{
					title: "1st child's name",
					school: "your school",
					username: "your untis username",
					password: "your untis password",
					server: "untis server"
				},
				{
					title: "2nd child's name",
					school: "your school",
					username: "your untis username",
					password: "your untis password",
					server: "untis server"
				},
			],
			days: 1, // number of days to look ahead
			fetchInterval: 5*60*1000, // update intervall in milliseconds
			showStartTime: false, // whether to show lesson number ('1.') or time ('07:40')
			showRegularLessons: false // whether to show also regular lessons or not
		}
	}

Configuration options

The following properties can be configured:

Option	Description
students	Array of untis login credentials objects Possible values: array of objects with the following attributes: title Title of the entry, e.g. kid's name school School name as in the URL after having logged in at webuntis.com. A plus sign (+) in the URL can be replaced by space. username Username used to login at Untis password Password used to login at Untis server Server as shown in the URL after having loged in at webuntis.com, e.g. kephiso.webuntis.com
days	Number of days to look ahead Possible values: int from 1 to 10 Default value: 7
fetchInterval	Defines how often the module shall retrieve data from Untis Possible values: int in milliseconds Default value: 5*60*1000
showStartTime	Whether time or lesson order number shall be shown Possible values: true or false Default value: false The module tries to achieve the timetable of the school and currently assumes that Monday's lesson times are valid for the whole week. When set to false the module matches a start time like "07:40" to "1." for example.
showRegularLessons	Whether to show also regular lessons or not Possible values: true or false Default value: false

How it works

This module may be useful for students at schools using Untis for the organization of time tables. It uses the node.js wrapper of the WebUnits API by TheNoim and retrieves all lessons in a specified number of days time period. It displays cancelled or irregular subjects so that kids are able to prepare for the next day without pulling the information from the Untis app. The module can be configured for several students.

Dependencies

• node.js Wrapper for WebUntis API (installed via npm install)

Screenshots

Attribution

This project is based on work done by Paul-Vincent Roll in the MMM-Wunderlist module. (https://github.com/paviro/MMM-Wunderlist)