articles/2025/November/superfile.md

Starting Out with Superfile

This blog post provides information about Superfile, a file system browser that runs in the Linux console. There's also apparently a Windows install process. I'll try to update this post periodically with shortcuts that I find most useful.

Originally published as: https://deliverystack.net/2025/11/23/starting-out-with-superfile/

This year, I have been making the transition from Windows to Linux this year, and I assume that many others will do the same. In fact, I think I've booted to Windows only when I had an issue with printing and when I was looking for some old files. I think this means it's easier to switch to Linux these days than you might think.

I don't necessarily recommend the Fedora distribution, but that's what I'm using, so that's what I'll describe. Relative to the File Explorer application on Windows, I have not been especially impressed with the Files application on Fedora. Maybe it would help for me to learn its keyboard shortcuts, but I find it to be overly mouse-intensive. Additionally, I've always liked console applications.

Recently, I learned of Superfile, which is apparently an written in go that works in the text-only console rather than the windowing system, although it opens files in windowing applications when needed. There are other drawbacks, such as the inability to drag and drop files and no context menu for files, but also several advantages for common operations.

To start the Terminal application that provides a console, I:

  1. Press the Windows key to run an application.
  2. Type term to select the Terminal application.
  3. Ensure that the Terminal application is selected (in case I may have installed something else that contains term).
  4. Press ENTER to launch Terminal.
  5. Press F11 to toggle full screen mode (optional). Actually, I pressed CTRL+SHFT+? and changed this shortcut from F11 to ALT+Enter to match my habits from Windows.

To install Superfile:

bash -c "$(curl -sLo- https://superfile.dev/install.sh)"

For access rights, the installer should prompt for your password.

I haven't tried it, but to uninstall, run this and ignore an error (which file exists may depend on whether you used sudo to install it).

rm /usr/local/bin/spf ~/.local/bin/spf

To start Superfile:

spf

SequenceActionSequenceAction
spfLaunch Superfile (Console)F11Toggle full screen mode (Terminal)
q / ESCQuit typing, modal dialog, or SuperfileENTERConfirm typing
Q (uppercase)Exit Superfile, set console working directory to current Superfile directory?Help
oSort optionsR (uppercase)Reverse sort
ENTER or Right ArrowEnter directory or open fileF (uppercase)Toggle footer
sSelect sidebarCTRL+nCreate a new file (end name with / to create a folder)
CTRL+rRenameCTRL+cCopy
CTRL+xCutCTRL+vPaste
CTRL+d or DELDeleteD (uppercase)Delete permanently
A (uppercase)Select allCTRL+pCopy current file or directory path
.Toggle display hidden files/Toggle search (I can't quite figure this out)
vToggle selection vs. normal modeP (uppercase)Pin or unpin folder
CTRL+aZipCTRL+eUnzip
eOpen in default editor ($EDITOR)

I updated my bash configuration (~./.bashrc) to define the alias code VSCodium and set EDITOR to that editor.

alias code='flatpak run com.vscodium.codium'
export EDITOR='flatpak run com.vscodium.codium'