Watch
1
0
Fork
You've already forked superfile
0
mirror of https://github.com/yorukot/superfile.git synced 2026-11-17 01:00:50 +00:00
Pretty fancy and modern terminal file manager
  • Go 74.2%
  • Astro 7.1%
  • MDX 6.2%
  • CSS 4.5%
  • Python 4.1%
  • Other 3.8%
Find a file
Repository files (latest commit first)
Filename Latest commit message Latest commit date
Mouad Haikal 2328e2ecb6
fix(prompt): handle empty SPF input (#1701)
Fixes #1700 

## Description
Prevent a panic when an SPF prompt command produces no tokens, such as
whitespace-only input or an environment variable that expands to an
empty string.

The prompt now safely ignores input with no tokens instead of indexing
an empty slice.

## Tests
- `go test ./...`: **passed**
- `go fmt ./...`: **passed**
- `golangci-lint run`: reports 2 findinds in unchanged files:
  ```
src/cmd/debug_info.go:127:1: cognitive complexity 21 of func
`(*debugPrinter).checkDependency` is high (> 20) (gocognit)
  func (dp *debugPrinter) checkDependency(name string, flag string) {
  ^
src/internal/config_function.go:32:2: named return "toggleFooter" with
type "bool" found (nonamedreturns)
	  toggleFooter bool, zClient *zoxidelib.Client) {
	  ^
  2 issues:
  * gocognit: 1
  * nonamedreturns: 1
  ```

<!-- This is an auto-generated comment: release notes by coderabbit.ai
-->

<!-- coderabbit-ai-generated:v1 -->

## Summary by CodeRabbit

* **Bug Fixes**
  * Avoided an error when a prompt contains no arguments.

<!-- end of auto-generated comment: release notes by coderabbit.ai -->
2026-11-06 13:15:00 +08:00
.github feat(packaging): add app icon and metainfo for desktop entry (#1523) 2026-08-03 19:12:22 +08:00
asset feat(packaging): add app icon and metainfo for desktop entry (#1523) 2026-08-03 19:12:22 +08:00
cd_on_quit add cd_on_quit for fish shell 2025-03-09 22:21:35 +05:30
release feat(trash): add native cross-platform trash support (#1495) 2026-06-22 09:41:57 +08:00
scripts ci: update golangci-lint (#1484) 2026-06-19 11:20:21 +08:00
src fix(prompt): handle empty SPF input (#1701) 2026-11-06 13:15:00 +08:00
testsuite feat(trash): add native cross-platform trash support (#1495) 2026-06-22 09:41:57 +08:00
vhs update markdown and update vhs tape 2024-04-18 16:45:57 +08:00
website docs: mention config folder in uninstall instructions (#1684) 2026-10-21 15:30:52 +08:00
.envrc Added direnv support for nix flake dev shell 2025-01-24 15:20:35 -08:00
.gitignore feat: Preview panel seperation (#1021) 2025-08-27 17:53:01 +05:30
.golangci.yaml ci: update golangci-lint (#1484) 2026-06-19 11:20:21 +08:00
build.sh feat(trash): add native cross-platform trash support (#1495) 2026-06-22 09:41:57 +08:00
CONTRIBUTING.md docs: Fix cursor/course typos and other documentation errors (#1505) 2026-07-22 14:45:43 +08:00
dev.sh feat(trash): add native cross-platform trash support (#1495) 2026-06-22 09:41:57 +08:00
flake.lock fix(nix): resolve build failure (#1373) 2026-03-14 21:03:14 +08:00
flake.nix chore: release v1.6.0 (#1468) 2026-06-08 01:39:03 +08:00
go.mod fix(deps): update module github.com/urfave/cli/v3 to v3.10.1 (#1576) 2026-09-28 16:41:50 +08:00
go.sum chore: tidy go.sum (#1698) 2026-11-05 19:58:03 +08:00
gomod2nix.toml fix(deps): update module github.com/urfave/cli/v3 to v3.10.1 (#1576) 2026-09-28 16:41:50 +08:00
LICENSE chore(license): update copyright year (#895) 2025-06-22 19:36:48 +08:00
main.go feat: add goimports linter, and format files with goimport -w 2025-04-05 09:03:38 +05:30
Makefile docs: add notice page and fix tutorial page discuss issue (#1433) 2026-05-14 09:56:33 +08:00
NOTICE.md chore: tidy go.sum (#1698) 2026-11-05 19:58:03 +08:00
notice.tmpl docs: add notice page and fix tutorial page discuss issue (#1433) 2026-05-14 09:56:33 +08:00
README.md docs: mention config folder in uninstall instructions (#1684) 2026-10-21 15:30:52 +08:00

superfile is supported by the community.

Donate to superfile on Ko-fi

superfile LOGO

License MIT Discord Link Release Homebrew downloads GitHub downloads CodeRabbit Pull Request Reviews

Demo

Perform common operations

Content

Installation

macOS and Linux

bash -c "$(curl -sLo- https://superfile.dev/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.dev/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

bash -c "$(curl -sLo- https://superfile.dev/uninstall.sh)"

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

Besides the spf binary in /usr/local/bin or ~/.local/bin, the script also deletes your config and data folders: ~/.config/superfile, ~/.local/share/superfile and ~/.local/state/superfile (or the $XDG_*_HOME locations if you set them, on Linux or macOS), and ~/Library/Application Support/superfile on macOS.

Windows

To uninstall superfile on Windows, use this powershell script.

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

This script does not remove your config and data folder. Delete %LOCALAPPDATA%\superfile manually if you want it gone.

Other install methods

If you installed superfile another way (for example with a package manager), run spf pl before uninstalling to see where your config and data folders are, then delete them yourself. See config file path for all locations.

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

Core maintainer

We welcome anyone who wants to become a core maintainer. Feel free to reach out!

Contributors

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

Powered by

JetBrains logo

Thanks to JetBrains team for providing open-source licenses to support the maintenance of superfile.

Star History

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

Star History Chart

༼ つ ◕_◕ ༽つ Please share.