yorukot

    yorukot/superfile

    Pretty fancy and modern terminal file manager

    cli
    bubbletea
    file-manager
    filemanager
    filesystem
    golang
    hacktoberfest
    linux-app
    terminal-app
    terminal-based
    tui
    Go
    MIT
    16.7K stars
    440 forks
    16.7K watching
    Updated 2/27/2026
    View on GitHub
    Backblaze Advertisement

    Loading star history...

    Health Score

    23.74

    Weekly Growth

    +0

    +0.0% this week

    Contributors

    1

    Total contributors

    Open Issues

    178

    Generated Insights

    About superfile

    superfile LOGO

    Go Report Card License MIT Discord Link Release CodeRabbit Pull Request Reviews

    Demo

    Perform common operations

    Content

    Installation

    MacOS and Linux

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

    If you want to inspect the script, see : install.sh

    Windows

    Powershell

    powershell -ExecutionPolicy Bypass -Command "Invoke-Expression ((New-Object System.Net.WebClient).DownloadString('https://superfile.netlify.app/install.ps1'))"
    

    If you want to inspect the script, see : install.ps1

    Winget

    winget install --id yorukot.superfile
    

    Scoop

    scoop install superfile
    

    More installation methods

    Click me to check on how to install

    Build

    You can build the source code yourself by using these steps:

    Requirements

    Build Steps

    Clone this repository using the following command:

    git clone https://github.com/yorukot/superfile.git --depth=1
    

    Enter the downloaded directory:

    cd superfile
    

    For MacOS/Linux

    Run the build.sh file:

    ./build.sh
    

    Add the binary file to your $PATH, e.g., in /usr/local/bin:

    sudo mv ./bin/spf /usr/local/bin
    

    For Windows

    go build -o bin/spf.exe
    

    Edit System Environment Variables and add superfile repo's bin directory to your PATH

    Start superfile

    spf
    

    Supported Systems

    • [x] Linux
    • [x] MacOS
    • [x] Windows (Not fully supported yet)

    Tutorial

    After you install superfile, you can go here to briefly understand how to use superfile!

    Plugins

    Click me to the plugins wiki

    Themes

    Click me to the theme wiki

    Hotkeys

    [!WARNING] If you are vim/nvim user please change your default hotkeys config to vim version!

    Click me to see the hotkey wiki

    Notes

    We have an auto update functionality, that fetches superfile's latest released version from github (if last timestamp of last version check was less than 24 hours) and prints a prompt to user, if there is a newer version available.

    You can turn this off, by setting auto_check_update to false in superfile config. Click me to see the config wiki

    Troubleshooting

    Click me to see common problem fix

    Uninstalling

    MacOS and Linux

    On MacOS and Linux, you can uninstall superfile by simply removing the binary. If you installed superfile with sudo, runw

    sudo rm /usr/local/bin/spf
    

    If you installed superfile without sudo, run

    rm ~/.local/bin/spf
    

    If you don't rember, just try removing both.

    Window

    To uninstall superfile on Windows, use this powershell script.

    powershell -ExecutionPolicy Bypass -Command "Invoke-Expression ((New-Object System.Net.WebClient).DownloadString('https://superfile.netlify.app/uninstall.ps1'))"
    

    Contributing

    If you want to contribute please follow the contribution guide

    Click me to see changelog

    Thanks

    Support

    • a Star on my GitHub repository would be nice 🌟
    • You can buy a coffee for me 💖

    ko-fi

    Contributors

    Thanks to all the contributors for making this project even greater!

    Star History

    THANKS FOR All OF YOUR STARS! Your stars are my motivation to keep updating!

    Star History Chart

    ༼ つ ◕_◕ ༽つ Please share.

    Discover Repositories

    Search across tracked repositories by name or description