PackageTrack
Sign in Get early access

github.com/yorukot/superfile

v1.6.0 #117 most downloaded on Go modules yorukot/superfile

What this package is like to depend on

Last release 1 months ago

08 Jul 2026

Release timing varies

gaps range from 8 days to 2 months

Nearly every release is documented

notes for 18 of 18 stable releases

Nothing withdrawn

no release was ever pulled

2 years old

85 releases · first in 2024

21 releases in the last 12 months

see the full history below

Release timeline

85 releases · Apr 2024 to Jul 2026
2025 2026
Release Pre-release

Releases

latest 60 of 85
  1. v1.6.1-0.20260708191840-b59636a9034b 08 Jul 2026 pre-release

    Nothing published for this version

  2. v1.6.1-0.20260622014157-0a4336aad363 22 Jun 2026 pre-release

    Nothing published for this version

  3. v1.6.1-0.20260618150422-5845124b77cd 18 Jun 2026 pre-release

    Nothing published for this version

  4. v1.6.1-0.20260607182041-493b2996cb56 07 Jun 2026 pre-release

    Nothing published for this version

  5. v1.6.0 07 Jun 2026
    Release notes

    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

    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 for the implementation

    New Contributors

    Detailed Change Summary

    Details

    Update

    Bug Fix

    Optimization

    Documentation

    Dependencies

    • Update dependency astro to v5.16.9 by @renovate[bot] in #1294
    • Update module golang.org/x/image to v0.35.0 by @renovate[bot] in #1296
    • Update dependency @astrojs/starlight to v0.37.3 by @renovate[bot] in #1308
    • Update dependency @expressive-code/plugin-collapsible-sections to v0.41.6 by @renovate[bot] in #1309
    • Update dependency @expressive-code/plugin-line-numbers to v0.41.6 by @renovate[bot] in #1310
    • Update astro monorepo by @renovate[bot] in #1313
    • Update module github.com/urfave/cli/v3 to v3.8.0 by @renovate[bot] in #1314
    • Update dependency astro to v5.16.16 by @renovate[bot] in #1319
    • Update module github.com/alecthomas/chroma/v2 to v2.23.1 by @renovate[bot] in #1329
    • Update module github.com/shirou/gopsutil/v4 to v4.26.4 by @renovate[bot] in #1339
    • Update dependency astro to v5.17.1 by @renovate[bot] in #1338
    • Update dependency @expressive-code/plugin-collapsible-sections to v0.41.7 by @renovate[bot] in #1366
    • Update astro monorepo by @renovate[bot] in #1376
    • Update dependency @expressive-code/plugin-line-numbers to v0.41.7 by @renovate[bot] in #1377
    • Update dependency @astrojs/starlight to ^0.38.0 by @renovate[bot] in #1383
    • Bump golang.org/x/image from 0.35.0 to 0.38.0 by @dependabot[bot] in #1389
    • Update dependency @astrojs/starlight to ^0.38.0 by @renovate[bot] in #1394
    • Update dependency @astrojs/sitemap to v3.7.2 by @renovate[bot] in #1395
    • Update dependency starlight-giscus to ^0.9.0 by @renovate[bot] in #1396
    • Update module github.com/pelletier/go-toml/v2 to v2.3.0 by @renovate[bot] in #1400
    • Update module golift.io/xtractr to v0.3.1 by @renovate[bot] in #1401
    • Update module github.com/alecthomas/chroma/v2 to v2.24.0 by @renovate[bot] in #1418
    • Update module github.com/charmbracelet/x/ansi to v0.11.7 by @renovate[bot] in #1426
    • Update module github.com/pelletier/go-toml/v2 to v2.3.1 by @renovate[bot] in #1430
    • Update module github.com/alecthomas/chroma/v2 to v2.24.1 by @renovate[bot] in #1447
    • Update module golang.org/x/text to v0.37.0 by @renovate[bot] in #1450

    Misc

    Full Changelog: v1.5.0...v1.6.0

    Open source →
    Release notes

    2026-06-08

    Update

    • Add configuration options for sidebar section visibility and ordering #1323

    • Add binary architecture detection for ELF, PE, and Mach-O #1328

    • Add —debug-info flag #1332

    • Focus on current directory on navigation to parent directory in a filepanel #1340

    • Add split_file_panel key function #1344

    • Refresh file metadata when focusing metadata panel #1372

    • Add Desktop directory to well-known directories #1386

    • Add support for Postscript files #1399

    • Bubbletea v2 migration #1406

    • Detailed information about delete operation errors for the user #1408

    • Add file type byte to permissions column #1410

    • New website & logo design #1423

    • Add Linux attributes to metadata #1432

    • More informative content of the error text for file text preview #1436

    Bug Fix

    • Resolve Nix build failure #1298

    • Prune Inaccessible Items from clipboard before pasting #1300

    • Correct jump back to parent directories cursor position #1316

    • Move toggleDot files to fileModel and force re render on toggle #1324

    • Update xz to v0.5.15 to enable cross-compile again #1327

    • Prevent crash due to invalid theme #1355

    • Prevent panic from zero-value Renderer usage #1358

    • Remove panic statements in production code #1359

    • Allow natural_sort as sort option #1237

    • Disable interactive commands in shell mode(darwin/linux) #1364

    • Multy-column header misalignment #1362

    • Remove showing two fractional digits of Byte for files with small size #1370

    • Resolve Nix build failure #1373

    • Disable broken Nix check phase #1374

    • Reword —help for fch #1391

    • Unable to select Natural sort #1413

    • Change FormatFileSize to use configured units #1419

    • Thread safe ioReqCnt #1420

    • Files processed in deterministic order #1421

    • Detailed information about paste operation errors for the user #1431

    Optimization

    • Refactor sort Modal to seperate package #1325

    • Refactor helpMenu Modal to seperate package #1335

    • Refactor utils package to pkg #1365

    Documentation

    • Add jetbrains logo #1292

    • Grammar corrections in readme and removed a redundant link in site #1302

    • Add special thanks page #1317

    • Add missing fields to vim like superfile hotkeys #1318

    • Add download badges to README #1404

    • Fix behviour -> behaviour typo in tmux.md #1427

    • Update core contributer #1429

    • Add notice page and fix tutorial page discuss issue #1433

    • Fix broken demo GIF path #1465 by @NouemanKHAL

    Dependencies

    • Update astro monorepo #1313 , #1376

    • Update Astro and Starlight dependencies #1294 , #1308 , #1319 , #1338 , #1383 , #1394

    • Update expressive-code plugins #1309 , #1310 , #1366 , #1377

    • Update website dependencies #1395 , #1396

    • Update Go module dependencies #1296 , #1314 , #1329 , #1339 , #1389 , #1400 , #1401 , #1418 , #1426 , #1430 , #1447 , #1450

    Misc

    • Update tracking code #1301

    • Add sidebar section layout test #1384

    • Fix incomplete test coverage in navigation_test.go #1387

    • Add new workflow for PR auto labeling #1398

    • Fix GitHub auto-labeling workflow #1405

    • Update GitHub Actions workflow triggers and permissions #1424

    • Some tests for modal error message #1435

    • Update workflow configuration #1451

    Open source →
    Release notes

    2026-06-08

    Update

    • Add configuration options for sidebar section visibility and ordering #1323
    • Add binary architecture detection for ELF, PE, and Mach-O #1328
    • Add --debug-info flag #1332
    • Focus on current directory on navigation to parent directory in a filepanel #1340
    • Add split_file_panel key function #1344
    • Refresh file metadata when focusing metadata panel #1372
    • Add Desktop directory to well-known directories #1386
    • Add support for Postscript files #1399
    • Bubbletea v2 migration #1406
    • Detailed information about delete operation errors for the user #1408
    • Add file type byte to permissions column #1410
    • New website & logo design #1423
    • Add Linux attributes to metadata #1432
    • More informative content of the error text for file text preview #1436

    Bug Fix

    • Resolve Nix build failure #1298
    • Prune Inaccessible Items from clipboard before pasting #1300
    • Correct jump back to parent directories cursor position #1316
    • Move toggleDot files to fileModel and force re render on toggle #1324
    • Update xz to v0.5.15 to enable cross-compile again #1327
    • Prevent crash due to invalid theme #1355
    • Prevent panic from zero-value Renderer usage #1358
    • Remove panic statements in production code #1359
    • Allow natural_sort as sort option #1237
    • Disable interactive commands in shell mode(darwin/linux) #1364
    • Multy-column header misalignment #1362
    • Remove showing two fractional digits of Byte for files with small size #1370
    • Resolve Nix build failure #1373
    • Disable broken Nix check phase #1374
    • Reword --help for fch #1391
    • Unable to select Natural sort #1413
    • Change FormatFileSize to use configured units #1419
    • Thread safe ioReqCnt #1420
    • Files processed in deterministic order #1421
    • Detailed information about paste operation errors for the user #1431

    Optimization

    • Refactor sort Modal to seperate package #1325
    • Refactor helpMenu Modal to seperate package #1335
    • Refactor utils package to pkg #1365

    Documentation

    • Add jetbrains logo #1292
    • Grammar corrections in readme and removed a redundant link in site #1302
    • Add special thanks page #1317
    • Add missing fields to vim like superfile hotkeys #1318
    • Add download badges to README #1404
    • Fix behviour -> behaviour typo in tmux.md #1427
    • Update core contributer #1429
    • Add notice page and fix tutorial page discuss issue #1433
    • Fix broken demo GIF path #1465 by @NouemanKHAL

    Dependencies

    Misc

    • Update tracking code #1301
    • Add sidebar section layout test #1384
    • Fix incomplete test coverage in navigation_test.go #1387
    • Add new workflow for PR auto labeling #1398
    • Fix GitHub auto-labeling workflow #1405
    • Update GitHub Actions workflow triggers and permissions #1424
    • Some tests for modal error message #1435
    • Update workflow configuration #1451
    Open source →
  6. v1.6.0-rc1 27 May 2026 pre-release
    Release notes

    How to install the pre-release

    macOS/Linux

    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

    $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, paste, and file text preview #1408, #1431, #1436

    All Changes

    • docs: Add jetbrains logo by @lazysegtree in #1292
    • fix(nix): resolve build failure by @Frost-Phoenix in #1298
    • fix: grammar corrections in readme and removed a redundant link in site by @AnshumanNeon in #1302
    • fix: Prune Inaccessible Items from clipboard before pasting by @lazysegtree in #1300
    • chore: update tracking code by @yorukot in #1301
    • chore(deps): update dependency astro to v5.16.9 by @renovate[bot] in #1294
    • chore(deps): update astro monorepo by @renovate[bot] in #1313
    • chore(deps): update dependency @expressive-code/plugin-line-numbers to v0.41.6 by @renovate[bot] in #1310
    • fix: correct jump back to parent directories cursor position by @padda78 in #1316
    • chore(deps): update dependency @astrojs/starlight to v0.37.3 by @renovate[bot] in #1308
    • chore(deps): update dependency @expressive-code/plugin-collapsible-sections to v0.41.6 by @renovate[bot] in #1309
    • docs: add special thanks page by @yorukot in #1317
    • docs(config): add missing fields to vim like superfile hotkeys by @moriT958 in #1318
    • feat: add configuration options for sidebar section visibility and ordering by @Mjoyufull in #1323
    • fix: Move toggleDot files to fileModel and force re render on toggle by @lazysegtree in #1324
    • feat: Refactor sort Modal to seperate package by @lazysegtree in #1325
    • fix: Update xz to v0.5.15 to enable cross-compile again by @moabeat-berlin in #1327
    • feat(metadata): add binary architecture detection for ELF, PE, and Mach-O by @barsaskn in #1328
    • feat(cmd): add --debug-info flag by @barsaskn in #1332
    • chore(deps): update dependency astro to v5.16.16 by @renovate[bot] in #1319
    • feat: Refactor helpMenu Modal to seperate package by @lazysegtree in #1335
    • feat: Focus on current directory on navigation to parent directory in a filepanel by @xelavopelk in #1340
    • chore(deps): update dependency astro to v5.17.1 by @renovate[bot] in #1338
    • fix: Prevent crash due to invalid theme by @lazysegtree in #1355
    • fix(issue#1262): prevent panic from zero-value Renderer usage by @Simpaqt in #1358
    • fix: Remove panic statements in production code by @lazysegtree in #1359
    • fix: Allow natural_sort as sort option by @majiayu000 in #1237
    • fix: Disable interactive commands in shell mode(darwin/linux) by @lazysegtree in #1364
    • fix: Multy-column header misalignment by @xelavopelk in #1362
    • chore: Refactor utils package to pkg by @lazysegtree in #1365
    • feat: add split_file_panel key function by @robert-zaremba in #1344
    • chore(deps): update dependency @expressive-code/plugin-collapsible-sections to v0.41.7 by @renovate[bot] in #1366
    • fix(deps): update module golang.org/x/image to v0.35.0 by @renovate[bot] in #1296
    • chore(deps): update astro monorepo by @renovate[bot] in #1376
    • fix: removed showing two fractional digits of Byte for files with small size by @xelavopelk in #1370
    • fix(nix): resolve build failure by @Frost-Phoenix in #1373
    • chore(deps): update dependency @expressive-code/plugin-line-numbers to v0.41.7 by @renovate[bot] in #1377
    • feat(sidebar): add Desktop directory to well-known directories by @nil957 in #1386
    • test: add sidebar section layout test by @dsvetoslavov in #1384
    • feat: refresh file metadata when focusing metadata panel by @xelavopelk in #1372
    • fix(help): Reword --help for fch by @booth-w in #1391
    • fix(deps): update dependency @astrojs/starlight to ^0.38.0 by @renovate[bot] in #1383
    • chore(deps): bump golang.org/x/image from 0.35.0 to 0.38.0 by @dependabot[bot] in #1389
    • fix(nix): disable broken check phase by @Frost-Phoenix in #1374
    • chore(deps): update dependency @astrojs/sitemap to v3.7.2 by @renovate[bot] in #1395
    • fix(deps): update dependency starlight-giscus to ^0.9.0 by @renovate[bot] in #1396
    • fix(deps): update module github.com/urfave/cli/v3 to v3.8.0 by @renovate[bot] in #1314
    • fix(deps): update module github.com/alecthomas/chroma/v2 to v2.23.1 by @renovate[bot] in #1329
    • fix(deps): update module github.com/pelletier/go-toml/v2 to v2.3.0 by @renovate[bot] in #1400
    • chore: add new workflow for PR auto labeling by @yorukot in #1398
    • test(zoxide): fix incomplete test coverage in navigation_test.go by @mehexi in #1387
    • fix: fix GitHub auto-labeling workflow by @yorukot in #1405
    • docs: add download badges to README by @lazysegtree in #1404
    • feat(columns): add file type byte to permissions column by @booth-w in #1410
    • fix: Unable to select Natural sort by @xelavopelk in #1413
    • feat: Add support for Postscript files by @jirka-grunt in #1399
    • feat: Bubbletea v2 migration by @lazysegtree in #1406
    • fix: Change FormatFileSize to use configured units by @booth-w in #1419
    • fix(deps): update dependency @astrojs/starlight to ^0.38.0 by @renovate[bot] in #1394
    • feat: Detailed information about delete operation errors for the user. by @xelavopelk in #1408
    • fix: update github actions workflow triggers and permissions by @yorukot in #1424
    • fix: thread safe ioReqCnt by @xelavopelk in #1420
    • fix: files processed in deterministic order by @xelavopelk in #1421
    • feat: new website & logo design by @elvisdragonmao in #1423
    • fix: Detailed information about paste operation errors for the user by @xelavopelk in #1431
    • docs: update core contributer by @elvisdragonmao in #1429
    • docs: add notice page and fix tutorial page discuss issue by @yorukot in #1433
    • fix(deps): update module github.com/alecthomas/chroma/v2 to v2.24.0 by @renovate[bot] in #1418
    • fix: behviour -> behaviour typo in tmux.md by @pikammmmm in #1427
    • feat: add linux attributes to metadata by @xelavopelk in #1432
    • test: some tests for modal error message by @xelavopelk in #1435
    • feat: more informative content of the error text for file text preview by @xelavopelk in #1436
    • fix(deps): update module github.com/alecthomas/chroma/v2 to v2.24.1 by @renovate[bot] in #1447
    • fix(deps): update module github.com/pelletier/go-toml/v2 to v2.3.1 by @renovate[bot] in #1430
    • fix(deps): update module github.com/charmbracelet/x/ansi to v0.11.7 by @renovate[bot] in #1426
    • fix(deps): update module github.com/shirou/gopsutil/v4 to v4.26.4 by @renovate[bot] in #1339
    • fix(deps): update module golang.org/x/text to v0.37.0 by @renovate[bot] in #1450
    • fix(deps): update module golift.io/xtractr to v0.3.1 by @renovate[bot] in #1401
    • ci: update workflow configuration by @yorukot in #1451
    • chore: release v1.6.0-rc1 by @yorukot in #1453

    New Contributors

    Full Changelog: v1.5.0...v1.6.0-rc1

    Open source →
  7. v1.5.1-0.20260323104020-c882796ebc89 23 Mar 2026 pre-release

    Nothing published for this version

  8. v1.5.1-0.20260113032550-7960ce7e545c 13 Jan 2026 pre-release

    Nothing published for this version

  9. v1.5.0 12 Jan 2026
    Release notes

    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

    Highlights

    • Added video and PDF preview support via loading the first frame/page as an image. Thanks @Yassen-Higazi for the implementation
    Screenshots

    • Multi-column file panel view with date/size/permission columns. Thanks @xelavopelk for the implementation
    Screenshots

    • Configurable fast navigation in the Filepanel. See this PR for more details: #1220
    • You can now configure spf to open files with specific extensions with your choice of editor application. Thanks @litvinov-git for the implementation See this PR for more details: #1197
    • Terminal stdout support for shell commands
    • Allow launching with the filename. spf /a/b/c.txt will launch in /a/b with c.txt as the selected file.
    • Various bug fixes, including modal confirmations, layout issues, and race conditions. See 'Detailed Change Summary'

    Internal Updates

    • Separated FilePanel and FileModel into a dedicated package for better code organization
    • Comprehensive end-to-end testing with layout fixes
    • Enhanced dimension validation and sidebar fixes
    • Updated multiple dependencies including Astro, Go toolchain, and linters
    • Added gosec linter and MND linter with magic number cleanup

    Detailed Change Summary

    Details

    Update

    Bug Fix

    Optimization

    Documentation

    Dependencies

    Misc

    New Contributors

    Full Changelog: v1.4.0...v1.5.0

    Open source →
    Release notes

    2026-01-11

    Update

    • allow hover to file #1177

    • show count selected items in select mode #1187

    • Add icon alias for kts to kt #1153

    • link icon and metadata #1171

    • user configuration of editors by file extension #1197

    • add video preview support #1178

    • Add pdf preview support #1198

    • Add icons in pinned directories #1215

    • Enable fast configurable navigation #1220

    • add Trash bin to default directories for Linux #1236

    • add terminal stdout support for shell commands #1250

    • More columns in file panel (MVP) #1268

    Bug Fix

    • only calculate checksum on files #1119

    • Linter issue with PrintfAndExit #1133

    • Remove repeated os.ReadDir calls #1155

    • Disable COPYFILE in macOS #1194

    • add missing hotkeys to help menu #1192

    • Fetch latest version automatically #1127

    • Use async methods to prevent test race conditions #1201

    • update metadata and process bar sizes when toggling footer #1218

    • File panel dimension management #1222

    • Layout fixes with full end-to-end tests #1227

    • Fix flaky tests #1233

    • modal confirmation bug with arrow keys #1243

    • small file panel optimization #1241

    • use ExtractOperationMsg for extraction #1248

    • skip open_with from missing field validation #1251

    • border height validation fixes #1267

    • fix case with two active panes #1271

    • help model formatting #1277

    Optimization

    • simplify renameIfDuplicate logic #1100

    • separate FilePanel into dedicated package #1195

    • File model separation #1223

    • Dimension validations #1224

    • layout validation and sidebar dimension fixes #1228

    • user rendering package and removal of unused preview code #1245

    • user rendering package for file preview #1249

    Documentation

    • update Fish shell setup docs #1142

    • fix macOS typo #1212

    • stylistic and linguistic cleanup of config documentation #1184

    Dependencies

    • update astro monorepo #1010

    • update starlight-giscus #1020

    • bump astro versions #1138 , #1157 , #1158

    • bump vite #1134

    • update setup-go action #1038

    • update expressive-code plugins #1189 , #1246

    • update sharp #1256

    • update fontsource monorepo #1257

    • update urfave/cli #1136 , #1190

    • update astro / starlight / ansi / toolchain deps #1275 , #1278 , #1280

    • update python and go versions #1276 , #1191

    • update golangci-lint action #1286

    Misc

    • update CI input names #1120

    • Everforest Dark Hard theme #1114

    • migrate tutorial demo assets to local #1140

    • new logo asset #1145

    • mirror repository to codeberg #1141

    • sync package lock #1143

    • bump golangci-lint version #1135

    • add gosec linter #1185

    • enable MND linter and clean magic numbers #1180

    • skip permission tests when running as root #1186

    • release v1.4.1-rc #1203

    • 1.5.0-rc1 housekeeping changes #1264

    Open source →
    Release notes

    2026-01-11

    Update

    • allow hover to file #1177
    • show count selected items in select mode #1187
    • Add icon alias for kts to kt #1153
    • link icon and metadata #1171
    • user configuration of editors by file extension #1197
    • add video preview support #1178
    • Add pdf preview support #1198
    • Add icons in pinned directories #1215
    • Enable fast configurable navigation #1220
    • add Trash bin to default directories for Linux #1236
    • add terminal stdout support for shell commands #1250
    • More columns in file panel (MVP) #1268

    Bug Fix

    • only calculate checksum on files #1119
    • Linter issue with PrintfAndExit #1133
    • Remove repeated os.ReadDir calls #1155
    • Disable COPYFILE in macOS #1194
    • add missing hotkeys to help menu #1192
    • Fetch latest version automatically #1127
    • Use async methods to prevent test race conditions #1201
    • update metadata and process bar sizes when toggling footer #1218
    • File panel dimension management #1222
    • Layout fixes with full end-to-end tests #1227
    • Fix flaky tests #1233
    • modal confirmation bug with arrow keys #1243
    • small file panel optimization #1241
    • use ExtractOperationMsg for extraction #1248
    • skip open_with from missing field validation #1251
    • border height validation fixes #1267
    • fix case with two active panes #1271
    • help model formatting #1277

    Optimization

    • simplify renameIfDuplicate logic #1100
    • separate FilePanel into dedicated package #1195
    • File model separation #1223
    • Dimension validations #1224
    • layout validation and sidebar dimension fixes #1228
    • user rendering package and removal of unused preview code #1245
    • user rendering package for file preview #1249

    Documentation

    • update Fish shell setup docs #1142
    • fix macOS typo #1212
    • stylistic and linguistic cleanup of config documentation #1184

    Dependencies

    Misc

    • update CI input names #1120
    • Everforest Dark Hard theme #1114
    • migrate tutorial demo assets to local #1140
    • new logo asset #1145
    • mirror repository to codeberg #1141
    • sync package lock #1143
    • bump golangci-lint version #1135
    • add gosec linter #1185
    • enable MND linter and clean magic numbers #1180
    • skip permission tests when running as root #1186
    • release v1.4.1-rc #1203
    • 1.5.0-rc1 housekeeping changes #1264
    Open source →
  10. v1.5.0-rc1 03 Jan 2026 pre-release
    Release notes

    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
    • Terminal stdout support for shell commands, enabling direct output display.
    • Trash bin added to default directories on Linux.
    • Allow the preview panel to have borders.

    Internal Improvements

    • Major layout and dimension system overhaul, including sidebar, footer, file panel, preview border, and process bar behavior.
    • Introduction of layout and dimension validations and additional tests to prevent invalid UI states.
    • File model separation and rendering refactor, simplifying preview and file handling logic.
    • Some flaky unit tests fixed, improving CI reliability.

    All changes

    New Contributors

    Full Changelog: v1.4.1-rc...v1.5.0-rc1

    Open source →
  11. v1.4.1-rc 21 Dec 2025 pre-release
    Release notes

    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

    Change details

    New Contributors

    Full Changelog: v1.4.0...v1.4.1-rc

    Open source →
  12. v1.4.1-0.20251120045254-fd2abeed4e58 20 Nov 2025 pre-release

    Nothing published for this version

  13. v1.4.1-0.20251111050155-575155bb1417 11 Nov 2025 pre-release

    Nothing published for this version

  14. v1.4.1-0.20251031014446-b933b45e9da3 31 Oct 2025 pre-release

    Nothing published for this version

  15. v1.4.1-0.20251026030243-a1c087c4b6cf 26 Oct 2025 pre-release

    Nothing published for this version

  16. v1.4.0 10 Oct 2025
    Release notes

    Hey folks. Releasing v1.4.0 with many new features, improvements, and bug fixes.

    We have an async file preview now, a zoxide panel, and various new features improving UX.

    Install:

    Click me to know how to install

    Highlights

    • We have the Zoxide Panel now. Ensure zoxide is installed on your system, set zoxide_support to true in the config, and press z to use zoxide.

    • File previewing is now async, meaning reduced lag while scrolling through images, or on slow systems.

    • Many bug fixes. See 'Detailed Change Summary'

    Internal Updates

    • Most file operations are now truly async with the usage of the recommended tea.Cmd pattern.
    • Enabled many new linters to improve code quality.
    • Moved golangci-lint to v2. Now developers don't need to keep the old v1 in their systems.
    • Refactored file preview in its own package for better maintainability and readability.
    • Fixed flaky unit tests.

    Detailed Change Summary

    Details

    Update

    Bug Fix

    • fix: sorting in searchbar #985 by @hupender
    • fix: Async rendering, Include clipboard check in paste items, and update linter configs #997 by @lazysegtree
    • fix: Move utility functions to utils package #1012 by @lazysegtree
    • fix: Refactoring and separation of preview panel and searchbar in help menu #1013 by @lazysegtree
    • fix(filePanel): allow focusType to be set correctly #1033 by @faisal-990
    • fix(ci): Update gomod2nix.toml, allow pre release in version output, release 1.4.0-rc1, bug fixes, and improvements #1054 by @lazysegtree
    • fix(nix): resolve build failures in the nix flake #1068 by @Frost-Phoenix
    • fix: Retry the file deletion to prevent flakies (#938) #1076 by @lazysegtree
    • fix(issue-1066): Fixed issue where enter was not searchable #1078 by @Simpaqt
    • fix(#1073): Tech debt fix #1077 by @Simpaqt
    • fix: fix deleted directory not able to remove from pins (#1067) #1081 by @yorukot
    • fix: fix child process spawning attached #1084 by @guemidiborhane
    • fix: always clear images when showing a FullScreenStyle #1094 by @snikoletopoulos
    • fix: Allow j and k keys in zoxide #1102 by @lazysegtree
    • fix: Zoxide improvements and 1.4.0-rc2 #1105 by @lazysegtree
    • fix: rename cursor beginning on wrong character because of multiple dots in name (#813) #1112 by @SyedAsadK
    • fix: check and fix file panel scroll position on height changes #1095 by @snikoletopoulos

    Optimization

    • perf(website): optimize font loading and asset organization #1089 by @yorukot

    Documentation

    • docs: fix incorrect zoxide plugin config name #1049 by @shree-xvi
    • docs(hotkeys): Fix typo in vimHotkeys.toml comments #1080 by @wleoncio
    • docs: add section for core maintainers in README.md #1088 by @yorukot
    • chore: add winget install instruction to readme and website #943 by @claykom

    Dependencies

    • chore(deps): update dependency go to v1.25.0, golangci-lint to v2, golangci-lint actions to v8 #750 by @renovate[bot]
    • chore(deps): update amannn/action-semantic-pull-request action to v6 #1006 by @renovate[bot]
    • chore(deps): update actions/first-interaction action to v3 #1005 by @renovate[bot]
    • chore(deps): update actions/checkout action to v5 #1004 by @renovate[bot]
    • chore(deps): bump astro from 5.10.1 to 5.12.8 #982 by @dependabot[bot]
    • fix(deps): update module golang.org/x/mod to v0.27.0 #989 by @renovate[bot]
    • fix(deps): update dependency @expressive-code/plugin-collapsible-sections to v0.41.3 #990 by @renovate[bot]
    • fix(deps): update dependency sharp to v0.34.3 #992 by @renovate[bot]
    • fix(deps): update dependency @expressive-code/plugin-line-numbers to v0.41.3 #991 by @renovate[bot]
    • chore(deps): update dependency go to v1.25.0 #994 by @renovate[bot]
    • fix(deps): update astro monorepo #995 by @renovate[bot]
    • fix(deps): update dependency @astrojs/starlight to ^0.35.0 #1000 by @renovate[bot]
    • fix(deps): update module github.com/urfave/cli/v3 to v3.4.1 #1001 by @renovate[bot]
    • fix(deps): update module golang.org/x/text to v0.28.0 #1003 by @renovate[bot]

    Misc

    • chore: migrate from superfile.netlify.app to superfile.dev #1087 by @yorukot
    • refactor(filepanel): replace filePanelFocusType with isFocused boolean #1040 by @faisal-990
    • refactor(ansi): Migrate from github.com/charmbracelet/x/exp/term/ansi to github.com/charmbracelet/x/ansi #1044 by @faisal-990
    • refactor: common operation on pinned directory file using PinnedManager #1085 by @Manaswa-S
    • test: unit tests for pinned manager #1090 by @Manaswa-S

    New Contributors

    Full Changelog: v1.3.3...v1.4.0

    Open source →
    Release notes

    How to install the pre-release

    MacOS/Linux

    SPF_INSTALL_VERSION=1.4.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.4.0-rc1; Invoke-Expression ((New-Object System.Net.WebClient).DownloadString('https://superfile.netlify.app/install.ps1'))"
    

    What's Changed

    Summary

    • Added zoxide plugin
    • Made file preview async to remove lag while scrolling
    • Search functionality in the help menu
    • Add an option to permanently delete
    • Fix a few bugs and other internal improvements

    Details

    • chore: add winget install instruction to readme and website by @claykom in #943
    • feat: File operation via tea cmd by @lazysegtree in #963
    • feat: processbar improvements, package separation, better channel management by @lazysegtree in #970
    • feat: processbar improvements, package separation, better channel management by @lazysegtree in #973
    • feat: enable lll and recvcheck linter, fix tests, more refactors by @lazysegtree in #977
    • feat: Remove channel for notification models by @lazysegtree in #979
    • feat: enable cyclop, funlen, gocognit, gocyclo linters, and refactor large functions by @lazysegtree in #984
    • fix: sorting in searchbar by @hupender in #985
    • feat: Add a new hotkey to handle cd-on-quit whenever needed by @ahmed-habbachi in #924
    • feat: added option to permanently delete files by @hupender in #987
    • chore(deps): bump astro from 5.10.1 to 5.12.8 in /website by @dependabot[bot] in #982
    • fix(deps): update module golang.org/x/mod to v0.27.0 by @renovate[bot] in #989
    • fix(deps): update dependency @expressive-code/plugin-collapsible-sections to v0.41.3 by @renovate[bot] in #990
    • chore(deps): update dependency go to v1.25.0, golangci-lint to v2, golangci-lint actions to v8 by @renovate[bot] in #750
    • fix(deps): update dependency sharp to v0.34.3 by @renovate[bot] in #992
    • fix(deps): update dependency @expressive-code/plugin-line-numbers to v0.41.3 by @renovate[bot] in #991
    • chore(deps): update dependency go to v1.25.0 by @renovate[bot] in #994
    • fix(deps): update astro monorepo by @renovate[bot] in #995
    • fix(deps): update dependency @astrojs/starlight to ^0.35.0 by @renovate[bot] in #1000
    • fix(deps): update module github.com/urfave/cli/v3 to v3.4.1 by @renovate[bot] in #1001
    • chore(deps): update amannn/action-semantic-pull-request action to v6 by @renovate[bot] in #1006
    • chore(deps): update actions/first-interaction action to v3 by @renovate[bot] in #1005
    • chore(deps): update actions/checkout action to v5 by @renovate[bot] in #1004
    • fix(deps): update module golang.org/x/text to v0.28.0 by @renovate[bot] in #1003
    • fix: Async rendering, Include clipboard check in paste items, and update linter configs by @lazysegtree in #997
    • fix: Move utility functions to utils package by @lazysegtree in #1012
    • feat: Preview panel seperation by @lazysegtree in #1021
    • feat: Add search functionality to help menu (#1009) by @iZarrios in #1011
    • fix: Refactoring and separation of preview panel and searchbar in help menu by @lazysegtree in #1013
    • fix(filePanel): allow focusType to be set correctly by @faisal-990 in #1033
    • feat: Use zoxide lib by @lazysegtree in #1036
    • feat: Add zoxide directory tracking on navigation by @lazysegtree in #1041
    • feat: Zoxide integeration by @lazysegtree in #1039
    • docs: fix incorrect zoxide plugin config name by @shree-xvi in #1049
    • refactor(filepanel): replace filePanelFocusType with isFocused boolean by @faisal-990 in #1040
    • refactor(ansi): Migrate from github.com/charmbracelet/x/exp/term/ansi to github.com/charmbracelet/x/ansi by @faisal-990 in #1044

    New Contributors

    Full Changelog: v1.3.3...v1.4.0-rc1

    Open source →
    Release notes

    2025-10-10

    Update

    • feat: File operation via tea cmd by #963

    • feat: processbar improvements, package separation, better channel management by #970

    • feat: processbar improvements, package separation, better channel management by #973

    • feat: enable lll and recvcheck linter, fix tests, more refactors by #977

    • feat: Remove channel for notification models by #979

    • feat: enable cyclop, funlen, gocognit, gocyclo linters, and refactor large functions by #984

    • feat: Add a new hotkey to handle cd-on-quit whenever needed by #924

    • feat: added option to permanently delete files by #987

    • feat: Preview panel separation by #1021

    • feat: Add search functionality to help menu by #1011

    • feat: Use zoxide lib by #1036

    • feat: Add zoxide directory tracking on navigation by #1041

    • feat: Zoxide integration by #1039

    • feat: Select mode with better feedback by #1074

    • feat: owner/group in the metadata by #1093

    • feat: Async zoxide by #1104

    Bug Fix

    • fix: sorting in searchbar by #985

    • fix: Async rendering, Include clipboard check in paste items, and update linter configs by #997

    • fix: Move utility functions to utils package by #1012

    • fix: Refactoring and separation of preview panel and searchbar in help menu by #1013

    • fix(filePanel): allow focusType to be set correctly by #1033

    • fix(ci): Update gomod2nix.toml, allow pre release in version output, release 1.4.0-rc1, bug fixes, and improvements by #1054

    • fix(nix): resolve build failures in the nix flake by #1068

    • fix: Retry the file deletion to prevent flakies (#938) by #1076

    • fix(issue-1066): Fixed issue where enter was not searchable by #1078

    • fix(#1073): Tech debt fix by #1077

    • fix: fix deleted directory not able to remove from pins (#1067) by #1081

    • fix: fix child process spawning attached by #1084

    • fix: always clear images when showing a FullScreenStyle by #1094

    • fix: Allow j and k keys in zoxide by #1102

    • fix: Zoxide improvements and 1.4.0-rc2 by #1105

    • fix: rename cursor beginning on wrong character because of multiple dots in name (#813) by #1112

    • fix: check and fix file panel scroll position on height changes by #1095

    Optimization

    • perf(website): optimize font loading and asset organization by #1089

    Documentation

    • docs: fix incorrect zoxide plugin config name by #1049

    • docs(hotkeys): Fix typo in vimHotkeys.toml comments by #1080

    • docs: add section for core maintainers in README.md by #1088

    • chore: add winget install instruction to readme and website by #943

    Dependencies

    • chore(deps): update dependency go to v1.25.0, golangci-lint to v2, golangci-lint actions to v8 by #750

    • chore(deps): update amannn/action-semantic-pull-request action to v6 by #1006

    • chore(deps): update actions/first-interaction action to v3 by #1005

    • chore(deps): update actions/checkout action to v5 by #1004

    • chore(deps): bump astro from 5.10.1 to 5.12.8 by #982

    • fix(deps): update module golang.org/x/mod to v0.27.0 by #989

    • fix(deps): update dependency @expressive-code/plugin-collapsible-sections to v0.41.3 by #990

    • fix(deps): update dependency sharp to v0.34.3 by #992

    • fix(deps): update dependency @expressive-code/plugin-line-numbers to v0.41.3 by #991

    • chore(deps): update dependency go to v1.25.0 by #994

    • fix(deps): update astro monorepo by #995

    • fix(deps): update dependency @astrojs/starlight to ^0.35.0 by #1000

    • fix(deps): update module github.com/urfave/cli/v3 to v3.4.1 by #1001

    • fix(deps): update module golang.org/x/text to v0.28.0 by #1003

    Misc

    • chore: migrate from superfile.netlify.app to superfile.dev by #1087

    • refactor(filepanel): replace filePanelFocusType with isFocused boolean by #1040

    • refactor(ansi): Migrate from github.com/charmbracelet/x/exp/term/ansi to github.com/charmbracelet/x/ansi by #1044

    • refactor: common operation on pinned directory file using PinnedManager by #1085

    • test: unit tests for pinned manager by #1090

    Open source →
    Release notes

    2025-10-10

    Update

    • feat: File operation via tea cmd by #963
    • feat: processbar improvements, package separation, better channel management by #970
    • feat: processbar improvements, package separation, better channel management by #973
    • feat: enable lll and recvcheck linter, fix tests, more refactors by #977
    • feat: Remove channel for notification models by #979
    • feat: enable cyclop, funlen, gocognit, gocyclo linters, and refactor large functions by #984
    • feat: Add a new hotkey to handle cd-on-quit whenever needed by #924
    • feat: added option to permanently delete files by #987
    • feat: Preview panel separation by #1021
    • feat: Add search functionality to help menu by #1011
    • feat: Use zoxide lib by #1036
    • feat: Add zoxide directory tracking on navigation by #1041
    • feat: Zoxide integration by #1039
    • feat: Select mode with better feedback by #1074
    • feat: owner/group in the metadata by #1093
    • feat: Async zoxide by #1104

    Bug Fix

    • fix: sorting in searchbar by #985
    • fix: Async rendering, Include clipboard check in paste items, and update linter configs by #997
    • fix: Move utility functions to utils package by #1012
    • fix: Refactoring and separation of preview panel and searchbar in help menu by #1013
    • fix(filePanel): allow focusType to be set correctly by #1033
    • fix(ci): Update gomod2nix.toml, allow pre release in version output, release 1.4.0-rc1, bug fixes, and improvements by #1054
    • fix(nix): resolve build failures in the nix flake by #1068
    • fix: Retry the file deletion to prevent flakies (#938) by #1076
    • fix(issue-1066): Fixed issue where enter was not searchable by #1078
    • fix(#1073): Tech debt fix by #1077
    • fix: fix deleted directory not able to remove from pins (#1067) by #1081
    • fix: fix child process spawning attached by #1084
    • fix: always clear images when showing a FullScreenStyle by #1094
    • fix: Allow j and k keys in zoxide by #1102
    • fix: Zoxide improvements and 1.4.0-rc2 by #1105
    • fix: rename cursor beginning on wrong character because of multiple dots in name (#813) by #1112
    • fix: check and fix file panel scroll position on height changes by #1095

    Optimization

    • perf(website): optimize font loading and asset organization by #1089

    Documentation

    • docs: fix incorrect zoxide plugin config name by #1049
    • docs(hotkeys): Fix typo in vimHotkeys.toml comments by #1080
    • docs: add section for core maintainers in README.md by #1088
    • chore: add winget install instruction to readme and website by #943

    Dependencies

    • chore(deps): update dependency go to v1.25.0, golangci-lint to v2, golangci-lint actions to v8 by #750
    • chore(deps): update amannn/action-semantic-pull-request action to v6 by #1006
    • chore(deps): update actions/first-interaction action to v3 by #1005
    • chore(deps): update actions/checkout action to v5 by #1004
    • chore(deps): bump astro from 5.10.1 to 5.12.8 by #982
    • fix(deps): update module golang.org/x/mod to v0.27.0 by #989
    • fix(deps): update dependency @expressive-code/plugin-collapsible-sections to v0.41.3 by #990
    • fix(deps): update dependency sharp to v0.34.3 by #992
    • fix(deps): update dependency @expressive-code/plugin-line-numbers to v0.41.3 by #991
    • chore(deps): update dependency go to v1.25.0 by #994
    • fix(deps): update astro monorepo by #995
    • fix(deps): update dependency @astrojs/starlight to ^0.35.0 by #1000
    • fix(deps): update module github.com/urfave/cli/v3 to v3.4.1 by #1001
    • fix(deps): update module golang.org/x/text to v0.28.0 by #1003

    Misc

    • chore: migrate from superfile.netlify.app to superfile.dev by #1087
    • refactor(filepanel): replace filePanelFocusType with isFocused boolean by #1040
    • refactor(ansi): Migrate from github.com/charmbracelet/x/exp/term/ansi to github.com/charmbracelet/x/ansi by #1044
    • refactor: common operation on pinned directory file using PinnedManager by #1085
    • test: unit tests for pinned manager by #1090
    Open source →
  17. v1.4.0-rc2 04 Oct 2025 pre-release
    Release notes

    How to install the pre-release

    MacOS/Linux

    SPF_INSTALL_VERSION=1.4.0-rc2 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.0-rc2; Invoke-Expression ((New-Object System.Net.WebClient).DownloadString('https://superfile.netlify.app/install.ps1'))"
    

    Note - You could also build it from source. Refer to the README file in the repository for more information.

    What's Changed from 1.4.0-rc1 to 1.4.0-rc2

    Summary

    • Improved the beta zoxide panel with bug fixes and an async mechanism.
    • Optimized website font loading
    • Enhanced select mode with better user feedback and visual indicators
    • Fixed enter key searchability issues and
    • Resolved issues with deleted directories in pins and improved pinned directory operations with the new PinnedManager
    • Fixed Nix build failures, child process spawning issues, and image clearing problems in full-screen mode

    Details

    New Contributors

    Full Changelog: v1.4.0-rc1...v1.4.0-rc2

    Open source →
  18. v1.4.0-rc1.0.20250913135953-a07eac0308cf 13 Sep 2025 pre-release

    Nothing published for this version

  19. v1.4.0-rc1 11 Sep 2025 pre-release

    Nothing published for this version

  20. v1.3.4-0.20250905074714-51a71f25abee 05 Sep 2025 pre-release

    Nothing published for this version

  21. v1.3.4-0.20250831091344-982d5a66a860 31 Aug 2025 pre-release

    Nothing published for this version

  22. v1.3.4-0.20250726035831-1b8a08d11cec 26 Jul 2025 pre-release

    Nothing published for this version

  23. v1.3.3 24 Jul 2025
    Release notes

    Hey folks. Releasing v1.3.3 with bug fix related to config file, and improvements in metadata panel feature.

    Install:

    Click me to know how to install

    Highlights

    • Fixed a bug in config file correction that would make config file invalid. Thanks @estebandpena for reporting the issue, and @wassup05 for the fix.

    Detailed Change Summary

    Details

    Update

    • feat: Metadata loading via bubbletea's tea.Cmd method, removed usage channels and custom goroutines #947 by @lazysegtree
    • feat: Metadata panel into separate package, UI bug fixes, Code improvements #950 by @lazysegtree
    • feat: add support for Python virtual environment in testsuite setup #956 by @Khitoshi

    Bug fix

    Full Changelog: v1.3.2...v1.3.3

    Open source →
    Release notes

    2025-07-25

    Update

    • feat: Metadata loading via bubbletea’s tea.Cmd method, removed usage channels and custom goroutines by #947

    • feat: Metadata panel into separate package, UI bug fixes, Code improvements #950

    Bug Fix

    • fix: windows test ci by #941

    • fix: fixing config.toml by #952

    Misc

    • chore: update pnpm-lcok.yaml by #937

    • feat: add support for Python virtual environment in testsuite setup #956

    Open source →
    Release notes

    2025-07-25

    Update

    • feat: Metadata loading via bubbletea's tea.Cmd method, removed usage channels and custom goroutines by #947
    • feat: Metadata panel into separate package, UI bug fixes, Code improvements#950

    Bug Fix

    • fix: windows test ci by #941
    • fix: fixing config.toml by #952

    Misc

    • chore: update pnpm-lcok.yaml by #937
    • feat: add support for Python virtual environment in testsuite setup#956
    Open source →
  24. v1.3.3-0.20250716164914-0dd32e7e9337 16 Jul 2025 pre-release

    Nothing published for this version

  25. v1.3.2 16 Jul 2025
    Release notes

    Hey folks. Releasing v1.3.2 with multiple new features including implementation image preview using kitty protocol, and various bug fixes and internal improvements.

    You can now preview images in high quality — no more pixelation!

    Install:

    Click me to know how to install

    Highlights

    Developer Improvements

    • Added CI Action to run unit tests and build for windows.
    • Updated contribution guidelines and PR template
    • Added a dev.sh script for building, linting and running tests for faster development workflows.

    Detailed Change Summary

    Details

    Update

    Bug fix

    Optimization

    • Metadata and filepanel rendering refactor #867 by @JassonCordones
    • refactor: simplify panel mode handling in file movement logic #907 by @yorukot
    • refactor: standardize TODO comments and ReadMe to README #913 by @yorukot

    Documentation

    • enhance: add detailed documentation for InitIcon function and update … #879 by @yorukot
    • docs: add documentation for image preview #882 by @yorukot
    • docs: update contributing guide and PR template #885 by @yorukot
    • docs: update README and plugin documentation for clarity and structure #902 by @yorukot
    • feat(docs): Update arch install package docs #929 by @booth-w

    CI/CD

    • ci: add PR title linting with semantic-pull-request action #884 by @yorukot
    • ci: improve PR workflows with contributor greeting and title linter fix #886 by @yorukot

    Dependencies

    • build(deps): bump prismjs from 1.29.0 to 1.30.0 in /website #786 by @dependabot[bot]
    • fix(deps): update dependency astro to v5.8.0 #787 by @renovate[bot]
    • chore(deps): bump vite from 6.3.3 to 6.3.5 in /website #822 by @dependabot[bot]
    • fix(deps): update dependency sharp to v0.34.2 #909 by @renovate[bot]
    • fix(deps): update astro monorepo #894 by @renovate[bot]
    • fix(deps): update fontsource monorepo to v5.2.6 #910 by @renovate[bot]

    Misc

    • chore(license): update copyright year #895 by @yorukot
    • feat: add ignore missing field flag #881 by @claykom
    • feat: add sitemap integration and update giscus input position #912 by @yorukot

    New Contributors

    Full Changelog: v1.3.1...v1.3.2

    Open source →
    Release notes

    2025-07-16

    Update

    • Normalize user-facing naming to superfile #880

    • Add kitty protocol for image preview #841

    • feat: add Zoxide support for path resolution in initial configuration #892

    • feat: update superfile’s help output #908

    • feat: Add Action to Publish to Winget #925

    • feat: update superfile build test for the windows and macOS #922

    • Compress all files selected #821

    • Theme: add 0x96f theme #860

    Bug fix

    • fix: outdated and broken nix flake #846

    • fix: handle UTF-8 BOM in file reader #865

    • fix icon displayed on spf prompt when nerdfont disabled #878

    • fix: create item check for dot-entries #817

    • fix: prevent pasting a directory into itself, avoiding infinite loop #887

    • fix: clear search bar value on parent directory reset #906

    • fix: enhance terminal pixel detection and response handling #904

    • fix: Cannot Build superfile on Windows #921

    • fix: Improve command tokenization to handle quotes and escapes #931

    • fix: Dont read special files, and prevent freeze #932

    Optimization

    • Metadata and filepanel rendering refactor #867

    • refactor: simplify panel mode handling in file movement logic #907

    • refactor: standardize TODO comments and ReadMe to README #913

    Documentation

    • enhance: add detailed documentation for InitIcon function and update … #879

    • docs: add documentation for image preview #882

    • docs: update contributing guide and PR template #885

    • docs: update README and plugin documentation for clarity and structure #902

    • feat(docs): Update arch install package docs #929

    CI/CD

    • ci: add PR title linting with semantic-pull-request action #884

    • ci: improve PR workflows with contributor greeting and title linter fix #886

    Dependencies

    • build(deps): bump prismjs from 1.29.0 to 1.30.0 in /website #786

    • fix(deps): update dependency astro to v5.8.0 #787

    • chore(deps): bump vite from 6.3.3 to 6.3.5 in /website #822

    • fix(deps): update dependency sharp to v0.34.2 #909

    • fix(deps): update astro monorepo #894

    • fix(deps): update fontsource monorepo to v5.2.6 #910

    Misc

    • chore(license): update copyright year #895

    • feat: add ignore missing field flag #881

    • feat: add sitemap integration and update giscus input position #912

    Open source →
    Release notes

    2025-07-16

    Update

    • Normalize user-facing naming to superfile #880
    • Add kitty protocol for image preview #841
    • feat: add Zoxide support for path resolution in initial configuration #892
    • feat: update superfile's help output #908
    • feat: Add Action to Publish to Winget #925
    • feat: update superfile build test for the windows and macOS #922
    • Compress all files selected #821
    • Theme: add 0x96f theme #860

    Bug fix

    • fix: outdated and broken nix flake #846
    • fix: handle UTF-8 BOM in file reader #865
    • fix icon displayed on spf prompt when nerdfont disabled #878
    • fix: create item check for dot-entries #817
    • fix: prevent pasting a directory into itself, avoiding infinite loop #887
    • fix: clear search bar value on parent directory reset #906
    • fix: enhance terminal pixel detection and response handling #904
    • fix: Cannot Build superfile on Windows #921
    • fix: Improve command tokenization to handle quotes and escapes #931
    • fix: Dont read special files, and prevent freeze #932

    Optimization

    • Metadata and filepanel rendering refactor #867
    • refactor: simplify panel mode handling in file movement logic #907
    • refactor: standardize TODO comments and ReadMe to README #913

    Documentation

    • enhance: add detailed documentation for InitIcon function and update … #879
    • docs: add documentation for image preview #882
    • docs: update contributing guide and PR template #885
    • docs: update README and plugin documentation for clarity and structure #902
    • feat(docs): Update arch install package docs #929

    CI/CD

    • ci: add PR title linting with semantic-pull-request action #884
    • ci: improve PR workflows with contributor greeting and title linter fix #886

    Dependencies

    • build(deps): bump prismjs from 1.29.0 to 1.30.0 in /website #786
    • fix(deps): update dependency astro to v5.8.0 #787
    • chore(deps): bump vite from 6.3.3 to 6.3.5 in /website #822
    • fix(deps): update dependency sharp to v0.34.2 #909
    • fix(deps): update astro monorepo #894
    • fix(deps): update fontsource monorepo to v5.2.6 #910

    Misc

    • chore(license): update copyright year #895
    • feat: add ignore missing field flag #881
    • feat: add sitemap integration and update giscus input position #912
    Open source →
  26. v1.3.2-0.20250614143147-5d8a841cf855 14 Jun 2025 pre-release

    Nothing published for this version

  27. v1.3.2-0.20250612084506-14f551e9f2ee 12 Jun 2025 pre-release

    Nothing published for this version

  28. v1.3.2-0.20250529015935-238d8dcd090f 29 May 2025 pre-release

    Nothing published for this version

  29. v1.3.1 25 May 2025
    Release notes

    2025-05-27

    Update

    • Replace custom giscus implementation with official starlight-giscus plugin #843

    • Add ‘Type’ option for sorting by file extension with fallback #829

    Bug Fixes

    • Correct icons for clipboard files #845

    • Replace mattn/rundwidth with ansi package for more robust StringWidth #848

    • Purego package update #837

    Optimization

    • Update main.go #839
    Open source →
    Release notes

    2025-05-27

    Update

    • Replace custom giscus implementation with official starlight-giscus plugin #843
    • Add 'Type' option for sorting by file extension with fallback #829

    Bug Fixes

    • Correct icons for clipboard files #845
    • Replace mattn/rundwidth with ansi package for more robust StringWidth #848
    • Purego package update #837

    Optimization

    • Update main.go #839
    Open source →
  30. v1.3.0 22 May 2025
    Release notes

    2025-05-22

    Update

    • Added a Command-Prompt for SuperFile specific actions #752

    • Allow specifying multiple panels at startup #759

    • Initial draft of rendering package #775

    • Render unit tests for prompt model #809

    • Chooser file option, —lastdir-file option, and improvements in quit, and bug fixes #812

    • Prompt feature leftover items #804

    • SPF Prompt tutorial and fixes #814

    • Write prompt tutorial, rename prompt mode to spf mode, add develop branch in GitHub workflow, show_panel_footer_info flag #815

    • Theme: Add gruvbox-dark-hard #828

    • Sidebar separation #767

    • Sidebar code separation #770

    • Rendering package and rendering bug fixes #781

    • Refactor CheckForUpdates #797

    • Rename metadata strings #731

    Bug Fixes

    • Fix crash with opening file with editor on an empty panel #730

    • Fix: Add some of the remaining linter and fix errors #756

    • Golangci lint fixes #757

    • Fix: Remove redundant function containsKey #765

    • Fix: Correctly resolve path in open and cd prompt actions #802

    • Prompt dynamic dimensions and unit tests fix #805

    • Fix: Convert unicode space to normal space, use rendered in file preview to fix layout bugs, Release 1.3.0 #825

    Optimization

    • Adding linter to CI/CD and fix some lint issues #739

    • Linter fixes, new feature of allowing multiple directories at startup, other code improvements #764

    • Model unit tests #803

    Open source →
    Release notes

    2025-05-22

    Update

    • Added a Command-Prompt for SuperFile specific actions #752
    • Allow specifying multiple panels at startup #759
    • Initial draft of rendering package #775
    • Render unit tests for prompt model #809
    • Chooser file option, --lastdir-file option, and improvements in quit, and bug fixes #812
    • Prompt feature leftover items #804
    • SPF Prompt tutorial and fixes #814
    • Write prompt tutorial, rename prompt mode to spf mode, add develop branch in GitHub workflow, show_panel_footer_info flag #815
    • Theme: Add gruvbox-dark-hard #828
    • Sidebar separation #767
    • Sidebar code separation #770
    • Rendering package and rendering bug fixes #781
    • Refactor CheckForUpdates #797
    • Rename metadata strings #731

    Bug Fixes

    • Fix crash with opening file with editor on an empty panel #730
    • Fix: Add some of the remaining linter and fix errors #756
    • Golangci lint fixes #757
    • Fix: Remove redundant function containsKey #765
    • Fix: Correctly resolve path in open and cd prompt actions #802
    • Prompt dynamic dimensions and unit tests fix #805
    • Fix: Convert unicode space to normal space, use rendered in file preview to fix layout bugs, Release 1.3.0 #825

    Optimization

    • Adding linter to CI/CD and fix some lint issues #739
    • Linter fixes, new feature of allowing multiple directories at startup, other code improvements #764
    • Model unit tests #803
    Open source →
  31. v1.2.2-0.20250329042835-d052a9ed7525 29 Mar 2025 pre-release

    Nothing published for this version

  32. v1.2.1 29 Mar 2025
    Release notes

    2025-03-26

    Update

    • Add show_image_preview flag #728

    • Allow specifying directory icon color in theme files #709

    • —hotkey-file flag and fix in configFileFlag #700

    • File preview: Add bat as plugin #686

    • Monokai Theme #673

    Bug fix

    • Fix broken link in website causing 404 #714

    • Fix sidebar disk listing #708

    • Switch to semver for newer 1.2.1 release #687

    Optimization

    • Fix: icon consts #719

    • Refactor and unit tests for scrolling #710

    • Refactor of wheel functions #695

    Documentation

    • Add info about auto update #721

    • add cd_on_quit for fish shell #696

    • Add Pixi installation instructions #690

    Open source →
    Release notes

    2025-03-26

    Update

    • Add show_image_preview flag #728
    • Allow specifying directory icon color in theme files #709
    • --hotkey-file flag and fix in configFileFlag #700
    • File preview: Add bat as plugin #686
    • Monokai Theme #673

    Bug fix

    • Fix broken link in website causing 404 #714
    • Fix sidebar disk listing #708
    • Switch to semver for newer 1.2.1 release #687

    Optimization

    • Fix: icon consts #719
    • Refactor and unit tests for scrolling #710
    • Refactor of wheel functions #695

    Documentation

    • Add info about auto update #721
    • add cd_on_quit for fish shell #696
    • Add Pixi installation instructions #690
    Open source →
  33. v1.1.8-0.20250314051056-eb01fc3d642f 14 Mar 2025 pre-release

    Nothing published for this version

  34. v1.1.8-0.20250305162039-0de468d2bb3b 05 Mar 2025 pre-release

    Nothing published for this version

  35. v1.1.8-0.20250305142928-8113c7ebde0d 05 Mar 2025 pre-release

    Nothing published for this version

  36. v1.1.8-0.20250124081640-b157637e9ac7 24 Jan 2025 pre-release

    Nothing published for this version

  37. v1.1.8-0.20250106074529-820140a9cb3f 06 Jan 2025 pre-release

    Nothing published for this version

  38. v1.1.7 05 Jan 2025
    Release notes

    2024-01-05

    Update

    • OneDark Theme added #477

    • Add keys PageUp and PageDown for better navigation #498

    • Add hotkey for copying PWD to clipboard #510

    • Add desktop entry #501

    • Enable cd_on_quit when current directory is home directory #518

    • Edit superfile config #509

    Bug fix

    • Fix rendering directory symlinks as directories, not files #481

    • Fix opening files on Windows #496

    • Fix lag in dotfile toggle with multiple panels #499

    • Fix parent directory navigation on Windows #502

    • Fix panic when deleting last file in directory #529

    • Fix panic when scrolling through an empty metadata list #531

    • Fix panic when trying to get folder size without needed permissions #532

    • Fix lag when navigating directories with large image files #525

    • Fix typo in welcome message #494

    Optimization

    • Optimize file move operation #522

    • Optimize file extraction #524

    • Warn overwrite when renaming files #526

    • Work without trash #527

    Open source →
    Release notes

    2024-01-05

    Update

    • OneDark Theme added #477
    • Add keys PageUp and PageDown for better navigation #498
    • Add hotkey for copying PWD to clipboard #510
    • Add desktop entry #501
    • Enable cd_on_quit when current directory is home directory #518
    • Edit superfile config #509

    Bug fix

    • Fix rendering directory symlinks as directories, not files #481
    • Fix opening files on Windows #496
    • Fix lag in dotfile toggle with multiple panels #499
    • Fix parent directory navigation on Windows #502
    • Fix panic when deleting last file in directory #529
    • Fix panic when scrolling through an empty metadata list #531
    • Fix panic when trying to get folder size without needed permissions #532
    • Fix lag when navigating directories with large image files #525
    • Fix typo in welcome message #494

    Optimization

    • Optimize file move operation #522
    • Optimize file extraction #524
    • Warn overwrite when renaming files #526
    • Work without trash #527
    Open source →
  39. v1.1.7-0.20241210051556-aab8d242e54c 10 Dec 2024 pre-release

    Nothing published for this version

  40. v1.1.7-0.20241209171152-f83ea7ec75ad 09 Dec 2024 pre-release

    Nothing published for this version

  41. v1.1.7-0.20241204051300-47d675106333 04 Dec 2024 pre-release

    Nothing published for this version

  42. v1.1.7-0.20241203161032-ec132052337f 03 Dec 2024 pre-release

    Nothing published for this version

  43. v1.1.7-0.20241201135237-005fa65324e1 01 Dec 2024 pre-release

    Nothing published for this version

  44. v1.1.7-0.20241130191721-870367d8af75 30 Nov 2024 pre-release

    Nothing published for this version

  45. v1.1.7-0.20241129190533-b6eaebb01d45 29 Nov 2024 pre-release

    Nothing published for this version

  46. v1.1.7-0.20241128015532-bf90f8738e9e 28 Nov 2024 pre-release

    Nothing published for this version

  47. v1.1.7-0.20241127154148-32d60649ed6b 27 Nov 2024 pre-release

    Nothing published for this version

  48. v1.1.7-0.20241125101902-8bd8b2139528 25 Nov 2024 pre-release

    Nothing published for this version

  49. v1.1.7-0.20241124061016-5a6c92148d9e 24 Nov 2024 pre-release

    Nothing published for this version

  50. v1.1.7-0.20241122185544-1fc46d8e4570 22 Nov 2024 pre-release

    Nothing published for this version

  51. v1.1.7-0.20241121234438-6ecdaf222321 21 Nov 2024 pre-release

    Nothing published for this version

  52. v1.1.7-0.20241121172242-4911a98a5b3e 21 Nov 2024 pre-release

    Nothing published for this version

  53. v1.1.6 21 Nov 2024
    Release notes

    2024-11-21

    Update

    • Add sort case toggle #469

    • Add Sort options #420

    • Fix flashing when switching between panels #122

    Bug fix

    • Fix some hotkey broken

    • Fix the searchbar to automatically put the open key into the searchbar ec9e256

    Open source →
    Release notes

    2024-11-21

    Update

    • Add sort case toggle #469
    • Add Sort options #420
    • Fix flashing when switching between panels #122

    Bug fix

    • Fix some hotkey broken
    • Fix the searchbar to automatically put the open key into the searchbar ec9e256
    Open source →
  54. v1.1.6-0.20241119093151-deac975dc55b 19 Nov 2024 pre-release

    Nothing published for this version

  55. v1.1.6-0.20241118044111-0a41f7b449b4 18 Nov 2024 pre-release

    Nothing published for this version

  56. v1.1.6-0.20241114084653-d67f59ed297b 14 Nov 2024 pre-release

    Nothing published for this version

  57. v1.1.6-0.20241111020531-1f6973ac43b3 11 Nov 2024 pre-release

    Nothing published for this version

  58. v1.1.6-0.20241019023801-b656c877a24b 19 Oct 2024 pre-release

    Nothing published for this version

  59. v1.1.6-0.20241005100631-d8ec977f7176 05 Oct 2024 pre-release

    Nothing published for this version

  60. v1.1.6-0.20241003073840-1a502e5c89ae 03 Oct 2024 pre-release

    Nothing published for this version

Every package, every release, already written down.

The archive is open and free. Watching your own project is what we are building next.

Browse the archive