LinuxCommandLibrary

spf

Modern terminal file manager

TLDR

Open the file manager in the current directory
$ spf
copy
Open a specific directory
$ spf [/path/to/directory]
copy
Open with a file selected
$ spf [/path/to/file.txt]
copy
Print configuration file paths
$ spf path-list
copy
Use a custom configuration file
$ spf -c [/path/to/config.toml]
copy
Show version information
$ spf --version
copy
Show help
$ spf --help
copy

SYNOPSIS

spf [options] [path...]

DESCRIPTION

spf (Superfile) is a modern terminal file manager with a focus on aesthetics and usability. It provides a multi-panel interface for efficient file navigation and operations, supporting keyboard-driven workflows similar to vim.
The interface displays file listings with icons (requires Nerd Font), metadata previews, and supports multiple panels for working across directories simultaneously. Operations include copying, moving, renaming, deleting files, and creating new files and directories.
Key navigation uses vim-style bindings by default: h/j/k/l for movement, y to copy, p to paste, d to delete, and enter to open. Press > to open the command prompt for SPF-specific commands like split to open additional panels.
Configuration files control hotkeys, themes, and behavior. Files are stored in ~/.config/superfile/ on Linux and macOS. Themes and border styles are fully customizable.

PARAMETERS

-c, --config-file path

Use a custom configuration file instead of the default
--version
Display version information
--help
Show help message
path-list, pl
Print paths of all configuration files

CONFIGURATION

~/.config/superfile/config.toml

Main configuration file controlling keybindings, default sort order, display options, and panel behavior.
~/.config/superfile/theme.toml
Theme configuration defining colors, border styles, and icon settings.
~/.config/superfile/hotkeys.toml
Custom keybinding overrides for navigation and file operations.

CAVEATS

Superfile requires a Nerd Font to display file and directory icons correctly. Windows support is partial. The default keybindings may conflict with existing terminal shortcuts; a vim-specific configuration is available for vim/nvim users.

HISTORY

Superfile was created by yorukot and first released in 2024. Written in Go using the Bubble Tea framework for terminal UI, it was designed as a modern, visually appealing alternative to traditional file managers like ranger, mc, and nnn.

SEE ALSO

ranger(1), mc(1), nnn(1), lf(1), vifm(1)

> TERMINAL_GEAR

Curated for the Linux community

Copied to clipboard