File Manager — Benutzerhandbuch

Was das Modul „File Manager" leistet

Der File Manager ist ein einziger Browser für Dateien auf Ihrem Computer und in Cloud-Speichern. Anstatt zwischen Finder/Explorer, einem FTP-Client, einer S3-Konsole und WinSCP hin und her zu wechseln, bekommen Sie ein einziges Fenster, in dem Sie bis zu vier Ordner nebeneinander öffnen, Dateien dazwischen ziehen und lange Kopiervorgänge über die Transfer-Warteschlange im Blick behalten können.

Was Sie bekommen:

Vier Verbindungsarten — lokale Festplatte, FTP, SFTP und S3-kompatibler Speicher (Amazon S3, MinIO, Yandex Cloud, Backblaze B2, Cloudflare R2 und andere).
Bis zu vier Ordner nebeneinander — ein Browser mit zwei, drei oder vier Spalten, mit unabhängiger Navigation, Sortierung und Filtern pro Spalte.
Transfer-Warteschlange — Kopier- und Verschiebevorgänge sind in einem separaten Panel mit Fortschritt pro Datei und Bytes sichtbar, mit Pause, Fortsetzen und Abbrechen.
Wiederaufnehmbare Uploads — große Dateien werden in S3 in 8-MB-Teile zerlegt; bricht die Verbindung ab, läuft der Transfer ab dem letzten erfolgreichen Teil weiter.
Konfliktauflösung — bei Namenskollisionen können Sie überspringen, überschreiben oder automatisch umbenennen, mit einer Option „auf alle anwenden".
Inspector — Vorschau für Bilder, Text, PDFs, Video und Audio sowie Dateieigenschaften und SHA256-Hash auf Anfrage.
ZIP-Archive — direkt im Browser erstellen und entpacken.
Sitzungs-Wiederherstellung — geöffnete Ordner und Spalten kehren nach einem Neustart der App zurück.
Verschlüsselte Zugangsdaten — FTP-Passwörter, SSH-Schlüssel und Cloud-Zugangsschlüssel werden verschlüsselt gespeichert.

Unterstützte Verbindungen und ihre Parameter

Typ	Port	Was Sie eingeben
Local	—	Pfad zu einem Ordner auf der Festplatte
FTP	21	Host, Benutzername, Passwort, Root-Pfad, optional TLS
SFTP	22	Host, Benutzername; Passwort und/oder privater SSH-Schlüssel
S3	—	Endpoint (optional), Region, Bucket, Prefix, Access Key, Secret Key

Local

Folder — Pfad zum Ordner. Die Schaltfläche Choose öffnet die System-Auswahl.

FTP

Host — Server-Adresse.
Port — Standard ist 21.
Username und Password.
Root path — wird als „Root" der Verbindung verwendet, Standard ist /.
Use TLS — Checkbox für FTPS, standardmäßig deaktiviert.
Die Verbindung läuft im Passiv-Modus.

SFTP

Host und Port (Standard ist 22).
Username.
Password — für die Passwort-Authentifizierung (optional).
Private Key — der Text des privaten SSH-Schlüssels (-----BEGIN OPENSSH PRIVATE KEY-----…). Optional.
Passphrase — falls der Schlüssel mit einer Passphrase geschützt ist.
Host Fingerprint — Server-Fingerprint als SHA256:… für die Trust-on-First-Use-Validierung. Optional.
Root path — Standard ist /.

Sie können ein Passwort, einen Schlüssel oder beides gleichzeitig verwenden.

S3-kompatibler Speicher

S3 Endpoint — Anbieter-URL. Für AWS S3 leer lassen. Beispiele: https://storage.yandexcloud.net, https://s3.us-west-002.backblazeb2.com, https://<account>.r2.cloudflarestorage.com, http://localhost:9000 für MinIO.
S3 Region — Standard ist us-east-1.
S3 Bucket — erforderlich.
S3 Prefix — optionales Prefix innerhalb des Buckets, wird als „Root" der Verbindung verwendet.
S3 Access Key und S3 Secret Key.
Force Path Style — Checkbox für Anbieter, die Path-Style-URLs anstelle von Virtual-Hosted-URLs erfordern (z. B. MinIO). Standardmäßig deaktiviert.

Für große Dateien startet automatisch der Multipart-Upload mit einer Teilgröße von 8 MB.

Wie das Fenster aufgebaut ist

Der File Manager hat bis zu vier Spalten gleichzeitig. Jede Spalte zeigt:

Adressleiste — der aktuelle Pfad; zum Bearbeiten anklicken (oder Cmd/Ctrl+L drücken).
Dateiliste — sortierbar nach Name, Größe, Änderungszeit oder Typ.
Such-/Filterfeld — filtert die Liste nach Teilzeichenkette.
Umschalter für versteckte Dateien — Punktdateien anzeigen oder ausblenden.

Spalten können hinzugefügt und entfernt werden. Sind weniger als vier geöffnet, erscheint rechts eine Schaltfläche + Add column. Zwischen den Spalten wechseln Sie mit Tab / Shift+Tab oder springen direkt mit Cmd/Ctrl+1..4.

Auf der rechten Seite können Sie den Inspector öffnen — ein seitliches Panel mit drei Tabs:

Preview — Vorschau der ausgewählten Datei. Unterstützt Bilder, Text (bis zu 100 000 Zeichen), PDFs, Video und Audio. Bei Archiven und Binärdateien werden nur Metadaten angezeigt.
Properties — Größe, Änderungsdatum, vollständiger Pfad.
Hash — SHA256, auf Anfrage berechnet.

Die Breite des Inspectors lässt sich mit der Maus anpassen (zwischen 280 und 720 Pixeln).

Transfer-Warteschlange

Alle länger laufenden Operationen (Kopieren, Verschieben, Upload, Download) landen im Transfer-Panel am unteren Rand des Fensters. Sie können es ein- und wieder ausblenden.

Jede Aufgabe zeigt:

Operationstyp (Kopieren, Verschieben, Upload).
Fortschritt — erledigte Dateien von der Gesamtzahl.
Status — laufend, pausiert, abgeschlossen, abgebrochen oder fehlgeschlagen.
Byte-Fortschritt.

Verfügbare Aktionen:

Pause (‖) — eine laufende Aufgabe pausieren.
Resume (▶) — eine pausierte oder fehlgeschlagene Aufgabe fortsetzen.
Cancel (×) — eine Aufgabe in jedem Zustand abbrechen.
Clear finished — abgeschlossene Aufgaben aus der Liste entfernen.

Wenn am Ziel bereits eine Datei mit demselben Namen existiert, öffnet sich der Konfliktauflösungs-Dialog:

Skip — diese Datei überspringen.
Overwrite — die vorhandene ersetzen.
Rename — (1), (2) usw. anhängen.
Apply to all remaining conflicts — Ihre Wahl auf alle verbleibenden Konflikte in dieser Aufgabe anwenden.
Cancel job — die gesamte Operation abbrechen.

Sitzungs-Wiederherstellung

Nach einem Neustart der App werden folgende Informationen wiederhergestellt:

Welche Spalten geöffnet waren und ihre Breiten.
Verbindung und aktueller Ordner für jede Spalte.
Sortierung, Filter und der Umschalter für versteckte Dateien.
Die aktive Spalte und die Breite des Inspectors.

Die Verbindung selbst wird separat gespeichert und geht nie verloren. Die Sitzung wird automatisch gespeichert, mit einer Debounce-Verzögerung von 0,5 Sekunden nach Änderungen.

Live-Aktualisierung von Ordnern

Bei lokalen Ordnern beobachtet der File Manager das Dateisystem und aktualisiert die Liste selbstständig — Datei in Finder/Explorer hinzufügen oder löschen, und die Spalte aktualisiert sich sofort. Für entfernte Verbindungen (FTP, SFTP, S3) ist eine automatische Aktualisierung nicht verfügbar — drücken Sie Cmd/Ctrl+R oder die Schaltfläche Refresh, um den Ordner neu einzulesen.

Sicherheit

FTP-Passwörter, SSH-Schlüssel, Passphrasen und S3-Zugangsdaten werden verschlüsselt in der lokalen App-Datenbank gespeichert.
Der Renderer (UI-Prozess) sieht niemals rohe Geheimnisse — nur Flags wie „password set" / „key set".
Die Schaltfläche Show password ist auf fünf Anzeigen pro Stunde und Prozess begrenzt.
Für SFTP können Sie einen Server-Fingerprint anpinnen (SHA256:…); beim nächsten Verbinden überprüft die App ihn — das schützt Sie vor Server-Imitation im Netzwerk.

Tastenkürzel

Taste	Aktion
`↑` / `↓`	In der Liste bewegen
`Enter`	Datei öffnen oder in Ordner wechseln
`Backspace`	Eine Ebene nach oben
`F2`	Umbenennen
`F7`	Neuer Ordner
`Delete`	In den Papierkorb verschieben
`Shift+Delete`	Endgültig löschen
`F5`	Auswahl in die gegenüberliegende Spalte kopieren
`F6`	Auswahl in die gegenüberliegende Spalte verschieben
`Cmd/Ctrl+A`	Alles auswählen
`Shift+click`	Bereich auswählen
`Cmd/Ctrl+click`	Auswahl umschalten
`Cmd/Ctrl+C`	Kopieren
`Cmd/Ctrl+X`	Ausschneiden
`Cmd/Ctrl+V`	Einfügen
`Cmd/Ctrl+L`	Pfad bearbeiten
`Cmd/Ctrl+R`	Liste aktualisieren
`Esc`	Auswahl aufheben
`Tab` / `Shift+Tab`	Nächste / vorherige Spalte
`Cmd/Ctrl+1..4`	Spalte 1, 2, 3 oder 4 aktivieren

Einstellungen

Die Einstellungen des File Managers haben vier Abschnitte:

Sources — vollständiges CRUD für gespeicherte Verbindungen, mit den Schaltflächen Test, Ausblenden und Entfernen.
Behaviour — Voreinstellungen: ob versteckte Dateien angezeigt werden, Drag-and-Drop-Verhalten usw.
Hotkeys — Referenztabelle der Tastenkürzel.
About — Modul-Informationen.

Ablauf

1. Mit einem lokalen Ordner verbinden

File Manager in der Seitenleiste öffnen.
Settings → Sources → New source.
Typ — Local.
Name (z. B. „Documents") und den Pfad.
Speichern.
Im Browser + Add column klicken und die neue Verbindung wählen.

2. Mit S3 verbinden

Settings → Sources → New source → Typ S3.
Endpoint (oder leer lassen für AWS), Region, Bucket, Access Key, Secret Key ausfüllen.
Wenn Ihr Anbieter Path-Style-URLs benötigt (z. B. MinIO), Force Path Style aktivieren.
Test — die Verbindung sollte Objekte erfolgreich auflisten.
Speichern.

3. Dateien zwischen Anbietern kopieren

Zwei Spalten öffnen — eine mit dem lokalen Ordner, die andere mit S3 (oder FTP).
Dateien in der Quellspalte auswählen (Cmd/Ctrl+A, Shift+click, Cmd/Ctrl+click).
Die Auswahl in die Zielspalte ziehen — oder F5 (Kopieren) / F6 (Verschieben) drücken.
Der Transfer erscheint im unteren Transfer-Panel. Sind die Dateien bereits vorhanden, öffnet sich der Konflikt-Dialog.
Schließen Sie das Fenster oder arbeiten Sie weiter — der Transfer läuft im Hintergrund. Sie können später pausieren und fortsetzen, auch über App-Neustarts hinweg.

4. Ein Cloud-Archiv auf den Computer entpacken

Zwei Spalten öffnen: S3 (oder FTP) und einen lokalen Ordner.
Das ZIP-Archiv in der entfernten Spalte suchen.
Rechtsklick auf das Archiv → Extract archive.
Den Zielordner wählen — auch direkt in der lokalen Spalte.
Das Entpacken läuft im Hintergrund wie jeder andere Transfer — mit Fortschrittsanzeige und Pause-Unterstützung.

Nächste Schritte

DB Manager — Datenbank-Backups direkt nach S3 oder auf einen FTP-Server planen.
Scenarios — wiederkehrende Dateioperationen automatisieren und dieselben Verbindungen wiederverwenden.
Settings — ein Master-Passwort einrichten, um jede gespeicherte Verbindung zu schützen.

Hilfe und Feedback

Etwas funktioniert nicht oder eine Funktion fehlt? Schreiben Sie uns über das Feedback-Formular.