Was ist superfile?
superfile ist ein Dateimanager fürs Terminal, der auf offenen Panels aufbaut. Mehrere Verzeichnisse liegen nebeneinander, eine Seitenleiste hält deine Home-Verknüpfungen, angehefteten Ordner und eingehängten Laufwerke bereit, und ein Vorschaufenster zeigt, was gerade unter dem Cursor liegt: Quelltext mit Syntaxhervorhebung, einfacher Text, ein Verzeichnisinhalt, ein Bild. Kopieren, Verschieben und Packen laufen im Hintergrund und melden sich in einer Prozessleiste, ein großer Transfer friert das Panel also nie ein. Gelöschte Dateien landen im Papierkorb und lassen sich zurückholen, Archive werden an Ort und Stelle entpackt und erzeugt, und jede Taste, jede Farbe, jedes Rahmenzeichen und jede Panelbreite ist eine Zeile in einer TOML-Datei. Es ist eine einzige statische Go-Binärdatei, und der Befehl, den du tippst, heißt spf.
>-Prompt und eine Plugin-Liste, die weiter wächst. Jede dieser Funktionen bringt neue Schlüssel in config.toml und hotkeys.toml mit, und eine alte Binärdatei ignoriert stillschweigend genau die Optionen, die die aktuelle Dokumentation dir empfiehlt. Weder Debian noch Ubuntu paketieren superfile überhaupt, ein aktueller Build ist hier also kein Luxus, sondern der einzige Weg, es über apt zu bekommen.
⚡ Hauptfunktionen von superfile
🪟 Panels statt eines Verzeichnisses
n öffnet ein weiteres Dateipanel, tab wechselt dazwischen, jedes mit eigenem Pfad, eigener Sortierung und eigener Auswahl. Kopieren zwischen zwei Bäumen sind damit zwei Tastendrücke statt zweier langer Pfade.
👀 Eine Vorschau, die dem Cursor folgt
Das Seitenfenster zeigt beim Bewegen die markierte Datei: Quelltext mit Hervorhebung durch das eingebaute chroma oder durch bat, Verzeichnisinhalte und Bilder in Terminals, die sie zeichnen können. f klappt es weg, wenn du die Breite brauchst.
♻️ Löschen mit Rückweg
ctrl+d verschiebt Dateien in den Papierkorb, statt sie zu vernichten, ein Fehlgriff bleibt also reparabel. D ist der eigene, bewusste Befehl zum endgültigen Löschen, wenn du es wirklich so meinst.
📊 Eine Prozessleiste für lange Aufgaben
Kopieren, Verschieben und Packen laufen als verfolgte Hintergrundaufgaben mit eigenem Fortschritt, aufgelistet im Prozess-Panel auf p. Das Dateipanel bleibt benutzbar, während ein paar Gigabyte unterwegs sind.
🗜️ Suchen, springen, packen, entpacken
/ filtert das aktuelle Verzeichnis beim Tippen, z übergibt den Sprung an zoxide, sofern installiert, ctrl+a packt die Auswahl und ctrl+e entpackt ein Archiv genau dort, wo es liegt.
🎨 Ganz nach deiner Konfiguration
Eine config.toml und eine hotkeys.toml: jede Taste ist neu belegbar und ein Vim-Satz liegt neben der Standardbelegung, Themes sind Dateien, die du selbst schreiben kannst, und Seitenleistenbreite, Rahmenzeichen, Sortiervorgaben und Vorschaubreite sind Einstellungen.
apt upgrade hält dich auf der neuesten Version.
📦 Installation aus deb.griffo.io
Schritt 1: Repository hinzufügen
sudo install -d -m 0755 /etc/apt/keyrings
curl -fsSL https://deb.griffo.io/EA0F721D231FDD3A0A17B9AC7808B4DD62C41256.asc | sudo gpg --dearmor --yes -o /etc/apt/keyrings/deb.griffo.io.gpg
echo "deb [signed-by=/etc/apt/keyrings/deb.griffo.io.gpg] https://deb.griffo.io/apt $(lsb_release -sc 2>/dev/null) main" | sudo tee /etc/apt/sources.list.d/deb.griffo.io.list > /dev/null
sudo apt updateinstall -d -m 0755 /etc/apt/keyrings
curl -fsSL https://deb.griffo.io/EA0F721D231FDD3A0A17B9AC7808B4DD62C41256.asc | gpg --dearmor --yes -o /etc/apt/keyrings/deb.griffo.io.gpg
echo "deb [signed-by=/etc/apt/keyrings/deb.griffo.io.gpg] https://deb.griffo.io/apt $(lsb_release -sc 2>/dev/null) main" | tee /etc/apt/sources.list.d/deb.griffo.io.list > /dev/null
apt updatesudo apt install extrepo
sudo extrepo enable griffo
sudo apt update🆓 Es gibt einen für immer kostenlosen Spiegel. deb-free.griffo.io liefert Pakete für immer kostenlos — ohne Konto, ohne Abo, höchstens 2 Monate hinter Upstream, Sicherheitsfixes sofort. Derzeit enthält er cliamp, Ghostty, lazydocker, Oh My Posh und Zed; superfile ist nicht dabei, deshalb führt heute nur das Repository oben dorthin — auf Anfrage kann es aufgenommen werden.
🧩 Zur extrepo-Option. extrepo ist Debians eigenes Werkzeug für externe Repositories: Es legt die Sources-Datei an und installiert den Signaturschlüssel für dich, nachdem es ihn gegen signierte Metadaten geprüft hat. Dieses Repository ist dort als griffo registriert, der für immer kostenlose Spiegel als griffo-free. Unter Debian (bookworm, trixie, forky und sid) sind die Befehle oben damit die gesamte Einrichtung.
extrepo richtet nur die Sources-Datei und den Schlüssel ein; die Zugangsdaten eines Abos gehören weiterhin in /etc/apt/auth.conf.d/deb.griffo.io.conf. Ubuntu wird nicht abgedeckt, denn extrepo veröffentlicht Metadaten nur für Debian-Suites: dort nimmst du die Befehle mit sudo oder als root.
Schritt 2: superfile installieren
# Neuestes superfile installieren
sudo apt install superfile
# Optional, für die Plugins, die sie brauchen: exiftool für das
# Metadaten-Panel, zoxide für den schlauen Verzeichnissprung
sudo apt install libimage-exiftool-perl zoxide
# Installation prüfen, der Befehl heißt spf und nicht superfile
spf --version# Neuestes superfile installieren
apt install superfile
# Optional, für die Plugins, die sie brauchen: exiftool für das
# Metadaten-Panel, zoxide für den schlauen Verzeichnissprung
apt install libimage-exiftool-perl zoxide
# Installation prüfen, der Befehl heißt spf und nicht superfile
spf --versionSchritt 3: Der erste Start
# Das Verzeichnis öffnen, in dem du gerade bist
spf
# Oder woanders anfangen
spf ~/Downloads
# Zwei Pfade auf der Kommandozeile bedeuten zwei Panels
spf ~/src ~/Downloads
# Wo Konfiguration, Hotkeys, Theme, Log und Daten liegen
spf path-list
# In superfile öffnet ? die vollständige Tastenliste
spf --help🎯 Grundlegende Verwendungsbeispiele
Starten:
# Das aktuelle Verzeichnis
spf
# Ein Verzeichnis, das du nennst
spf /var/log
# Ein Panel pro Pfad, nebeneinander geöffnet
spf ~/src ~/Downloads /mnt/backup
# Einstellungen ausprobieren, ohne die eigenen Dateien anzufassen
spf --config-file /tmp/spf.toml --hotkey-file /tmp/spf-keys.toml
# Was ist installiert?
spf --versionDie Konfiguration aktuell halten:
# Die Felder und Hotkeys ergänzen, die ein neues Release
# mitgebracht hat, ohne deine Änderungen anzurühren
spf --fix-config-file
spf --fix-hotkeys
# Alle Pfade ausgeben, die superfile benutzt
spf path-list
# Umgebung, Terminal und Version für einen Fehlerbericht
spf --debug-infoIn die Shell einbauen:
# cd_on_quit = true in der config.toml setzen und das hier in
# ~/.bashrc oder ~/.zshrc legen, dann landest du beim Beenden
# mit Q im Verzeichnis, das das Panel zuletzt zeigte
spf() {
export SPF_LAST_DIR="${XDG_STATE_HOME:-$HOME/.local/state}/superfile/lastdir"
command spf "$@"
[ ! -f "$SPF_LAST_DIR" ] || { . "$SPF_LAST_DIR"; rm -f -- "$SPF_LAST_DIR"; }
}
# Der Pfad, den diese Funktion liest
spf path-list --lastdir-file
# superfile als Dateiauswahl für ein anderes Programm: es schreibt
# den gewählten Pfad in die Datei und beendet sich
spf --chooser-file /tmp/picked🔧 Werkzeug-Integrationen
superfile überlässt die Spezialaufgaben bewusst den Werkzeugen, die du schon benutzt:
- Dein Editor:
eöffnet die markierte Datei in$EDITORundEdas Verzeichnis imdir_editor, Neovim oder Helix bleibt also der Editor und superfile der Browser - zoxide: mit
zoxide_support = truespringt die Tastezdurch dieselbe Datenbank, die deine Shell seit Monaten aufbaut - exiftool: mit installiertem
libimage-exiftool-perlundmetadata = truezeigt das Metadaten-Panel die vollständigen EXIF- und Medienfelder statt nur der Grunddaten - bat und chroma: Vorschauen hebt das eingebaute chroma hervor, oder
bat, wenn dir dessen Themes lieber sind und ducode_previewer = "bat"setzt - Dein Terminal und deine Shell: Bildvorschauen nutzen das Bildprotokoll des Terminals,
xdg-openübernimmt die Dateitypen, die du nicht in[open_with]zugeordnet hast, undcd_on_quitgibt das letzte Verzeichnis an bash, zsh oder fish zurück
🚀 Warum deb.griffo.io?
- Offizielles Debian: paketiert superfile nicht,
apt install superfileschlägt auf einem Standardsystem fehl - Selbst aus dem Quelltext bauen: aktuell, aber eine Go-Toolchain auf jeder Maschine und eine Binärdatei, von der apt nichts weiß
- Das Upstream-Installationsskript: ein
curlvon superfile.dev, bequem, aber es schreibt am Paketmanager vorbei ins System und die Binärdatei erinnert dich danach selbst an ihre Updates - deb.griffo.io: neueste Version mit automatischen Updates
- ✅ Die einzige apt-Quelle: superfile ist weder in den Debian- noch in den Ubuntu-Archiven; dieses Repository paketiert das offizielle Upstream-Release
- ✅ Der Befehl heißt spf: das Paket heißt superfile, weil upstream so heißt, und es legt
/usr/bin/spfin deinen PATH, den Befehl, den jedes Tutorial und jede Hotkey-Seite benutzt - ✅ Automatische Updates: Pakete werden innerhalb von Stunden nach dem Upstream-Release aktualisiert,
auto_check_updatedarf also auf false und apt übernimmt das Nachsehen - ✅ Vollständiges Paket: der offizielle Upstream-Linux-Build als
/usr/bin/spf, nichts hinzugefügt, nichts gepatcht - ✅ Ehrliche Abhängigkeiten: die Binärdatei braucht nichts,
xdg-utilsist nur empfohlen, und exiftool, zoxide, ffmpeg, poppler-utils und ein Zwischenablage-Werkzeug sind für die optionalen Funktionen vorgeschlagen, die sie nutzen - ✅ Zwei Architekturen: amd64 und arm64, beide statisch gelinkte Go-Binärdateien, dasselbe Paket läuft damit auf jeder Suite
- ✅ Multi-Distribution: läuft auf Bookworm, Trixie, Forky und Sid
- ✅ Einfache Wartung: Updates mit den üblichen apt-Befehlen
📦 Paket-Build-Repository
Die Debian-Pakete werden in diesem GitHub-Repository automatisch gebaut und gepflegt:
- 🗂️ superfile-debian - Builds der neuesten Releases
🔗 Verwandte Pakete
Ebenfalls verfügbar über deb.griffo.io:
- Yazi - Der andere Terminal-Dateimanager hier, falls dir ein einzelnes Panel und Lua-Plugins besser passen
- zoxide - Die Sprungdatenbank hinter superfiles
z-Taste - eza - Modernes ls für die Auflistungen, für die du keinen Dateimanager öffnen willst
- fzf Fuzzy Finder - Unscharfe Suche für alles, was am Shell-Prompt beginnt
mv kannte.