Home
Superfile: A Fancy Terminal File Manager
A fancy, modern terminal file manager built with Go and Bubble Tea. GUI-like elegance (multi-panel layout, image preview, themes) fully inside the terminal.
Install
# Linux/macOS
bash -c "$(curl -sLo- https://superfile.dev/install.sh)"
# Homebrew
brew install superfile
# Nix
nix profile install github:yorukot/superfile#superfile
# Windows (winget/scoop)
winget install --id yorukot.superfile
scoop install superfile
Run with spf.
Config lives at ~/.config/superfile/ (Linux), ~/Library/Application Support/superfile/ (macOS), %LOCALAPPDATA%\superfile\ (Windows) — config.toml, hotkeys.toml, theme file. A Vim-style keymap (vimHotkeys.toml) is officially provided if you want the alternate scheme.
Core features
- Multi-panel layout — split into several directory panes, copy/paste across them
- File preview pane, including inline images (Kitty graphics protocol or Unicode fallback)
- Fuzzy search, bulk selection/operations
- Sidebar with pinned directories, zoxide integration (
z to jump to frecent dirs)
- Full hotkey remapping via
hotkeys.toml
- Plugin and theme system (git status, system monitoring, etc.)
- Compress/decompress archives (zip)
- Auto
cd on quit — shell working directory follows wherever you were browsing (needs shell integration)
Key shortcuts (defaults)
Basic
| Key |
Action |
q / Esc |
Quit |
Q (Shift+Q) |
Quit and cd to current folder (cd_quit, needs shell setup) |
Enter / → / l |
Open file / enter directory |
Backspace / h |
Return to parent directory |
Navigation
| Key |
Action |
↑ ↓ / k j |
Move cursor |
PageUp PageDown |
Scroll by page |
Tab / L |
Next file panel |
Shift+← / H |
Previous file panel |
n |
New file panel |
N (Shift+N) |
Split file panel |
w |
Close file panel |
s |
Focus sidebar |
p |
Focus process bar |
m |
Focus metadata |
z |
Zoxide jump panel (if enabled) |
Selection
| Key |
Action |
Space |
Select file/folder |
v |
Toggle selection (visual/Vim-style) mode |
File operations
| Key |
Action |
Ctrl+N |
Create new file/folder (trailing / = folder) |
Ctrl+R |
Rename |
Ctrl+C |
Copy |
Ctrl+X |
Cut |
Ctrl+V / Ctrl+W |
Paste |
Ctrl+D / Delete |
Delete (to trash) |
D (Shift+D) |
Permanently delete |
Ctrl+A |
Compress (zip) |
Ctrl+E |
Decompress |
e |
Edit file in default editor ($EDITOR) |
View & misc
| Key |
Action |
. |
Toggle hidden (dot) files |
f |
Toggle file preview panel |
o |
Open sort options menu |
R (Shift+R) |
Toggle reverse sort |
P (Shift+P) |
Pin/unpin current directory to sidebar |
/ |
Search in current directory |
: |
Shell mode — run arbitrary shell commands |
> |
Command-prompt mode — internal superfile commands (split, cd [path], open [path], $ [shell command]) |
Useful CLI
spf pl # prints config/hotkeys/theme file paths
Full hotkey reference (source of truth, since these get remapped across releases): https://superfile.dev/list/hotkey-list/
Custom hotkeys guide: https://superfile.dev/configure/custom-hotkeys/