Prilog Handbuch

Appearance

Prilog Drive — Desktop-Sync-Client ​

Synchronisiert dein Mein Fach mit einem lokalen Ordner auf deinem PC oder Mac. Ähnlich wie Dropbox oder Google Drive, nur für Prilog.

Übersicht ​

Prilog Drive ist eine kleine Desktop-Anwendung, die einen Ordner auf deinem Computer mit deinem Mein Fach im Web-Client verbindet. Was du in den Ordner legst, erscheint binnen Sekunden im Web-Client — und umgekehrt.

Vorteile ​

Ohne DriveMit Drive
Datei via Drag&Drop im Browser hochladenIn den ~/Prilog/-Ordner kopieren — Sync läuft automatisch
Datei aus dem Browser herunterladen, dann öffnenDatei direkt im Datei-Explorer doppelklicken
Mehrere Versionen manuell hochladenLokales Speichern aktualisiert die Version automatisch
Offline keine ZugriffsmöglichkeitAuch offline sind alle Dateien lokal verfügbar

Installation ​

Windows ​

  1. Lade die aktuelle Version aus dem GitHub-Release herunter: prilog-drive Releases
  2. Entpacke die ZIP-Datei
  3. Doppelklick auf Prilog Drive_x.y.z_x64_en-US.msi (oder die _x64-setup.exe)
  4. Windows SmartScreen warnt vor unbekanntem Herausgeber — Klick auf „Weitere Informationen" → „Trotzdem ausführen" (Code-Signing kommt mit dem nächsten Update)
  5. Installation läuft → „Prilog Drive" erscheint im Startmenü

macOS ​

  1. Lade die .dmg-Datei aus dem Release herunter
  2. Öffne die .dmg per Doppelklick
  3. Ziehe Prilog Drive in den Programme-Ordner
  4. Beim ersten Start: Rechts-Klick → „Öffnen" (Gatekeeper-Warnung wegen fehlender Apple-Notarization)
  5. Erlaubnis bestätigen → App startet

Linux ​

  1. Lade die .deb (Ubuntu/Debian) oder .AppImage (universal) herunter
  2. Doppelklick auf die .deb → System-Installer öffnet sich
  3. Oder: AppImage ausführbar machen (chmod +x Prilog\ Drive.AppImage) und doppelklicken

Erste Einrichtung (Pairing) ​

Beim ersten Start ist die App noch nicht mit deinem Prilog-Konto verbunden. Du brauchst einen 6-stelligen Pairing-Code, der nur 10 Minuten gültig ist.

  1. Im Web-Client: Einstellungen → Meine Geräte → Neuen Computer koppeln
  2. Der Web-Client zeigt einen 6-stelligen Code (z.B. K4N8P2) mit Countdown
  3. In Prilog Drive: Code eingeben → Verbinden
  4. Beim Erfolg erscheint dein Name + die Schule, mit der du verbunden bist
  5. Drive legt automatisch einen Ordner ~/Prilog/ an (auf Windows: C:\Users\<DeinName>\Prilog\)

Wo ist der Sync-Ordner? ​

PlattformPfad
WindowsC:\Users\<DeinName>\Prilog\
macOS/Users/<DeinName>/Prilog/
Linux~/Prilog/

Über Sync-Ordner öffnen im Drive-Fenster springst du direkt dort hin.

Synchronisation ​

Was wird synchronisiert? ​

  • Dateien, die du in den ~/Prilog/-Ordner legst → werden in dein Mein Fach hochgeladen
  • Dateien, die im Web-Client zu Mein Fach hinzugefügt werden → erscheinen automatisch im lokalen Ordner

Datei hinzufügen ​

Lokal → Server:

  1. Datei in den ~/Prilog/-Ordner kopieren oder darin speichern
  2. Drive erkennt das Datei-Event und startet den Upload
  3. Live-Status im Drive-Fenster: „Synchronisiert" → „Fertig"

Server → lokal:

  1. Datei im Web-Client zu Mein Fach hinzufügen
  2. Drive lädt sie binnen Sekunden in den lokalen Ordner

Datei umbenennen oder verschieben ​

Funktioniert wie gewohnt im Datei-Explorer. Drive erkennt das und schickt einen Rename ans Backend — der Web-Client zeigt den neuen Namen.

Datei löschen ​

  • Lokal löschen → wird auch im Web-Client zum Papierkorb verschoben (Mein Fach hat 90 Tage Retention)
  • Im Web-Client löschen → verschwindet auch lokal

Konflikt-Behandlung ​

Was passiert, wenn du eine Datei lokal und im Web-Client gleichzeitig änderst?

  1. Drive erkennt den Konflikt beim nächsten Upload-Versuch (HTTP 409 vom Server)
  2. Deine lokale Version wird automatisch umbenannt:
    • notiz.md → notiz (Konflikt von <DeinComputer> 2026-05-13 22-30).md
  3. Die Server-Version bleibt unter dem Original-Namen
  4. Ein roter Toast im Drive-Fenster informiert dich über den Konflikt
  5. Du entscheidest manuell: zusammenführen, eine Version verwerfen, oder beide behalten

Status-Anzeige ​

Das Drive-Fenster zeigt jederzeit den aktuellen Sync-Status:

StatusBedeutung
Idle ✓Nichts zu tun — lokal und Server sind im Gleichstand
Syncing ⟳Mindestens eine Datei wird gerade hoch- oder heruntergeladen (Anzahl: pendingOps)
Offline ⚠Keine Internetverbindung — Änderungen werden gepuffert und beim nächsten Online-Zugang nachgezogen
Error ✕Fehler — siehe letzte Fehlermeldung

Mehrere Geräte ​

Du kannst Prilog Drive auf mehreren Computern parallel betreiben. Jeder Computer kriegt einen eigenen Pairing-Code und ein eigenes Gerät in der Geräte-Liste (Web-Client → Einstellungen → Meine Geräte).

Live-Sync zwischen Geräten ​

Eine Änderung auf Computer A erscheint binnen Sekunden auch auf Computer B (vorausgesetzt, beide sind online). Das funktioniert via einer Live-WebSocket-Verbindung zum Server.

Gerät entfernen ​

  1. Im Web-Client: Meine Geräte → das entsprechende Gerät → Entfernen
  2. Oder im Drive-Fenster: Einstellungen → Geräte-Verbindung entfernen

Nach dem Entfernen funktioniert die Synchronisation für dieses Gerät nicht mehr. Die lokalen Dateien bleiben aber unverändert.

Einschränkungen aktuelle Version (0.1.x) ​

  • Mein Fach (PERSONAL) wird synchronisiert. Space-Dokumente werden in Phase 4 hinzukommen.
  • Maximale Dateigröße: keine harte Grenze. Files > 4 MB werden in 16-MB-Chunks parallel hochgeladen.
  • Kein Move zwischen Mein Fach und Space automatisch — das musst du im Web-Client machen.
  • Native-FS-Integration (Phase V2.0): aktuell werden alle Dateien lokal abgelegt. Eine „on-demand"-Variante (Cloud-Symbol bis zum Klick) kommt später.

Fehlerbehebung ​

Drive startet nicht ​

  • macOS: „Programm konnte nicht geöffnet werden, weil unbekannter Entwickler" → Rechts-Klick → „Öffnen" → Bestätigen
  • Windows: SmartScreen blockiert → „Weitere Informationen" → „Trotzdem ausführen"
  • Linux: AppImage ist nicht ausführbar → chmod +x setzen

Sync funktioniert nicht ​

  1. Im Drive-Fenster den Status prüfen → Offline?
  2. Web-Client → Meine Geräte → ist der Computer noch da, oder als „revoked" markiert?
  3. Datei testen: eine kleine .txt lokal anlegen → erscheint sie im Web-Client?
  4. Falls nein: Drive neu starten. Manchmal hängt der Watcher.

„Pairing fehlgeschlagen" ​

  • Der Code ist nach 10 Minuten abgelaufen → neuen Code im Web-Client erzeugen
  • Tippfehler: 0/O und 1/I/L kommen in den Codes nicht vor — falls du eines getippt hast, prüf nochmal

Konflikt-Datei aufgetaucht ​

Ist normal bei paralleler Bearbeitung. Datei mit (Konflikt von …) im Namen ist deine lokale Variante; ohne Klammern die Server-Version. Vergleichen + zusammenführen + alte Version löschen.

Sicherheit ​

  • Device-Token wird im OS-Schlüsselbund gespeichert:
    • macOS: Keychain Services
    • Windows: Credential Manager
    • Linux: Secret Service (libsecret / GNOME Keyring / KWallet)
  • Transport-Verschlüsselung: alle Verbindungen über HTTPS (TLS 1.3)
  • Keine lokale Verschlüsselung der Dateien: wer deinen Computer entsperren kann, sieht deine Dateien im ~/Prilog/-Ordner

Updates ​

Neue Versionen werden via GitHub Releases bereitgestellt. Aktuell gibt es keinen Auto-Updater — du musst manuell die neue Version installieren (alte Version über die Standard-Deinstallation deines OS entfernen, dann die neue installieren).

Auto-Update kommt mit der Phase 4 (geplant Q3 2026).

Verwandte Themen ​