Docs
Wie die App funktioniert, was sie speichert und was du tun kannst, wenn etwas nicht geht.
Installieren
Für jede Plattform gibt es eine eigene Version, alle mit denselben Funktionen. Die Dateien und Befehle stehen unter Download.
| Plattform | Form | Updates |
|---|---|---|
| Windows | App, Installer .exe (ohne Admin-Rechte) | in der App, ein Klick |
| macOS | App, .dmg (Apple Silicon und Intel) | in der App, ein Klick |
| Linux | App aus der Paketquelle (dnf, zypper, apt) oder AppImage | mit den Systemupdates |
| Android | App, .apk | in der App |
| Chrome, Edge, Brave | Add-on aus dem Chrome Web Store | automatisch |
| Firefox | Add-on, .xpi (Computer und Android) | automatisch |
| iPhone | Userscript für Safari mit der App «Userscripts» (Anleitung) | neue Datei ersetzen |
Beim ersten Start zeigt die App, was mit deinen Daten passiert. Danach meldest du dich einmal an, oder probierst zuerst das Demokonto mit erfundenen Daten.
Anmeldung
Die App benutzt deinen eigenen WISS-Login, genau wie die Extranet-Seite. Sie liest nur, was du im Extranet sowieso siehst.
- Beim ersten Mal öffnet sich die Seite des Extranets. Die App drückt dort «WISS Office 365».
- Du meldest dich bei Microsoft an. Die App tippt nie ein Passwort ein und speichert keins.
- Danach bleibt die Sitzung bestehen. Läuft sie ab, meldet die App dich unsichtbar im Hintergrund wieder an.
Nur wenn Microsoft wirklich etwas von dir will (Passwort, neues Gerät, Bestätigung), siehst du das Anmeldefenster wieder.
| Version | Wo die Anmeldung im Hintergrund läuft |
|---|---|
| Desktop-App | in einem versteckten Fenster, nur sichtbar, wenn Microsoft dich braucht |
| Android | in einer Seite hinter der App |
| Chrome | in einem minimierten Fenster |
| Firefox | in einem versteckten Tab (Berechtigung «Tabs ausblenden») |
| iPhone | auf der Extranet-Seite selbst |
Daten und Speicher
Alles bleibt auf deinem Gerät. Es gibt keinen Server mit deinen Noten.
| Quelle | Was |
|---|---|
wiss.tocco.ch | Stundenplan, Noten, Absenzen, Prüfungen, Räume, über die Schnittstelle des Extranets mit deinem Login |
modulbaukasten.ch | Modulbeschreibungen und Lehrberufe (öffentlich) |
api.github.com | Prüfen, ob es eine neue Version gibt |
*.onrender.com | nur mit eingeschaltetem Sync, verschlüsselt |
Wo die Daten liegen
| Version | Ort |
|---|---|
| Windows | %APPDATA%\ch.wisstools.stundenplan |
| macOS | ~/Library/Application Support/ch.wisstools.stundenplan |
| Linux | ~/.local/share/ch.wisstools.stundenplan |
| Browser | im Speicher des Add-ons |
| Android | im privaten Ordner der App |
Löschen: Einstellungen › Daten › Alles löschen. Beim Deinstallieren verschwindet alles mit.
Aktualisieren
Beim Öffnen zeigt die App sofort die letzten Daten und holt neue im Hintergrund. Danach aktualisiert sie alle 20 Minuten, solange sie läuft. Der Knopf ↻ oben rechts holt sofort neue Daten.
Unter Einstellungen › Aktualisieren › Diagnose steht, was bei der letzten Aktualisierung passiert ist. Das hilft, wenn etwas nicht stimmt.
Prüfungen schätzen
Das Extranet zeigt viele Prüfungsdaten nicht an. Die App schätzt sie aus dem Modulplan. Geschätzte Daten sind gestrichelt.
| Einstellung | Bedeutung |
|---|---|
| Jede 3. Lektion | ZP am 3., 6., 9. … Modultag |
| Einmal | eine ZP am 3. Modultag |
| Keine | keine ZP, nur LB und Projekt |
LB und Projekt liegen immer am letzten Modultag. Jedes Datum lässt sich bei der Lektion von Hand korrigieren. Korrekturen werden mit dem Sync übertragen.
Noten-Rechner
Für jedes laufende Modul rechnet die App aus, was du in den offenen Teilen noch brauchst, damit die Modulnote auf deine Zielnote gerundet wird.
# Beispiel: ZP 30 %, Projekt 30 %, LB 40 % offen, Ziel 5.0 nötig = (5.0 − 0.25 − (4.5 × 0.3 + 5.5 × 0.3)) / 0.4 = 4.4 # aufgerundet auf eine Zehntelnote
Die − 0.25 kommt von der Rundung auf halbe Noten: ab 4.75 zählt es als 5.0. Ist die nötige Note über 6, steht «geht nicht mehr».
Benachrichtigungen
| Art | Wann |
|---|---|
| Vor jeder Lektion | 5, 10, 15 oder 30 Minuten vorher, mit Raum (aus, bis du es einschaltest) |
| Absenzen-Frist | 2 Tage vor Ablauf der 7-Tage-Frist |
| Neue Noten | nach der Aktualisierung, die sie findet |
Einstellungen › Benachrichtigungen › Test-Benachrichtigung zeigt, ob sie ankommen. Auf dem iPhone gibt es keine Benachrichtigungen.
Desktop-App
Die App für Windows, macOS und Linux ist mit Tauri gebaut: ein kleines Rust-Programm, das den Web-Teil mit der Web-Engine des Systems anzeigt (WebView2, WebKit, WebKitGTK). Deshalb ist der Installer nur wenige MB gross.
- Schliessen versteckt das Fenster. Die App läuft im Tray weiter, Erinnerungen kommen trotzdem. Beenden über das Tray-Menü.
- Tray-Menü: nächste Lektion und Raum, Öffnen, Aktualisieren, Mini-Fenster, Mit dem Computer starten, Beenden.
- Mini-Fenster: eine kleine Karte mit der nächsten Lektion, die immer oben bleibt. Frei verschiebbar.
- Mit dem Computer starten: startet still im Tray, ohne Fenster.
Geräte-Sync
Freiwillig und aus, bis du ihn einschaltest. Vorher spricht die App nie mit dem Sync-Server.
| Wird synchronisiert | Bleibt nur auf dem Gerät |
|---|---|
| Notizen, korrigierte Prüfungsdaten, einige Einstellungen | Stundenplan, Noten, Absenzen, dein Login |
- Auf dem ersten Gerät: Einstellungen › Sync › Einschalten. Bewahre den Wiederherstellungscode gut auf.
- Auf dem neuen Gerät: den Code vom ersten Gerät eingeben oder den QR-Code scannen.
Alles wird auf deinem Gerät mit AES-256 verschlüsselt, bevor es losgeht. Der Server bekommt nur verschlüsselte Pakete und eine zufällige ID, nie den Schlüssel.
Stile und Sprache
Einstellungen › Darstellung. Neun Stile mit eigenem Layout, eigenen Schriften und eigenem Logo, jeweils hell und dunkel. Wer die Farben eines Stils mag, aber das rote Logo behalten will: Logo › Immer rot. Animationen lassen sich ausschalten.
Die App spricht Deutsch und Englisch. Modulnamen und Daten der Schule bleiben, wie sie im Extranet stehen.
Updates
| Version | Wie |
|---|---|
| Windows, macOS | Banner «Version x ist da» › Installieren. Lädt das signierte Update, installiert, startet neu. |
| Linux (Paketquelle) | mit den Systemupdates: GNOME Software, KDE Discover, dnf upgrade, apt upgrade |
| Linux (AppImage) | wie Windows, in der App |
| Android | Banner › Installieren, dann bestätigen |
| Chrome, Firefox | automatisch durch den Browser |
| iPhone | neue WISS-Stundenplan.user.js in den Userscripts-Ordner legen, die alte ersetzen |
Updates für die Desktop-App sind signiert. Die App installiert nur Updates mit der richtigen Signatur.
Linux-Paketquellen
Der einfachste Weg ist der Befehl unter Download › Linux. Er erkennt dnf, zypper oder apt und richtet die Quelle ein. Von Hand geht es so:
Fedora, Nobara, Bazzite, RHEL
$ sudo curl -fsSL -o /etc/yum.repos.d/wiss-stundenplan.repo \ https://stundenplan.severinwehrle.dev/wiss-stundenplan.repo $ sudo dnf install wiss-stundenplan
openSUSE
$ sudo zypper addrepo --refresh https://stundenplan.severinwehrle.dev/wiss-stundenplan.repo $ sudo zypper install wiss-stundenplan
Ubuntu, Debian, Mint, Pop!_OS
$ sudo wget -qO /usr/share/keyrings/wiss-stundenplan.gpg \ https://stundenplan.severinwehrle.dev/wiss-stundenplan.gpg $ sudo wget -qO /etc/apt/sources.list.d/wiss-stundenplan.list \ https://stundenplan.severinwehrle.dev/wiss-stundenplan.list $ sudo apt update && sudo apt install wiss-stundenplan
Pakete und Metadaten sind signiert. Den öffentlichen Schlüssel gibt es unter wiss-stundenplan.asc.
Entfernen
$ sudo dnf remove wiss-stundenplan && sudo rm /etc/yum.repos.d/wiss-stundenplan.repo $ sudo apt remove wiss-stundenplan && sudo rm /etc/apt/sources.list.d/wiss-stundenplan.list
Fehlerbehebung
«Anmeldung nötig» bleibt stehen
Tippe auf «Anmelden» und melde dich im Fenster bei Microsoft an. Hilft das nicht: Einstellungen › Aktualisieren › Diagnose ansehen.
Windows: «Der Computer wurde durch Windows geschützt»
Der Installer ist nicht mit einem kostenpflichtigen Zertifikat signiert. Weitere Informationen › Trotzdem ausführen.
macOS: «kann nicht geöffnet werden»
Die App ist nicht bei Apple notarisiert. Systemeinstellungen › Datenschutz & Sicherheit › Dennoch öffnen. Nur beim ersten Start.
Linux: leeres Fenster
Kommt bei manchen Grafiktreibern mit WebKitGTK vor. Starten mit:
$ WEBKIT_DISABLE_DMABUF_RENDERER=1 wiss-stundenplan
Mit NVIDIA-Treibern macht die App das schon selbst.
Linux: kein Tray-Symbol
Auf reinem GNOME braucht es die Erweiterung «AppIndicator». Ohne läuft die App trotzdem weiter: einfach erneut starten, dann kommt das Fenster zurück.
iPhone: du siehst das normale Extranet
Userscripts ist für wiss.tocco.ch noch nicht erlaubt. In Safari auf aA › Erweiterungen verwalten, Userscripts einschalten und Immer erlauben wählen.
iPhone: es steht immer «Anmeldung nötig»
Auf Anmelden tippen und bei Microsoft «Angemeldet bleiben» wählen.
iPhone: als Icon auf dem Home-Bildschirm
In der App Kurzbefehle einen Kurzbefehl mit URL öffnen und https://wiss.tocco.ch/extranet/?stundenplan erstellen, dann Zum Home-Bildschirm. Safaris eigenes «Zum Home-Bildschirm» geht nicht, dort laufen keine Erweiterungen. Updates: die neue WISS-Stundenplan.user.js in denselben Ordner legen und die alte ersetzen.
Android: «Installation blockiert»
Beim ersten Mal fragt Android, ob dein Browser Apps installieren darf. Erlauben, dann nochmals öffnen.
Datenschutz
- Kein Konto, keine Werbung, kein Tracking, keine Analyse.
- Schuldaten bleiben auf deinem Gerät. Es gibt keinen Server mit deinen Noten.
- Die App tippt nie ein Passwort ein und speichert keins.
- Sync nur, wenn du ihn einschaltest, und dann Ende-zu-Ende verschlüsselt.
- Der ganze Code ist offen auf GitHub.
Die vollständige Datenschutzerklärung steht in PRIVACY.md.
Selbst bauen
Der Code der Add-ons in chrome addon/ ist die Quelle für alle Versionen. Die anderen werden daraus gebaut.
$ git clone https://github.com/Nicolas-Wehrle/Wiss-Stundenplan.git $ cd Wiss-Stundenplan $ python3 scripts/build-firefox.py "chrome addon" "firefox addon" $ python3 iphone/build-ios.py "chrome addon" iphone
Desktop-App
Braucht Rust und Node 18+. Auf Linux zusätzlich:
$ sudo apt install libwebkit2gtk-4.1-dev libayatana-appindicator3-dev librsvg2-dev # Ubuntu, Debian $ sudo dnf install webkit2gtk4.1-devel libayatana-appindicator-gtk3-devel librsvg2-devel # Fedora
$ cd "desktop app" $ npm ci $ npm run dev # zum Ausprobieren $ npm run build # Installer in src-tauri/target/release/bundle/
Android
$ python3 "android app/build-android-web.py" "chrome addon" "android app" $ cd "android app" && ./gradlew assembleRelease # JDK 17+, Android SDK, eigener Signaturschlüssel