S

superfile

SHA-256
19.7k stars·File Management·SHA-256 checksum verified

superfile 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)

Troubleshooting
How 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.

GitHub Issue #1550
Troubleshooting
Why 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).

GitHub Issue #1311

Tags

terminalfile-managertuigocross-platform

Getting Started

1

Download installer

Click the button above to download the installer for your system

2

Install the software

Double-click the downloaded installer and follow the prompts

3

Open terminal and run the one-command install script (curl for macOS/Linux, PowerShell for Windows)

4

Type `spf` in terminal to start superfile

5

Use arrow keys or h/j/k/l to navigate, Enter to open directory, q to quit

Install Guide
  1. Open terminal and run the one-command install script (curl for macOS/Linux, PowerShell for Windows)
  2. Type `spf` in terminal to start superfile
  3. Use arrow keys or h/j/k/l to navigate, Enter to open directory, q to quit
File Integrity

SHA-256 checksum verified

Checksum extracted from GitHub official Release page

SHA256 Checksum

c08544196ff21fc415ae7cffc800d8400914af647e44eb2613968c09d5868d90

This 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 Source
Environment Guide

Uninstall 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.

Project Info
LicenseMIT
Last Updated2026-10-15 04:27:03
GitHub RepositoryOfficial Website

Having issues? Check the FAQ below

2 FAQs

Similar Projects