Skip to content

Files

Latest commit

Feb 29, 2024
dbd120a · Feb 29, 2024

History

History
81 lines (55 loc) · 2.29 KB

README.md

File metadata and controls

81 lines (55 loc) · 2.29 KB

Minimalist selector in shell, à la fzf

screenshot

test

what's it for ?

You need to:

  • select between several choices ?
  • in a shell script ?
  • with minimal dependencies ?

Just copy the fsh function in your script.

usage example

$ echo -e 'Hello, world!\n¡Hola, mundo!\nBonjour, le monde !\nHallo, Welt!' | ./fsh
...
Hello, world!
¡Hola, mundo!
Bonjour, le monde !
Hallo, Welt!

> 

type your text

Hallo, Welt!

> hall

Press enter

Hallo, Welt!

limitations

  • not POSIX shell: it's only tested in zsh and bash.
  • to keep it lightweight and fast, I (mostly) don't plan on adding new features.

variables reference

You can customize the behavior of fsh by setting the following variables:
Variable Description Default value
FSH_SELECTOR_COLOR the color line currently highlighted 40
FSH_FRAME_COLOR the color of the frame 30
FSH_PROMPT_COLOR the color used for the prompt 34
FSH_SELECT_COLOR the color of the sign before the line currently selected 31
FSH_TEST_INPUT the simulated user input given as a string, one character at a time. first character will be ignored. if set the script will not read from stdin ""
FSH_HEADER a name to display beofre the prompt to give context on what is expected ""
FSH_VIM_MODE (not implemented) set this variable to support vim normal mode ""
FSH_PERF if this variable is set, will display the time it took to draw the interface ""
FSH_NO_FUZZY if this variable is set, will not use fuzzy search, instead will do a pattern match ""
FSH_LINES the height of the terminal (used for testing, otherwise will be set by tput) $t_lines
FSH_COLUMNS the width of the terminal (used for testing, otherwise will be set by tput) $t_cols
FSH_SCREENSHOT if this variable is set, will write a screenshot of the terminal at each iteration and generate an animation at the end ""