← benzjeremy.github.io untis-go Wiki (v2.3)
Rechtlicher Hinweis zu Produktabbildungen: Das tatsächliche Produkt kann aus technischen Gründen, durch regelmäßige Versionsaktualisierungen oder betriebssystemspezifische Darstellungen (z.B. GTK3-Windowmanager, Schriftarten) von den gezeigten Bildschirmfotos und UI-Mockups abweichen. Alle gezeigten Schul- und Lehrernamen dienen rein illustrativen Zwecken.
Offizielles Handbuch & Tutorial · Pre-Release

Untis GO – Schritt-für-Schritt Dokumentation

Lerne, wie du untis-go installierst, deine Schule in Sekundenschnelle einrichtest, Stundenpläne blitzschnell abrufst und von modernsten Sicherheitsfeatures wie AES-256-GCM-Verschlüsselung und SQLite-Caching profitierst.

🚧
Pre-Release Status: untis-go befindet sich in aktiver Entwicklung und ist ein Pre-Release (WIP). Funktionen und Schnittstellen werden laufend erweitert. / untis-go is under active development and is a Pre-Release (WIP).

1 Was ist Untis GO?

Untis GO ist ein nativer, freier und quelloffener Desktop-Client für das Schulstundenplan-System WebUntis. Entwickelt in Go und WebKitGTK/HTML5, kombiniert die Anwendung extreme Ausführungsgeschwindigkeit mit einem aufgeräumten, augenschonenden Dark Theme.

Im Gegensatz zur offiziellen Web-Oberfläche, die oft langsam lädt und Sitzungs-Timeouts erzwingt, setzt Untis GO auf eine Local-First-Architektur: Einmal geladene Stundenpläne werden in einer lokalen SQLite-Datenbank verschlüsselt gespeichert und stehen beim nächsten Start in unter 1 Millisekunde bereit – selbst bei instabiler Internetverbindung oder Offline-Betrieb.

Gelistet in Awesome Go: untis-go wurde offiziell in das weltweite Verzeichnis hochqualitativer Go-Projekte aufgenommen (Pull Request #6660 in Other Software).

2 Installation & Erste Schritte

Untis GO steht für Linux und Windows als vorkompilierte Standalone-Binärdatei sowie als Go-Paket bereit.

A

Linux Vorkompiliertes Paket (Empfohlen)

Lade das Tarball aus den GitHub Releases (Latest) herunter, entpacke es und verschiebe die Datei in deinen Systempfad:

tar -xzf untis-go-*-linux.tar.gz
chmod +x untis-go
sudo cp untis-go /usr/local/bin/
untis-go
B

Windows Standalone ZIP

Lade das Windows ZIP-Archiv aus den GitHub Releases (Latest) herunter, entpacke das Archiv in einen Ordner deiner Wahl und starte untis-go.exe. Es ist keine Installation von Treibern oder Runtimes erforderlich.

C

Installation via Go CLI

Falls du eine aktuelle Go-Entwicklungsumgebung besitzt (Go 1.21+):

go install github.com/benzjeremy/untis-go@latest
Linux-Abhängigkeiten: Auf Arch Linux/CachyOS benötigst du webkit2gtk-4.1 und gtk3. Auf Ubuntu/Debian installierst du libwebkit2gtk-4.1-dev und libgtk-3-dev.

3 Onboarding & Schulsuche

Beim allerersten Start begrüßt dich der interaktive Einrichtungsassistent. Es ist keine Schule vorkonfiguriert – du kannst jede beliebige WebUntis-Schule weltweit nutzen.

Schulsuche und Anmeldedialog in untis-go
Abbildung 1: Interaktive Live-Schulsuche und verschlüsselter Anmeldedialog. * Hinweis: Produkt kann je nach Version und Theme leicht abweichen.
1

Schule suchen

Tippe den Namen deiner Schule, deiner Stadt oder deiner Schulnummer in das Suchfeld ein. Das System fragt in Echtzeit die offizielle WebUntis-Schuldatenbank ab und listet passende Ergebnisse mit Anschrift auf.

2

Schule auswählen

Klicke auf deine Schule. Die Server-Adresse (z.B. mese.webuntis.com) und der schulspezifische Login-Name werden automatisch im Hintergrund konfiguriert.

3

Zugangsdaten eingeben

Gib deinen Benutzernamen und dein persönliches Passwort ein. Wenn deine Schule anonymen Lesezugriff erlaubt, kannst du die Felder auch leer lassen.

4

Automatische Erkennung

Untis GO testet die Verbindung sofort per JSON-RPC. Nach erfolgreicher Anmeldung wird deine Klasse automatisch ermittelt und dein Stundenplan sofort geladen.

4 Das Dashboard & Live-Countdown

Das Dashboard ist die Steuerzentrale deines Schultags. Es fasst alle relevanten Informationen auf einen Blick zusammen, ohne dass du suchen musst.

Übersichtliches Dashboard von untis-go
Abbildung 2: Dashboard-Ansicht mit oranger Countdown-Karte und heutigem Tagesablauf. * Hinweis: Produkt kann je nach Version und Theme leicht abweichen.

Die wichtigsten Dashboard-Bereiche:

  • Live-Countdown-Banner: Zeigt dir sekundengenau an, wann die nächste Unterrichtsstunde beginnt, wie lange die aktuelle Pause noch dauert oder wann Schulschluss ist.
  • Unterricht heute: Farbcodierte Unterrichtskarten mit Fachname, Fachlehrer, Raum und Glockenzeiten.
  • Schnellzugriff Hausaufgaben: Deine anstehenden Hausaufgaben sortiert nach Fälligkeitsdatum mit Sofort-Erledigt-Checkbox.
  • Schuldurchsagen & Mitteilungen: Wichtige Durchsagen der Schulleitung oder von Lehrkräften direkt im Blickfeld.

5 Stundenplan: Tages- & Wochenraster

Seit Version v1.4 verfügt Untis GO über ein komplett überarbeitetes, synchrones 6-Spalten-Wochenraster. Jede Schulstunde (1. bis 12. Stunde) wird als einzelne Zeile dargestellt.

Synchrones Wochenraster in untis-go v1.4
Abbildung 3: 6-Spalten-Wochenplan-Matrix mit Einzelstunden-Raster, Vertretungen und Ausfällen. * Hinweis: Produkt kann je nach Version und Theme leicht abweichen.
Blockunterricht gelöst: Hast du 4 Stunden Sport oder 2 Stunden Mathematik hintereinander? Früher wurde dies oft unübersichtlich als einzelner Block angezeigt. In v1.4 erscheint jede Stunde separat und sauber ausgerichtet in ihrer jeweiligen Zeitzeile!

Eigene Fachnamen (Fach-Aliase)

Deine Schule vergibt kryptische Abkürzungen wie LF09, WIR oder M-GK1? Unter Einstellungen & ProfileFach-Aliase kannst du für jede beliebige Abkürzung einen verständlichen Namen festlegen (z.B. LF09 → Anwendungsentwicklung). Dieser wird ab sofort überall in deinen Plänen angezeigt!

6 Weitere Stundenpläne & Favoriten (❤️)

Im Menüpunkt Weitere Stundenpläne kannst du beliebige Ressourcen deiner Schule abfragen:

  • Klassenpläne: Sieh nach, wann andere Klassen Unterricht oder Ausfall haben.
  • Lehrerpläne: Finde heraus, in welchem Raum eine Lehrkraft gerade unterrichtet oder wann ihre Sprechstunde ist.
  • Raumpläne: Prüfe, ob Computerräume, Sporthallen oder Chemieräume zu einer bestimmten Zeit belegt oder frei sind.
Favoritenfunktion: Klicke auf das Herz-Symbol (🤍 → ❤️) neben einer Klasse, um sie zu deinen Favoriten hinzuzufügen. Deine Favoriten bleiben auch nach einem Neustart des Programms oben in der Liste angeheftet!

7 Aufgaben, Abwesenheiten & Mitteilungen

Untis GO bietet eine vollständige lokale Verwaltung für deine schulischen Aufgaben und Abwesenheiten:

📝

Hausaufgabenverwaltung

Erstelle eigene Aufgaben mit Fach, Beschreibung und Fälligkeitsdatum oder synchronisiere von Lehrern eingetragene WebUntis-Hausaufgaben. Mit einem Klick auf die Checkbox markierst du sie als erledigt.

🏥

Fehlzeiten & Krankmeldungen

Erfasse Abwesenheiten mit Von-Bis-Datum, Begründung und Status (entschuldigt / unentschuldigt). Untis GO berechnet automatisch deine Fehlstunden für das laufende Schuljahr.

📢

Schulmitteilungen & Durchsagen

Lies Elternbriefe, Raumverlegungen und Durchsagen der Schulleitung in einem übersichtlichen Postfach mit Lesestatus und Detailansicht.

8 Multi-Profile & Schulwechsel

Besuchst du mehrere Bildungseinrichtungen, hast Geschwister an anderen Schulen oder betreust als Elternteil mehrere Schulkinder?

Untis GO unterstützt unbegrenzt viele Profile:

  • Nahtloses Umschalten: Klicke im Menü auf Profile und wähle die gewünschte Schule aus. Untis GO schaltet die aktive Verbindung sofort ohne Neustart um.
  • Schule löschen: Nicht mehr benötigte Profile lassen sich mit einem Klick auf das rote Mülleimer-Icon restlos aus dem sicheren lokalen Speicher entfernen.

9 Zero-Lag-Architektur & Sicherheit

Bei Untis GO hat Datenschutz höchste Priorität. Hier sind die technischen Schutzmaßnahmen im Überblick:

Sicherheitsmerkmal Implementierung Schutzwirkung
AES-256-GCM Verschlüsselung Passwörter werden mit hardwarebeschleunigtem AES-GCM (Authenticated Encryption) gespeichert. Selbst bei Diebstahl der Festplattendatei können Zugangsdaten nicht im Klartext gelesen werden.
PBKDF2 Key Stretching 100.000 Runden PBKDF2 mit SHA256 und hardwarespezifischem Salt. Verhindert Brute-Force- und Rainbow-Table-Angriffe auf den lokalen Key Vault.
Dynamischer Zufallsport Der interne Go-Server bindet an einen zufälligen Port auf 127.0.0.1. Andere lokale Programme können den Dienst nicht auf Standardports abfangen.
32-Zeichen Crypto-Token Alle internen API-Aufrufe verlangen einen kryptografischen Sitzungsschlüssel. Verhindert unbefugte CSRF- und XSS-Zugriffe aus anderen Browser-Tabs.
SQLite Cache-First Lokale SQLite-Datenbank mit WAL-Modus und Indizierung. Ladezeiten unter 1 ms, kein Warten auf langsame Schulserver.

10 Datenschutz & 100% Local-First Architektur (DSGVO / LDI NRW)

Mit Version v2.2 ist untis-go zu 100% Local-First zurückgekehrt. Frühere Microsoft-OAuth2- und OneDrive-Integrationen wurden vollständig entfernt, um höchste Datenschutzstandards (DSGVO Art. 25 Privacy by Design, LDI NRW) kompromisslos einzuhalten.

🛡️ Keine externen Drittanbieter

Keine Verbindungen zu Microsoft, Cloud-Providern oder Tracking-Diensten. Deine Daten verlassen deinen Rechner niemals ungefragt.

🔐 Gerätegebundene AES-256-GCM Verschlüsselung

Alle Passwörter, Schul-Credentials und Notizen werden lokal in einer geschützten SQLite-Datenbank verschlüsselt gespeichert.

⚡ Direkte Schul-Kommunikation

untis-go kommuniziert ausschließlich auf direktem Weg per HTTPS mit dem offiziellen WebUntis-Server deiner Schule.

🚫 Zero Telemetrie

Keine Nutzungsstatistiken, keine Crash-Reporter, keine Werbe-IDs. Volle Datenkontrolle bleibt zu 100% bei dir.

In v2.3 bietet untis-go nun vollständige RFC-5545 iCalendar (.ics) Integration (Export direkt über das Menü), einen autarken Hintergrund-Sync-Daemon mit nativer Desktop-Benachrichtigung bei Raumänderungen und Entfällen sowie ein System-Tray-Icon für Linux und Windows. Weitere Details findest du im v2.3 Release Changelog.

11 Tastaturkürzel (Power-User Shortcuts)

Mit diesen Tastenkombinationen navigierst du blitzschnell durch die App:

Taste Funktion Beschreibung
Vorheriger Tag / Woche Blättert einen Tag (oder eine Schulwoche) zurück.
Nächster Tag / Woche Blättert einen Tag (oder eine Schulwoche) vorwärts.
T Heute (Today) Springt sofort zum heutigen Tag zurück.
D Tagesansicht (Day) Wechselt in die detaillierte Tagesansicht.
W Wochenansicht (Week) Wechselt in das synchrone 6-Spalten-Wochenraster.
Esc Schließen Schließt alle offenen Dialogfenster, Modale und Menüs.

12 Software-Updates & Releasemanagement

Untis GO besitzt einen integrierten Release-Manager:

Unter Über & Info kannst du mit einem Klick auf „Nach Updates suchen“ prüfen, ob eine neuere Version auf GitHub bereitsteht. Ist ein Update vorhanden, lädt Untis GO das offizielle, signierte Binärpaket atomar herunter und tauscht die Programmdatei im laufenden Betrieb sicher aus – kein mühsames manuelles Entpacken mehr nötig!

13 Häufig gestellte Fragen (FAQ)

?

Ist Untis GO offiziell von der Firma Untis GmbH?

Nein. Untis GO ist ein unabhängiges Open-Source-Projekt unter der GNU GPL-3.0 Lizenz. Es nutzt die standardmäßige WebUntis JSON-RPC API, um Schülern, Eltern und Lehrkräften ein besseres Desktop-Erlebnis zu bieten.

?

Werden meine Passwörter auf fremden Servern gespeichert?

Nein, niemals. Deine Zugangsdaten verlassen deinen Rechner nur verschlüsselt zur direkten Authentifizierung bei dem Server deiner eigenen Schule. Es gibt keine Zwischenserver, kein Tracking und keine Telemetrie.

?

Was kann ich tun, wenn der Login fehlschlägt?

Prüfe, ob du die richtige Schule ausgewählt hast und ob deine Zugangsdaten im normalen WebUntis-Browserportal funktionieren. Achte auf Groß- und Kleinschreibung beim Benutzernamen.

?

Wie kann ich einen Fehler melden oder ein Feature vorschlagen?

Erstelle einfach ein Ticket auf der GitHub Issues Seite. Feedback aus der Community ist ausdrücklich willkommen!