superfile
SHA-256superfile is a modern terminal file manager that offers a visually appealing TUI with icons and themes. It installs in one command, supports plugins, and automatically updates. Great for developers who want a nicer alternative to ranger or lf.
Smart Download
Download Download Version
v1.6.0 · 13.2 MB
A modern, beautiful terminal file manager with one-command install and auto-update.
Core Features
- Beautiful terminal UI with icons, colors, and mouse support
- Cross-platform (macOS/Linux/Windows) with one-line install
- Built-in auto-update feature
- Plugin and theme system
- Customizable hotkeys (vim mode available)
What It Can't Do
- •Windows support is not fully complete yet; auto-update is enabled by default (can be disabled in config); vim/nvim users should switch to vim hotkey preset.
Use Cases
- Quick file browsing and management in terminal
- Daily file operations for developers replacing ranger/lf
Detailed Introduction
superfile is a terminal-based file manager designed for users who want a visually appealing and functional alternative to traditional CLI tools like ranger or lf. Built with Go, it offers a modern interface with icons, color schemes, and a mouse-friendly layout. Key advantages over similar tools: (1) one-command installation that works on macOS, Linux, and Windows, with package manager support; (2) built-in auto-update feature keeps you current without manual effort. The project is actively maintained with over 19k stars and a vibrant community. It supports custom themes, plugins, and hotkeys, making it highly customizable. While it excels in daily file operations, it is not a full-featured file manager like Midnight Commander—it focuses on simplicity and aesthetics for terminal-only workflows. Perfect for developers, sysadmins, and anyone who lives in the terminal.
Troubleshooting & FAQ (2)
TroubleshootingHow do I fix the memory leak when Superfile reads metadata from large video files?
Upgrade Superfile to a release containing the fix for issue #1550 (fix(metadata): gate binary architecture detection behind magic-byte check). In v1.6.0, GetBinaryArchitecture runs on every regular file and calls elf.Open, then pe.Open, then macho.Open. Go's debug/pe accepts files without an MZ header as raw COFF objects, so video data can be misparsed, causing multi-GB heap allocations that are not released until exit. The fix checks the file's magic bytes before attempting ELF/PE/Mach-O parsing. As a temporary workaround on v1.6.0, avoid sweeping or bulk-selecting many large video files for metadata/thumbnail extraction and restart Superfile to release the retained memory.
TroubleshootingWhy does superfile show a folder as only 4.0 KiB instead of its total contents size?
On Linux/Unix, FileInfo.Size() for a directory returns the size of the directory inode/entry block (commonly 4 KiB), not the recursive size of its contents. superfile's metadata panel used this value unconditionally, producing a misleading folder size. The fix treats directories separately and no longer displays the inode size as the folder size. Update superfile to the latest release—for example, go install github.com/yorukot/superfile@latest or use your package manager's upgrade command—and restart it. To obtain the actual total size from a shell, run du -sh /path/to/folder (or du -sh --apparent-size /path/to/folder for apparent size).
Tags
Getting Started
Download installer
Click the button above to download the installer for your system
Install the software
Double-click the downloaded installer and follow the prompts
Open terminal and run the one-command install script (curl for macOS/Linux, PowerShell for Windows)
Type `spf` in terminal to start superfile
Use arrow keys or h/j/k/l to navigate, Enter to open directory, q to quit
- Open terminal and run the one-command install script (curl for macOS/Linux, PowerShell for Windows)
- Type `spf` in terminal to start superfile
- Use arrow keys or h/j/k/l to navigate, Enter to open directory, q to quit
SHA-256 checksum verified
Checksum extracted from GitHub official Release page
SHA256 Checksum
c08544196ff21fc415ae7cffc800d8400914af647e44eb2613968c09d5868d90This checksum is extracted from the GitHub Release page. Verify file integrity after download.
All SHA-256 checksums on this platform are extracted from the project's official GitHub Release page, without any modification. You can independently verify them on the GitHub Releases page.
Open Source Transparency
View GitHub SourceUninstall Info
macOS/Linux: run `bash -c "$(curl -sLo- https://superfile.dev/uninstall.sh)"`. Windows: run the PowerShell uninstall script.
No Extra Dependencies
Ready to use after download. No additional runtime required.
Having issues? Check the FAQ below
2 FAQs
Similar Projects
filebrowser
A lightweight, self-hosted web-based file manager. Upload, delete, preview, and edit files in any directory via a browser.
localsend
Free, open-source, cross-platform tool for secure local network file sharing — no internet needed.
Files
A modern file manager for Windows with tabs, tags, and dual-pane support.