Schulcloud-Mailchecker
Version 1.0

© Torsten Montag, Dipl. Betriebswirt, Regelschullehrer
https://www.torstenmontag.de


BESCHREIBUNG

Der Schulcloud-Mailchecker ist ein kostenloses Hilfstool für Windows.

Das Programm prüft automatisch, ob neue ungelesene Schulcloud-Mails vorhanden sind.
Wenn neue Mails gefunden werden, wird eine Telegram-Benachrichtigung mit Absender und Betreff gesendet.

Das Programm ist ein inoffizielles Hilfstool.
Es ist kein offizielles Produkt der Schulcloud, des Schulportals, eines Ministeriums oder eines Schulträgers.

Das Programm darf kostenlos genutzt, kopiert und weitergegeben werden.
Es gibt kein Abo, keine versteckten Kosten und keine kommerzielle Verpflichtung.


WICHTIGER DATENSCHUTZ-HINWEIS

Die Schulcloud-Zugangsdaten werden ausschließlich lokal auf dem eigenen Windows-PC gespeichert.

Die Zugangsdaten werden in der Datei config.json im Programmordner gespeichert.

Das Programm enthält keine Funktion, die Schulcloud-Zugangsdaten an Torsten Montag, eine zentrale Datenbank oder einen fremden Server überträgt.

Die Zugangsdaten werden nur verwendet, um sich automatisch über die normale Schulcloud-Weboberfläche anzumelden und nach ungelesenen Mails zu suchen.

Wichtig:
Für den Login werden die Zugangsdaten technisch an die Schulcloud-Anmeldeseite übermittelt – genau wie bei einer normalen manuellen Anmeldung im Browser.

Der Quellcode liegt offen im Programmordner und kann von technisch interessierten Nutzern eingesehen werden.


HINWEIS ZU TELEGRAM

Telegram wird nur für die Benachrichtigung verwendet.

Es werden keine vollständigen Mailinhalte per Telegram versendet.

Die Telegram-Benachrichtigung enthält nur:

- Anzahl neuer ungelesener Mails
- Absender
- Betreff

Antworten auf Schulmails erfolgen weiterhin im offiziellen Schulcloud-Postfach.


INSTALLATION

1. ZIP-Datei entpacken

Die ZIP-Datei muss zuerst vollständig entpackt werden.

Wichtig:
Das Programm sollte nicht direkt aus der ZIP-Datei gestartet werden.

Der entpackte Ordner kann zum Beispiel auf dem Desktop, im Dokumente-Ordner oder auf einem USB-Stick liegen.


2. Installation starten

Im entpackten Ordner wird folgende Datei per Doppelklick gestartet:

install.bat

Dadurch werden die benötigten Python-Pakete und der Playwright-Browser installiert.


3. Einrichtung starten

Nach erfolgreicher Installation wird folgende Datei per Doppelklick gestartet:

start_setup.bat

Danach öffnet sich der Einrichtungsassistent.


EINRICHTUNG

1. Schulcloud-Zugangsdaten eintragen

Im Einrichtungsassistenten werden eingetragen:

- Schulcloud-Benutzername
- Schulcloud-Passwort

Die Daten werden lokal in der Datei config.json gespeichert.


2. Telegram einrichten

Für die Benachrichtigung wird Telegram benötigt.

Kurzanleitung:

1. Telegram auf dem Smartphone oder PC installieren und öffnen
2. In Telegram nach @BotFather suchen
3. /newbot schreiben
4. Den Anweisungen folgen
5. Den erhaltenen Bot Token in den Einrichtungsassistenten eintragen
6. Den eigenen Bot in Telegram öffnen
7. Auf START klicken oder /start schreiben
8. Dem Bot eine kurze Nachricht schreiben, z. B. Test
9. Im Einrichtungsassistenten auf „Chat-ID automatisch ermitteln“ klicken
10. Danach auf „Testnachricht senden“ klicken


3. Automatische Prüfung einrichten

Im Einrichtungsassistenten wird auf folgenden Button geklickt:

Automatische Prüfung einrichten

Dadurch wird der Mailchecker in den Windows-Autostart eingetragen.

Der Mailchecker startet künftig automatisch, wenn eine Windows-Anmeldung erfolgt.

Nach der Windows-Anmeldung wartet das Programm ca. 5 Minuten, damit Windows, Internet und Hintergrunddienste vollständig geladen sind.

Die Prüfung erfolgt maximal einmal pro Tag.

Wenn der Rechner an einem Tag nicht eingeschaltet wird, findet an diesem Tag keine automatische Prüfung statt.


TEST

Im Einrichtungsassistenten kann jederzeit auf folgenden Button geklickt werden:

Mailchecker jetzt testen

Damit wird der Mailchecker sofort gestartet.


WAS DAS PROGRAMM MACHT

Das Programm öffnet automatisiert einen Browser.

Danach wird die Schulcloud-Anmeldeseite geöffnet.

Die gespeicherten Zugangsdaten werden eingetragen.

Der Mailbereich wird geöffnet.

Es wird geprüft, ob ungelesene Mails vorhanden sind.

Falls ungelesene Mails vorhanden sind, wird eine Telegram-Benachrichtigung mit Absender und Betreff gesendet.

Der Browser wird danach wieder geschlossen.


WAS DAS PROGRAMM NICHT MACHT

Das Programm leitet keine vollständigen Mails weiter.

Das Programm beantwortet keine Mails.

Das Programm löscht keine Mails.

Das Programm verändert keine Mails.

Das Programm überträgt keine Schulcloud-Zugangsdaten an den Herausgeber.

Das Programm speichert keine Daten auf einem externen Server.

Das Programm verwendet kein Tracking.


DEINSTALLATION

1. Einrichtungsassistent starten

Dazu wird folgende Datei gestartet:

start_setup.bat

2. Auf folgenden Button klicken:

Automatische Prüfung löschen

3. Danach kann der komplette Programmordner gelöscht werden.


WEITERGABE

Das Programm darf kostenlos weitergegeben werden.

Erlaubt ist zum Beispiel die Weitergabe:

- per USB-Stick
- per Download-Link
- innerhalb eines Kollegiums
- an andere Lehrkräfte
- an Lehramtsanwärterinnen und Lehramtsanwärter
- an Personen, die ebenfalls mit der Schulcloud arbeiten

Wichtig:
Die persönliche Datei config.json darf nicht an andere weitergegeben werden, wenn dort bereits eigene Zugangsdaten gespeichert wurden.


HINWEIS

Dieses Programm wurde aus einem praktischen Problem im Schulalltag heraus entwickelt.

Viele Schulcloud-Nutzer erhalten keine zuverlässige Push-Benachrichtigung über neue Mails.
Der Schulcloud-Mailchecker soll diese Lücke schließen, ohne vollständige Mails auf private Konten weiterzuleiten.


KONTAKT

Torsten Montag, Dipl. Betriebswirt, Regelschullehrer
https://www.torstenmontag.de