untis-go Handbuch & Dokumentation

untis-go ist ein lokaler WebUntis-Desktopclient für Schülerinnen, Schüler und Lehrkräfte. Entwickelt in Go mit WebKitGTK für Linux und Browser-App-Mode für Windows. Die Anwendung befindet sich in Entwicklung.

Kernprinzipien: Lokaler SQLite-Cache, verschlüsselte Passwortspeicherung und eine nur an Loopback gebundene Anwendungsschnittstelle. Ein bestimmter Startzeitwert ist nicht belegt.

Erste Schritte & Onboarding

Beim ersten Start führt dich der integrierte Onboarding-Assistent durch die Einrichtung:

1. Schule suchen: Nutze die integrierte WebUntis-Schulsuche (Name oder Schulnummer eingeben).
2. Anmelden: Gib deinen WebUntis-Benutzernamen und dein Passwort ein.
3. Sicher speichern: Deine Zugangsdaten werden mit AES-256-GCM und PBKDF2 verschlüsselt lokal hinterlegt.
4. Fertig: Der Stundenplan wird synchronisiert und steht ab sofort auch offline zur Verfügung.

Funktionen im Detail

Persönlicher Stundenplan

Tages- und Wochenansicht mit roter Live-Zeitlinie. Farbkodierte Fächer, Räume, Lehrkräfte und sofortige Kennzeichnung von Vertretungen, Raumänderungen oder Ausfällen.

Weitere Pläne & Räume

Schnellwechsel zwischen Klassen, Lehrkräften und Fachräumen mit blitzschneller Live-Volltextsuche.

Hausaufgaben-Manager

Übersicht aller WebUntis-Hausaufgaben plus manuell erfasste Aufgaben mit Fälligkeitsdatum und Abhaken per Mausklick.

Mitteilungen & Postfach

Schulnachrichten, Elternbriefe und Lehrerankündigungen direkt im Desktop-Client mit Volltextanzeige.

iCalendar (.ics) Export

1-Klick-Export deines Stundenplans für Google Kalender, Apple Kalender und Thunderbird mit VEVENT-Standardblöcken.

Hintergrund-Daemon & Tray

Überwacht Stundenplanänderungen im Hintergrund und sendet native Benachrichtigungen bei Raumwechsel oder Entfall.

Installation & Build

Linux (x86_64)

# 1. Herunterladen & Entpacken
tar -xzf untis-go-*-linux.tar.gz

# 2. Ins System installieren
sudo cp untis-go /usr/local/bin/

# 3. Starten
untis-go

Windows (x86_64)

Lade das ZIP-Archiv von der GitHub Releases Seite herunter, entpacke es und führe untis-go.exe aus. Es ist keine Installation nötig.

Aus dem Quellcode bauen

# Abhängigkeiten installieren:
# Arch Linux / CachyOS: sudo pacman -S webkit2gtk-4.1 gtk3 gcc
# Ubuntu / Debian:       sudo apt install libwebkit2gtk-4.1-dev libgtk-3-dev build-essential

git clone https://github.com/benzjeremy/untis-go.git
cd untis-go
go build -o untis-go .
./untis-go

Sicherheit & Datenschutz

AES-256-GCM

Passwörter und Sitzungstoken werden mit AES-256 im Galois/Counter-Modus verschlüsselt gespeichert. Kein Klartext auf der Festplatte.

PBKDF2 Schlüsselableitung

100.000 Iterationen (Stand des geprüften Quellcodes) mit maschinenspezifischem Fingerabdruck (Hardware-ID, Benutzer-Salt) zur Absicherung gegen Offline-Brute-Force.

Anti-DNS-Rebinding

Der interne HTTP-Server bindet ausschließlich an 127.0.0.1 mit dynamischem Zufallstoken und prüft alle Request-Header strikt.

Tastenkombinationen

Taste	Aktion
← / →	Vorheriger / Nächster Tag bzw. Woche
T	Zu Heute springen
D	Tagesansicht aktivieren
W	Wochenansicht aktivieren
Esc	Offene Dialoge, Info-Sheets und Menüs schließen

FAQ & Problemlösung

Funktioniert untis-go ohne Internetverbindung?

Bereits synchronisierte Stundenpläne können lokal angezeigt werden. Eine Aktualisierung benötigt eine Verbindung zur WebUntis-Instanz der Schule.

Werden Passwörter an Dritte übertragen?

Die Anmeldung erfolgt direkt bei der WebUntis-Instanz Ihrer Schule. Die Anwendung speichert Passwörter lokal verschlüsselt. Prüfen Sie vor dem Teilen von Profilen oder Kalenderexporten deren persönliche Daten.

Wo werden Fehler oder Feature-Wünsche gemeldet?

Melden Sie Fehler im GitHub-Issue-Tracker.