• refactor gotodir code - pull out into common functions, between gotodir and selectundercursor

• refactor clean history code; figure out whether to use HistoryRecord struct or just tuple (String, usize, etc.)

• clear jumptodir history eventually.. after 90days? after ranking score is at minimum? give script to clear all with minimum possible ranking score of 1 for user to manually execute (probs as one of the .sh functions to import intop command palette?). see this algorithm: - [ ] for fmin matching algorithm: https://github.com/ajeetdsouza/zoxide/wiki/Algorithm#frecency

• consider using two env vars $FMIN_CWD and $FMIN_SELECTED that stay updated so user can shell out and use them when needed. maybe also $FMIN_OPEN=myscript.sh as a means to import that important and custom feature. note though that multiline env var values cause problmes with env command, so $FMIN_SELECTED cant be newline-separated.

  • note that this is a sort of anti-pattern, hacky way to use env vars; some may find it gross; but i think the resulting feature is a big usability/convenience win, for not much cost
  • actually it might not work: the program can set current process env vars, and set global shell .env exports, but can't change parent process, and can't tell other processes that a global env var was updated, so other processes would have to source the .env file to use the recently updated paths (lame)
  • this is all getting too complex; maybe have a nice program function for copying cwd to clipboard, and user can easily cd afterwards if they want. this still doesnt solve live scripting with selected files tho - maybe those filepaths can be copied to clipboard as well.
  • probably just use files; write data to /tmp/fmin_cwd or something like that
  • maybe fmin.sh =

   set FMIN_SHIFT_Z 'tar -xvf (cat /tmp/fmin.filepaths)'
  
   fmin
   cd (cat /tmp/fmin.cwd)
  

  • actually fmin writes cwd to stdout now! so just cd $(fmin)
  • investigate std::env::set_current_dir as an alternative to $FMIN_CWD
  • see also the terminal file manager that uses env vars for config: https://github.com/dylanaraps/fff?tab=readme-ov-file which apparently uses a little-known young standard $CDPATH that i might be interested in. EDIT - i dont like cdpath and it seems pretty rare and nonstandard. it's pretty much a manually set home path per session
  • consider also: $FMIN_DELETE=rm by default, or 'mv $ /trash/'
  • also: $IFS internal field separator (https://unix.stackexchange.com/questions/184863/what-is-the-meaning-of-ifs-n-in-bash-scripting)

• performance optimization on large dirs, which is important bc slowness in large dirs was one of the main reasons for ditching fman:

  • maybe to help large dirs go faster: only read filenames first and be ready to display, then if that took a long time (or huersitic if dir has >1000 files) only display filenames with metadata (loading), and iterate thru entries to get metadata and finish displaying with that second step eg. displaying newly entered directory, part 1

___________________________________________
 Name                v | Size   | Modified
___________________________________________
loopy/                     loading...
droopy/                    loading...
grumpy/                    loading...
frumpy/                    loading...
script1.py                 loading...
script_2.py                loading...
main.py                    loading...
utils.py                   loading...
                                            
(this dir has a lot of entries)
___________________________________________

second step will read metadata date and size and calc display. also note im doing a math.log() call for size formatting... probably not helping. i just realized thats easily replaceable with a few (x < 10? x < 100? x < 1000?) cases - measure and make sure thats faster - bonus points if program is still responsive to keypresses, especially between 1st and 2nd steps while metadata is loading - MUST measure performance between both options tho - try creating perf test then git branch to test new implementation - also, if i already have sorted vec and i know view_start and view_end, then i only need to format strings for entries between view_start and view_end before displaying, instead of formatting each entry in whole vec. also memoization will help if i structure the code to make repeat formatting calls - note that fman slowness was in the order of seconds, and so far my longest load times are less than a second. so maybe this is not as huge a priority as previously thought - also note that perhaps the essential I/O of reading a directory is taking the majority of the time, and these other improvements might be negiligble and not worth the effort. I should make a flamegraph

• also consider caching large dir results, and having filewatcher processes knowing when to clear the cache id the dir is modified

• dual pane? or N-pane, with client/server architecture? where server just holds yanked filepaths... kinda overkill. maybe connect with unix pipes? also consider multiplatform... maybe cli option --pair-with-session to opt in to a dual pane? --pair-with-last, --print-all-session-ids, --start-background-server

• make sure all rust functions take borrowed struct params, unless they are supposed to take ownership after the function call

• try changing drawing commands to work with newer, in-progress terminal like alacritty. i suspect those terminals haven't implemented ansi codes like MoveLinesUp. so replace with more basic drawing commands, like maybe MoveTo. EDIT - note that fmin inside tmux inside alacritty, renders well, but fmin in alacritty without tmux breaks

• lean into the low-friction selling point in the docs; maybe have narratives like "i want to jump to [somedir] and see what's inside" == cd ls; and "i want to explore all the subdirectories, and look for big files and recently modified files" == cd ls --some-options, repeated dozens of times; "i want to goto that one niche dir, but i only remember this partial name" == zoxide/history

• redo screenshot, and also do demo mp4s, esp now that i have alacritty (faster, no OS border color, easy to configure perfect size)

• make sure network filesystems work, like google drive or dropbox or nas'es

• icons, like nerdfont, or at least ascii chars, just to add redundancy to make visually identifying files easier (.py, directories, .md, source code, plaintext, binaries, etc)

• consider shift m like a shift click on windows, meaning select all from beginning mark up to cursor

• display idx/total item count in bottom right. also num selected items

• potential cli/config options: --start-jumping, --config-at, --history-at, --logs--at along with types like Config::starting_mode/logs_path/... or consider also zero cli options, and all config happens in env vars

• have logs in the first place

• include sortorder in history file as UX/QOL improvement, so fmin remembers your preferred sort order in each dir

• some more fringe command ideas to consider for default palette (beyond move/cut, refresh, copy, delete, sort, select, select all): new file, new folder, rename. these could be outsourced to custom scripts/functions tho, esp if they're not used often

• be able to delete directories in frecency list (rather than opening flat history db file and editing / deleting lines). Note that some dirs temporarily appear and disappear, like USBs, and those should never be deleted automatically just because they arent present at a certain moment

• use docopt for cli options, and maybe just a quick and dirty custom implementation instead of the full library/dsl since that repo sounded problematic and not worth a dependency, and most complexity should live in the tui and not the cli anyways. i just like docopt

• consider cli option fmin <starting_dir>; useful for scripting from another process, like maybe /my/other/shell fmin but/still/this/cwd

• redundant hotkeys: ctrl j == > or something for jumptodir, ctrl p == : for command palette, and ctrl f == / for filter/search. bc control keys are good from any mode, whereas typical vim mode you have to escape back to normal mode before entering another. although reminder to self that many ctrl key presses are reserved terminal shortcuts, so try not to override them

• other plugin function ideas: print width/height for img/video files, duration of audio/video files, batch rename selected? (eg. img_01, img_02, etc), copy cwd abs path to clipboard

• for batch rename, consider opening vim/$editor buffer to let user macro their own filename pattern edits. thats what this file manager does in their demo video: https://github.com/sxyazi/yazi

• keep command palette context dependent, eg. show up/down navigation in normal mode, but hide those and show others like esc keybind for filter mode

• add filewatcher to cwd so tui live updates when files are added/removed/modified

• write --help text, full docs in readme, and consider coverting to manpage too

• support --version if it's not already free with crossterm

• do some stress tests, like dir with 1k, 100k, many files (programming/texting/data/cleaned/media is a good real example with 2300 items. also c/windows/sytem32, 5000 entries. also staged / setup test dirs). and dirs with really large files (that seems fine so far tho). then weird unicode filenames. then spamming actions like typing filter text and naving back and forth. also going to weird dirs like recycle bin. see also symlinks. then networked/virtual filesystems.

• support unicode filenames and input text? eh, only once i finish other features that i care about that matter for personal use...

• support rebinding keys? not sure how control characters and letters work on other non-american keyboards... same low priority as above tho

• drag n drop with COM objects on windows? terinal detect mouse hold event -> create COM object for windows-os-level drag n drop -> do something... that would be more of a plugin functionality, and it would take a long time to learn about and hack on COM. although this is kinda important since i do lots of drag n drop in my workflow. but less important if theres a quick open in native os file explorer command

• if shortening long strings, consider using unicode char (…) instead of 3 dots(...) since it takes up less space

• also consider shortening abs paths like cwd into abbreviated form, eg. /m/c/u/j/desktop for /mnt/c/users/jkwon/desktop

• also consider shortening /mnt/c/users/jkwon/Desktop to ~/Desktop, and all those home directories, since they get reptitive and dont bring important information for me personally. maybe try that on a feature branch, not master

• any max length to consider when shortening strings? some data points: 80ch historic terminal width. average filename length on my machine __ chars (todo - measure it). max filename length on my machine: __ chars (measure this too). cal output width, as an example of skinny output: 20ch for one month (62ch for 3 months). my clock script - ~50ch. and with smallclockchars, probably ~25ch. right now, date field is 14ch and size is 7ch, so name should be >= 14ch too. Or >= 21. so 21 7 14 4ch of margins = 46ch minimum in a sense. still need to shorten paths that are too long tho, and cwds over 40ch

• consider having shortened versions of date and size for tiny terminal sessions? like use display::CompactWidth/Condensed/Comfortable if name_col is less than size modified cols

• consider leader key normal keypress, where user can define leader key, which works well for sxiv tool (see https://youtu.be/GYW9i_u5PY://youtu.be/GYW9i_u5PYs)

• consider caching Format trait on Date and Size, in case it helps

• remember to have confirmation step before perofrming action that modifies filesyystem (eg. move 10 files to new/dir/? [y/n]) or alternatively make it easy to undo or alternatively harder to perform on accident, eg. not a simple keypress in normal mode, esp since its easy to think youre in filter mode by mistake maybe keep those actions limited to command palette with no shortcut? move/copy/delete/rename

• i like how displaying more information lets you release some headspace - dont have to remember if file is big or small; dont have to remember ls -whatevercommands to format file info; seeing big file size in addition to name can help identify file quicker in your brain, same with modified date; always displaying cwd (which ive omitted in my $prompt for the sake of space); perhaps helps when burned out, freeing up mental space and energy

• also enjoy minimal keypresses, esp when coupled with minimal thinking - eg. ctrl p one step shortcut to jump from any mode to command palette mode, rather than remembering page/modal navigation and esc -> colon:, two steps and extra keypress

• reminder to self that the UI is not as complex because no need for linewrapping - keep it that way

• look at fman issues, both open and closed, to see people's most desired features: https://github.com/fman-users/fman/issues?q=is:issue sort:reactions-+1-desc the main ones:

  • search (presumably recursively in cwd; low priority for me personally; could be a ls | grep command anyways; and text search is an rgrep command)
  • batch rename (this is rarer and could be outsourced to $editor where macro editing is optimized)
  • commmand to compute directory size (this should be plugin script/function, not core)
  • feedback on file operations
  • remember sort order for dirs
  • undo for commands rename/copy/delete (probably difficult, and less important if these dont happen by accident. also if delete is aliased to mv $trash)

• midnight commander has lots of arcane keybindings, including function keys all the way at the top of the keyboard, and a bit of chording; ideally the command palette is the opposite experience, that is, immediately understandable and productive, with minimal learning curve

• i found this other windows text-view file manager: https://www.farmanager.com/screenshots.php?l=en

• bug to investigate: high CPU usage for long running program; i think it's fmin but not sure; a couple fish processes reported in windows task manager, only appearing since fmin development

• another bug to investigate: terminal not returning to normal mode after fmin quit; i think it has to do with line wrapping. to reproduce: use fmin, then fish shell tab autcomplete to wrap line

• and another bug: history filepaths are written incorrectly, eg "5,/mnt/c/Users/jkwonroot/asciiart" or"7,/mnt/c/Users/jkwon/desktop/programming/fminsciiart/ansi". maybe has to do with the contents of the asciiart/ dir? or maybe that one session was wacky and corrupted somehow?