CHANGELOG

ChangeLog

All notable changes to this project will be documented in this file. Dates are displayed in UTC(YYYY-MM-DD).

v1.4.0

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

v1.3.3

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

v1.3.2

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

v1.3.1

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

v1.3.0

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

v1.2.1

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

v1.2.0.0

2025-03-05

Update

• Added direnv support for nix flake dev shell #568
• Move rename cursor to start before the extension #565
• Renaming feature for pinned directories #579
• Add python testsuite #581
• Add build instructions for windows #583
• Add --config-file flag support #592
• Document Windows scoop installation option #595
• Rotate image using EXIF metadata #607
• Upgrade sidebar search #614
• Change all outPutLog to slog.Error or slog.Info #628
• Add install.sh files link for more trust #645
• Update README.md and added a Run the app title #550

Bug fix

• Fix sort options hotkey #548
• Fix wrong log line, Fatalln was used with formatting verbs #555
• Fix incorrect failure reporting in delete operation #558
• Fix previews for text file with control characters #557
• Fix search field key blocking #569
• Fix windows operations and other improvements #564
• Fix crash when searching on WSL mounted drives #576
• Fix arch install instructions #580
• Fix windows delete, open file and other improvements #584
• Fix UI issue of spf stuck with terminal size too small #594
• Fix wrong path separator in windows #597
• Fix command line not working for windows #601
• Fix error while reading last check version file in new time zone #634
• Fix discrete timeout for HTTP get version #632
• Fix initial pinned.json having invalid JSON #652
• Fix loadConfigFile and loadHotkeysFile functions #650
• Fix issue when trying to extract a file with .zip_ extension #636
• Fix openFileWithEditor bug #635
• Fix partial overwrite issue by ensuring full file rewrite #665

Optimization

• Improving file panel rendering #589
• Improve formatting, error handling, and fix typos #600
• Go formatting fixes #618
• Testsuite in GitHub Actions #602

Documentation

• Revert changes in website that were not yet released #611
• Docs contribute #610
• Remove godocs badge #627
• Update installation.md to note setting nerd-font in terminal application #658
• Fix README typos #653

v1.1.7.1

2024-01-06

NOTE: This release is a hotfix to resolve an unusual issue on Windows.

Bug fix

• Fix can’t run on windows #534

v1.1.7

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

v1.1.6

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

v1.1.5

2024-10-03

Update

• Stop automatically updating config file. Add fix-hotkeys flag, feedback for missing hotkeys #333
• Update installation.md: Add x-cmd method to install superfile #371
• Added option to change default editor #396
• Support Shell access but cant read history #127
• shortcut to copy path to currently selected file #196

Bug fix

• fixed typo in hotkeys.toml #341
• Fixes issue #360 + Typo fixes by #379
• fixed spelling mistake : varibale to variable #394
• fixed exiftool session left open after use #400
• Show unsupported format in preview panel over a torrent file #408
• Vim bindings in docs cause error on nixos #325
• fix spf help flag error #368
• You cannot access the disks section in the side panel when only have one disk #409
• “Unsupported formats” message has an extra space for .pdf files #392

v1.1.4

2024-08-01

Update

• Added option to change default directory #211
• Added quotes around dir in lastdir to support special characters #218
• Make Hotkey settings unlimited 423a96a
• Selection should start on currently positioned/pointed item #226
• Make Nerdfont optional #6
• Confirm before quit #155
• Added file permissions to metadata #279
• Better fuzzy file search #115
• MD5 checksum in Metadata #255
• An option to display the filesize in decimal or binary sizes #220

Bug fix

• An option to display the filesize in decimal or binary sizes #220
• Fix Transparent Background issue #76
• Big text file makes the program freeze for a while #255
• Text in file preview has a background color behind it when using transparency #76

v1.1.3

2024-05-26

Update

• Update print path list 37c8864
• Make theme files embed 0f53a12
• Disable update check via config #131
• Redesign hotkeys #116
• Create file or folder using same hotkey #116
• More dynamic footer height adaptive 66a3fb4
• Confirm delete files “
• Support windows for get well known directories d4db820
• Support text file preview #26
• Support directory preview #26
• Improve mouse scrolling delay f734292
• Support image preview with ansi #26
• Clear search after opening directory #146

Bug fix

• Recursive symlink crashes superfile #109
• Timemachine snapshots listed in Disks section #126
• There will be a bug in the layout under a specific terminal height #105
• Fix lag when there are a lot of files #124
• Rendering will be blocked while executing a task that uses a progress bar #104

v1.1.2

2024-05-08

Update

• Update help menu #75
• Update all modal, make other panel still show on background #79
• Support extract gz tar file b9aed84
• Support transparent background 4108d40
• Support custom border style 6ff0576
• Enhancement when cutting and pasting, the file should be moved instead of copied and deleted. #100
• Support extract almost compression formats e57cb78
• Update XDG_CACHE to XDG_STATE_HOME #90

Bug fix

• Fix Cut -> Paste file causes go panic #77
• Fix symlinked folders don’t open within superfile #88

v1.1.1

2024-04-23

Update

• Open directory with default application #33
• Auto update config file if missing config 1498c92

Bug fix

• key l deletes files in macOS #72

v1.1.0

2024-04-20

Update

• Update data folder from $XDG_CONFIG_HOME/superfile/data to $XDG_DATA_HOME/superfile 9fff97a
• Toggle dot file display 9fff97a
• Update log file from $XDG_CONFIG_HOME/superfile/data/superfile.log to $XDG_CACHE_DATA #27
• Update theme background #42
• Update unzip function #55
• Update zip function 60c490a
• Update all config file from json to toml format file a018128
• Update search bar #61
• Update theme config format #66
• Update metadata to plugins c1f942d

Bug fix

• Fix interface lag when selecting zip files or large files #29
• Fix external media error #46
• Fix can’t find trash can folder 396674f
• Fix Crashes when truncating metadata #50

v1.0.1

2024-04-08

Update

• Update $HOME/.superfile to $XDG_CONFIG_HOME/superfile 886dbfb
• Follow The FreeDesktop.org Trash specification to update the trash bin path in local path 886dbfb
• The external hard drive will be deleted directly ,But macOS for now not support trash cana4232a8
• The user can enter the path, which will be the path of the first file panel 14620b3
• Make user can open file with default browser text-editor etc f47d291
• Can open terminal in focused file panel path f47d291

Bug fix

• Fix processes bar cursor index display error f6eb9d8
• Fix Crash when selecting a broken symlink e89722b

v1.0.0

2024-04-06

Update

• Auto download folder 96a3a71
• Auto initialize configuration 96a3a71
• Add version sub-command ee22df3

Bug fix

• Fix creating an Item when the file panel has no Item will cause an error 9ee1d86
• Fix delete mupulate Item will cause cursor error ee22df3

Beta 0.1.0

2024-04-06

• FIRST RELEASE COME UP! NO ANY CHANGE