How to Install and Use superfile in Linux for a Modern Multi-Panel Terminal File Manager

Terminal file managers have long been divided into two distinct eras: traditional curses-based utilities such as GNU Midnight Commander (mc) and Ranger, and modern asynchronous tools like Yazi. While powerful, many users find terminal file managers either visually spartan or overly complicated to configure. superfile (invoked as spf) is an open-source, contemporary terminal file manager written in Go that strikes an ideal balance. Featuring a sleek, visually stunning graphical layout, multi-panel file browsing, real-time syntax-highlighted code previews, comprehensive metadata inspectors, and rich hotkey ergonomics, superfile brings a desktop-grade file management experience directly into your terminal emulator.

Why Use superfile for Linux File Navigation?

Superfile is engineered from the ground up for developer productivity and modern terminal aesthetic appeal:

• Multi-Panel Dual-Pane Browsing: Open, view, and interact with multiple separate directory trees side-by-side in customisable split panels, making file transfers and comparisons effortless.
• Instant In-Terminal File Previews: Automatically renders syntax-highlighted source code, formatted Markdown documents, and metadata summaries without opening an external text editor.
• Clipboard and File Operations: Cut, copy, paste, rename, compress, and delete files with single-key shortcuts accompanied by visual confirmation dialogues.
• Vibrant Theming Support: Ships with out-of-the-box support for Catppuccin, Gruvbox, Dracula, Nord, Tokyo Night, and Monokai colour palettes, matching your terminal emulator seamlessly.
• Minimal Configuration Overhead: Ready to use out of the box with zero required configuration files, while offering clean TOML customization if desired.

How to Install superfile in Linux

Superfile can be installed across all major Linux distributions via an automated one-line installer, native package repositories, or pre-compiled binaries.

Method 1: Install via the Official Install Script (Recommended)

The fastest cross-distribution installation method downloads and installs the latest verified release binary:

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

Confirm the installation was successful by checking the binary version:

spf --version

Method 2: Install on Arch Linux and Manjaro

Arch Linux users can install superfile directly from the AUR using an AUR helper such as Paru or Yay:

yay -S superfile-bin

Method 3: Install via Go (Go Toolchain)

If you maintain a local Go development environment (Go 1.22 or newer):

go install github.com/yorukot/superfile@latest

Ensure that ~/go/bin is added to your shell’s PATH variable.

How to Launch and Navigate superfile

To start browsing files, simply launch the spf binary in your terminal:

spf

To launch directly into a specific project folder, append the directory path:

spf /var/www/html

Essential Keyboard Shortcuts in superfile

Superfile uses intuitive, ergonomic keybindings designed for swift keyboard navigation:

• j / k or ↓ / ↑: Move selection cursor down or up through the active directory list.
• h / l or ← / →: Move up to parent directory or descend into the highlighted folder.
• Enter: Open a directory or launch a selected file in your system’s default application or text editor.
• Tab: Switch focus between the left and right file browsing panels.
• n: Create a new file or directory in the currently focused panel.
• c: Copy the currently selected file or folder to the internal clipboard.
• x: Cut the currently selected item for moving.
• v: Paste previously copied or cut items into the active folder.
• d: Move selected files to the system trash or trigger deletion.
• r: Rename the highlighted item with an inline prompt.
• /: Activate live fuzzy file search across the active directory.
• ?: Open the in-app interactive keyboard shortcut guide.
• q: Exit superfile cleanly back to your shell prompt.

How to Customise Themes and Settings in superfile

Superfile stores its configuration and colour palettes inside standard XDG directories (~/.config/superfile/config.toml and ~/.config/superfile/theme/).

1. Open the configuration file in your preferred text editor:

   nano ~/.config/superfile/config.toml

2. To switch the visual theme, locate the theme setting and change it to your favourite palette:

   theme = "catppuccin-mocha"

   (Other popular built-in options include gruvbox, dracula, nord, and tokyonight).
3. To configure whether hidden dotfiles (e.g. .gitignore, .env) appear by default, adjust:

   show_hidden_files = true

4. Save your changes and relaunch spf to enjoy your newly styled terminal workspace.