summaryrefslogtreecommitdiff
path: root/src/options.go
AgeCommit message (Collapse)Author
2025-10-09Fix --help output: socket path cannot be omittedJunegunn Choi
2025-10-09Add Unix domain socket support for --listenJunegunn Choi
Close #4541
2025-10-09Add 'best' actionJunegunn Choi
2025-10-09Rename: '--color hidden' to '--color nomatch'Junegunn Choi
2025-10-09Add special 'strip' style attribute for stripping colorsJunegunn Choi
Test cases: fd --color always | fzf --ansi --delimiter / fd --color always | fzf --ansi --delimiter / --nth -1 --color fg:dim,nth:regular fd --color always | fzf --ansi --delimiter / --nth -1 --color fg:dim:strip,nth:regular fd --color always | fzf --ansi --delimiter / --nth -1 --color fg:dim:strip,nth:regular --raw fd --color always | fzf --ansi --delimiter / --nth -1 --color fg:dim:strip,nth:regular,hidden:strikethrough --raw fd --color always | fzf --ansi --delimiter / --nth -1 --color fg:dim:strip,nth:regular,hidden:strip:strikethrough --raw fd --color always | fzf --ansi --delimiter / --nth -1 --color fg:dim:strip,nth:regular,hidden:strip:dim:strikethrough --raw
2025-10-09Revise color configurationJunegunn Choi
2025-10-09Do not allow gutter characters with width other than 1Junegunn Choi
2025-10-09Add enable-raw and disable-raw actionsJunegunn Choi
2025-10-09Introduce 'raw' modeJunegunn Choi
2025-09-29refactor: use maps.Copy and maps.Clone (#4518)mickychang9
Signed-off-by: mickychang9 <mickychang9@outlook.com>
2025-09-28Update --help output to avoid confusionJunegunn Choi
2025-09-17Adjust base16 (16) theme (#4501)Junegunn Choi
Motivation: `--color base16` can be a better default than `dark` or `light`, since it uses the colors defined by the current theme. This usually blends in more naturally and works well in both light and dark modes. However, some elements were previously hard-coded with white or black foreground colors, which can cause rendering issues in certain terminal themes.
2025-09-16Add --gutter to --help and man pageJunegunn Choi
2025-09-16Style change: thinner gutter column (#4521)Junegunn Choi
2025-09-05Add sub-word actions (#3997)Massimo Mund
Add `backward-subword`, `forward-subword`, `kill-subword`, `backward-kill-subword` actions.
2025-09-05Add keybindings for CTRL, ALT, SHIFT + UP, DOWN, RIGHT, LEFT, HOME, END, ↵Massimo Mund
BACKSPACE, DELETE & more (#3996) * Added tests for `LightRenderer` * Added common SHIFT, ALT and ALT+SHIFT key sequences * Added common CTRL key sequences * Added common CTRL+ALT, CTRL+SHIFT, CTRL+ALT+SHIFT key sequences * Added proper xterm META modifier handling according to https://github.com/joejulian/xterm/blob/defc6dd5684a12dc8e56cb6973ef973e7a32caa3/input.c#L357-L375 * Fix `ctrl-backspace` and `ctrl-alt-backspace` * Fix broken tcell tests on windows by swallowing Resize events * Added tests for FullscreenRenderer * Removed own fork of tcell and updated tcell to 2.9.0 tcell 2.9.0 is needed for `Ctrl-Alt-*` and `Ctrl-Alt-Shift-*` shortcuts in Windows * Replace conditional checks with switch statements to improve readability * Replace long conditionals with constant slices to improve readability * Bind `ctrl-bspace` (`ctrl-h`) to `backward-delete-char` by default Since we now distinguish between Backspace and Ctrl-Backspace, Ctrl-Backspace should trigger the same action as Backspace by default. In that way nothing changes for the user but you can bind other actions to Ctrl-Backspace when desired.
2025-07-23Add 'trigger(KEY_OR_EVENT[,...])' actionJunegunn Choi
2025-07-22Add 'click-footer' eventJunegunn Choi
2025-07-22Fix --no-header-lines-border behaviorJunegunn Choi
It should be different from --header-lines-border=none according to the man page. It should merge two headers unlike the latter.
2025-07-06Add 'multi' event triggered on multi-selection changesJunegunn Choi
2025-06-21Add bg-cancel action to ignore running background transformsJunegunn Choi
Close #4430 Example: # Implement popup that disappears after 1 second # * Use footer as the popup # * Use `bell` to ring the terminal bell # * Use `bg-transform-footer` to clear the footer after 1 second # * Use `bg-cancel` to ignore currently running background transform actions fzf --multi --list-border \ --bind 'enter:execute-silent(echo -n {+} | pbcopy)+bell' \ --bind 'enter:+transform-footer(echo Copied {} to clipboard)' \ --bind 'enter:+bg-cancel+bg-transform-footer(sleep 1)'
2025-06-16Implement asynchronous transform actions (#4419)Junegunn Choi
Close #4418 Example: fzf --bind 'focus:bg-transform-header(sleep 2; date; echo {})'
2025-06-10Add footerJunegunn Choi
Options: --footer=STR String to print as footer --footer-border[=STYLE] Draw border around the footer section [rounded|sharp|bold|block|thinblock|double|horizontal|vertical| top|bottom|left|right|line|none] (default: line) --footer-label=LABEL Label to print on the footer border --footer-label-pos=COL Position of the footer label [POSITIVE_INTEGER: columns from left| NEGATIVE_INTEGER: columns from right][:bottom] (default: 0 or center) The default border type for footer is 'line', which draws a single separator between the footer and the list. It changes its position depending on `--layout`, so you don't have to manually switch between 'top' and 'bottom' The 'line' style is now supported by other border types as well. `--list-border` is the only exception.
2025-06-10Fix inconsistent placement of header-lines with border optionsJunegunn Choi
fzf displayed --header-lines inconsistently depending on the presence of borders: # --header and --header-lines co-located seq 10 | fzf --header-lines 3 --header "$(seq 101 103)" --header-first # --header and --header-lines separated seq 10 | fzf --header-lines 3 --header "$(seq 101 103)" --header-first --header-lines-border This commit fixes the inconsistency with the following logic: * If only one of --header or --header-lines is provided, --header-first applies to that single header. * If both are present, --header-first affects only the regular --header, not --header-lines.
2025-05-28Allow customizing --ghost color via '--color ghost'Junegunn Choi
Examples: # Dimmed red fzf --ghost booya --color ghost:red # Regular red fzf --ghost booya --color ghost:red:regular Close #4398
2025-05-04Allow whitespace as separator in --color optionJunegunn Choi
2025-05-04Add 'alt-bg' color for striped lines (#4370)Junegunn Choi
Test cases: 1. 'jump' should show alternating background colors even when 'alt-bg' is not defined as before. go run main.go --bind load:jump Two differences: * The alternating lines will not be in bold (was a bug) * The marker column will not be rendered with alternating background color 2. Use alternating background color when 'alt-bg' is set go run main.go --color bg:238,alt-bg:237 go run main.go --color bg:238,alt-bg:237 --highlight-line 3. 'selected-bg' should take precedence go run main.go --color bg:238,alt-bg:237,selected-bg:232 \ --highlight-line --multi --bind 'load:select+up+select+up' 4. Should work with text with ANSI colors declare -f | perl -0777 -pe 's/^}\n/}\0/gm' | bat --plain --language bash --color always | go run main.go --read0 --ansi --reverse --multi \ --color bg:237,alt-bg:238,current-bg:236 --highlight-line --- Close #4354 Fix #4372
2025-04-20Add --tty-default=/dev/tty and --no-tty-default option (#4352)Junegunn Choi
Fix #4242. Use --no-tty-default, if you want fzf to perform a TTY look-up instead of defaulting to /dev/tty.
2025-03-28Add change-ghost and transform-ghostJunegunn Choi
2025-03-28Add change-pointer and transform-pointerJunegunn Choi
Close #4178
2025-03-14Add `--ghost=TEXT` to display a ghost text when the input is emptyJunegunn Choi
2025-02-26Trim trailing whitespaces after processing ANSI sequencesJunegunn Choi
Close #4282
2025-02-24Fix regression: Trim trailing whitespaces when using --with-nthJunegunn Choi
https://github.com/junegunn/fzf/issues/4272#issuecomment-2677279620
2025-02-23Add support for {n} in --with-nth and --accept-nth templatesJunegunn Choi
Close #4275
2025-02-12Make --accept-nth and --with-nth support templatesJunegunn Choi
2025-02-09Rename actions: exclude and exclude-multiJunegunn Choi
https://github.com/junegunn/fzf/pull/4231#issuecomment-2646067669
2025-02-09Add exclude-current actionJunegunn Choi
https://github.com/junegunn/fzf/pull/4231#issuecomment-2646063208
2025-02-09Add 'exclude' action for excluding current/selected items from the result ↵Junegunn Choi
(#4231) Close #4185
2025-02-09Add --accept-nth option to transform the outputJunegunn Choi
This option can be used to replace a sed or awk in the post-processing step. ps -ef | fzf --multi --header-lines 1 | awk '{print $2}' ps -ef | fzf --multi --header-lines 1 --accept-nth 2 This may not be a very "Unix-y" thing to do, so I've always felt that fzf shouldn't have such an option, but I've finally changed my mind because: * fzf can be configured with a custom delimiter that is a fixed string or a regular expression. * In such cases, you'd need to repeat the delimiter again in the post-processing step. * Also, tools like awk or sed may interpret a regular expression differently, causing mismatches. You can still use sed, cut, or awk if you prefer. Close #3987 Close #1323
2025-02-02FZF_KEY enhancementsJunegunn Choi
* 'enter' instead of 'ctrl-m' * 'space' instead of ' '
2025-02-01Display header lines at the top in 'reverse-list' layoutJunegunn Choi
2025-02-01Add {show,hide,toggle}-input and expose $FZF_INPUT_STATEJunegunn Choi
2025-02-01Add toggle-bindJunegunn Choi
2025-01-30Add --no-input to hide the input section (#4210)Junegunn Choi
Close #2890 Close #1396 You can't type in queries in this mode, and the only way to trigger an fzf search is to use `search(...)` action. # Click header to trigger search fzf --header '[src] [test]' --no-input --layout reverse \ --header-border bottom --input-border \ --bind 'click-header:transform-search:echo ${FZF_CLICK_HEADER_WORD:1:-1}'
2025-01-28Enhance --min-height option to take number followed by +Junegunn Choi
2025-01-27Set the default value of --min-height depending on other optionsJunegunn Choi
2025-01-27Fix edge cases in --bind where ',' or ':' are chained (#4206)Junegunn Choi
2025-01-27Allow actions to multiple keys and events at onceJunegunn Choi
Close #4206
2025-01-26Make click-header export $FZF_CLICK_HEADER_{NTH,WORD}Junegunn Choi
2025-01-26Add 'search' and 'transform-search'Junegunn Choi
Close #4202