yorukot/superfilePublic

What is superfile?

A modern, highly customizable terminal file manager built with Go and Bubble Tea.

What does superfile do?

Superfile is a fast and visually appealing file manager designed specifically for the terminal environment. Developed in Go, it leverages the Bubble Tea framework to deliver a smooth and responsive text-based user interface (TUI). It allows users to perform common file operations seamlessly using intuitive hotkeys and an integrated command system. The tool supports extensive customization, including themes and plugins, enabling developers to tailor the visual aesthetic and functionality to their workflows. Superfile aims to replace traditional graphical file managers with a more efficient, keyboard-centric alternative.

Who is superfile for?

Software developers, system administrators, and Linux power users who prefer working within a terminal. It is ideal for anyone seeking a fast, customizable alternative to graphical file explorers.

How do I get started with superfile?

https://github.com/yorukot/superfile

How popular is superfile on GitHub?

yorukot/superfile has 23,639 stars and 875 forks on GitHub, and gained 264 stars in the last 7 days.

What license does superfile use?

yorukot/superfile is released under the MIT license.

• Widely adopted

  23,639 stars

• Community-driven

  ~123 contributors

• Outside contributions

  90% of recent commits from the community

• Permissive license

  MIT

• Continuous integration

  Automated checks passing

• Repeat trending

  5 trending appearances

Superfile is a fast and visually appealing file manager designed specifically for the terminal environment. Developed in Go, it leverages the Bubble Tea framework to deliver a smooth and responsive text-based user interface (TUI). It allows users to perform common file operations seamlessly using intuitive hotkeys and an integrated command system. The tool supports extensive customization, including themes and plugins, enabling developers to tailor the visual aesthetic and functionality to their workflows. Superfile aims to replace traditional graphical file managers with a more efficient, keyboard-centric alternative.

Software developers, system administrators, and Linux power users who prefer working within a terminal. It is ideal for anyone seeking a fast, customizable alternative to graphical file explorers.

• Keyboard-centric navigation: Enables rapid file traversal and manipulation using configurable hotkeys.
• Customizable themes: Allows users to completely alter the visual appearance for day and night environments.
• Plugin ecosystem: Extends core functionality through a modular architecture supported by the community.
• Bubble Tea interface: Provides a highly responsive and modern TUI built on robust Go libraries.
• Cross-platform support: Runs consistently across macOS, Linux, and Windows terminal emulators.

Getting started: https://github.com/yorukot/superfile

1. v1.6.0v1.6.0Jun 7, 202650.5K downloads

   This release focuses on preview reliability, richer file metadata, configurable sidebar behavior, and a refreshed website and logo design, alongside navigation improvements, better error messages, refactoring, dependency updates, and bug fixes. ## Install: [**Click me to know how to install**](https://github.com/yorukot/superfile?tab=readme-ov-file#installation) ## Highlights - Improved image and file preview reliability through the Bubble Tea v2 migration. Thanks @lazysegtree for the implementation - New website & logo design. Thanks @elvisdragonmao for the implementation - Added richer file metadata, including binary architecture detection for ELF/PE/Mach-O, Linux attributes, and file type byte support in the permissions column. Thanks @barsaskn, @xelavopelk, and @booth-w for the implementation - Sidebar sections can now be configured for visibility and ordering. Thanks @Mjoyufull for the implementation - Improved file operation error messages for delete, paste, and file text preview failures. Thanks @xelavopelk for the implementation - Added `split_file_panel` key function and navigation improvements for file panels. Thanks @robert-zaremba, @xelavopelk, and @padda78

2. v1.6.0-rc1v1.6.0-rc1May 27, 2026pre-release649 downloads

   ## How to install the pre-release ### macOS/Linux ```bash SPF_INSTALL_VERSION=1.6.0-rc1 bash -c "$(curl -sLo- https://superfile.dev/install.sh)" ``` Note: If you have spf installed via brew or another package manager, remove that installation first. Otherwise, running spf in the terminal might still point to the package manager version instead of the pre-release installed by the script. ### Windows ```bash $env:SPF_INSTALL_VERSION = "1.6.0-rc1" Invoke-Expression ((New-Object System.Net.WebClient).DownloadString("https://superfile.dev/install.ps1")) ``` Note: You can also build it from source. Refer to the README file in the repository for more information. After installation, ensure that spf --version prints: superfile version v1.6.0-rc1 ## Major Changes - Improve image preview and file preview reliability through the Bubble Tea v2 migration #1406 - New website & logo design #1423 - Add richer file metadata, including binary architecture detection, Linux attributes, and file type byte in permissions column #1328, #1432, #1410 - Add sidebar section visibility and ordering configuration #1323 - Improve file operation error messages for delete, p

3. v1.5.0v1.5.0Jan 13, 202619.1K downloads

   This release brings major new features, including video and PDF preview support, multi-column file panels, and configurable navigation, alongside significant code refactoring and comprehensive bug fixes. ## Install: [**Click me to know how to install**](https://github.com/yorukot/superfile?tab=readme-ov-file#installation) ## Highlights - Added video and PDF preview support via loading the first frame/page as an image. Thanks @Yassen-Higazi for the implementation <details><summary>Screenshots</summary> <p> <img width="951" height="596" alt="image" src="https://github.com/user-attachments/assets/6edfa9c2-ebcd-4622-a115-f71fa533b3e1" /> <img width="949" height="594" alt="image" src="https://github.com/user-attachments/assets/8d15fa46-5178-422d-8eea-455cac31fdd0" /> </p> </details> - Multi-column file panel view with date/size/permission columns. Thanks @xelavopelk for the implementation <details><summary>Screenshots</summary> <p> <img width="420" height="264" alt="image" src="https://github.com/user-attachments/assets/e172f1e8-c2a5-42d2-8eeb-62e721f61a4f" /> </p> </details> - Configurable fast navigation in the Filepanel. See this PR for mo

4. v1.5.0-rc1v1.5.0-rc1Jan 3, 2026pre-release137 downloads

   ## How to install the pre-release MacOS/Linux ``` SPF_INSTALL_VERSION=1.5.0-rc1 bash -c "$(curl -sLo- https://superfile.netlify.app/install.sh)" ``` Note - If you have `spf` installed via `brew` or other package manager, you would need to remove that installation; otherwise, running `spf` command in the terminal might still point to the one you installed via the package manager, not the one you installed via the script. Windows ``` powershell -ExecutionPolicy Bypass -Command "$env:SPF_INSTALL_VERSION=1.5.0-rc1; Invoke-Expression ((New-Object System.Net.WebClient).DownloadString('https://superfile.netlify.app/install.ps1'))" ``` Note - You can also build it from source. Refer to the README file in the repository for more information. Ensure that `spf --version` prints `superfile version v1.5.0-rc1` ## Major Changes Major Changes - Configurable & faster navigation with a new key-driven navigation system. See this PR for more details: [#1220](https://github.com/yorukot/superfile/pull/1220) - Terminal stdout support for shell commands, enabling direct output display. - Trash bin added to default directories on Linux. - Allow the preview panel to have bord

5. v1.4.1-rcv1.4.1-rcDec 21, 2025pre-release117 downloads

   ## How to install the pre-release MacOS/Linux ``` SPF_INSTALL_VERSION=1.4.1-rc bash -c "$(curl -sLo- https://superfile.netlify.app/install.sh)" ``` Note - If you have `spf` installed via `brew` or other package manager, you would need to remove that installation; otherwise, running `spf` command in the terminal might still point to the one you installed via the package manager, not the one you installed via the script. Windows ``` powershell -ExecutionPolicy Bypass -Command "$env:SPF_INSTALL_VERSION=1.4.1-rc; Invoke-Expression ((New-Object System.Net.WebClient).DownloadString('https://superfile.netlify.app/install.ps1'))" ``` Note - You can also build it from source. Refer to the README file in the repository for more information. ## Major Changes * Added video and PDF preview support. * Added hover-to-file behavior while launching Superfile. Launching `spf /path/to/1.txt` will open the directory containing `1.txt` with `1.txt` sepected * Enabled user-configurable editors per file extension. * Improve rendering performance by removing repeated syscalls. ### Internal improvements * Fixing some flaky tests * Refactoring and linter enablement ## C

• practical-tutorials/project-based-learning

  Curated list of project-based tutorials

  285.8K stars · Python

• n8n-io/n8n

  Fair-code workflow automation platform with native AI capabilities. Combine visual building with custom code, self-host or cloud, 400+ integrations.

  206.7K stars · TypeScript

• yt-dlp/yt-dlp

  A feature-rich command-line audio/video downloader

  195.5K stars · Python

• avelino/awesome-go

  A curated list of awesome Go frameworks, libraries and software

  186.9K stars · Go

• huggingface/transformers

  🤗 Transformers: the model-definition framework for state-of-the-art machine learning models in text, vision, audio, and multimodal models, for both inference and training.

  167K stars · Python

• kubernetes/kubernetes

  Production-Grade Container Scheduling and Management

  128.3K stars · Go