Recent releases for fzf

fzf 0.24.0

2020-10-27T15:00:55+00:00

- Real-time rendering of preview window ```sh # fzf can render preview window before the command completes fzf --preview 'sleep 1; for i in $(seq 100); do echo $i; sleep 0.01; done' # Preview window can process ANSI escape sequence (CSI 2 J) for clearing the display fzf --preview 'for i in $(seq 100000); do (( i % 200 == 0 )) && printf "\033[2J" echo "$i" sleep 0.01 done' ``` - Updated `--color` option to support text styles - `regular` / `bold` / `dim` / `underline` / `italic` / `reverse` / `blink` ```sh # * Set -1 to keep the original color # * Multiple style attributes can be combined # * Italic style may not be supported by some terminals rg --line-number --no-heading --color=always "" | fzf --ansi --prompt "Rg: " \ --color fg+:italic,hl:underline:-1,hl+:italic:underline:reverse:-1 \ --color pointer:reverse,prompt:reverse,input:159 \ --pointer ' ' ``` - More `--border` options - `vertical`, `top`, `bottom`, `left`, `right` - Updated Vim plugin to use these new `--border` options ```vim " Floating popup window in the center of the screen let g:fzf_layout = { 'window': { 'width': 0.9, 'height': 0.6 } } " Popup with 100% width let g:fzf_layout = { 'window': { 'width': 1.0, 'height': 0.5, 'border': 'horizontal' } } " Popup with 100% height let g:fzf_layout = { 'window': { 'width': 0.5, 'height': 1.0, 'border': 'vertical' } } " Similar to 'down' layout, but it uses a popup window and doesn't affect the window layout let g:fzf_layout = { 'window': { 'width': 1.0, 'height': 0.5, 'yoffset': 1.0, 'border': 'top' } } " Opens on the right; " 'highlight' option is still supported but it will only take the foreground color of the group let g:fzf_layout = { 'window': { 'width': 0.5, 'height': 1.0, 'xoffset': 1.0, 'border': 'left', 'highlight': 'Comment' } } ``` - To indicate if `--multi` mode is enabled, fzf will print the number of selected items even when no item is selected ```sh seq 100 | fzf # 100/100 seq 100 | fzf --multi # 100/100 (0) seq 100 | fzf --multi 5 # 100/100 (0/5) ``` - Since 0.24.0, release binaries will be uploaded to https://github.com/junegunn/fzf/releases

fzf 0.24.1

2020-10-28T16:46:48+00:00

- Fixed broken `--color=[bw|no]` option

fzf 0.24.2

2020-11-03T17:03:50+00:00

- Bug fixes and improvements

fzf 0.24.3

2020-11-09T11:43:50+00:00

- Added `--padding` option ```sh fzf --margin 5% --padding 5% --border --preview 'cat {}' \ --color bg:#222222,preview-bg:#333333 ```

fzf 0.24.4

2020-12-05T14:27:46+00:00

- Added `--preview-window` option `follow` ```sh # Preview window will automatically scroll to the bottom fzf --preview-window follow --preview 'for i in $(seq 100000); do echo "$i" sleep 0.01 (( i % 300 == 0 )) && printf "\033[2J" done' ``` - Added `change-prompt` action ```sh fzf --prompt 'foo> ' --bind $'a:change-prompt:\x1b[31mbar> ' ``` - Bug fixes and improvements

fzf 0.25.0

2021-01-02T19:10:59+00:00

- Text attributes set in `--color` are not reset when fzf sees another `--color` option for the same element. This allows you to put custom text attributes in your `$FZF_DEFAULT_OPTS` and still have those attributes even when you override the colors. ```sh # Default colors and attributes fzf # Apply custom text attributes export FZF_DEFAULT_OPTS='--color fg+:italic,hl:-1:underline,hl+:-1:reverse:underline' fzf # Different colors but you still have the attributes fzf --color hl:176,hl+:177 # Write "regular" if you want to clear the attributes fzf --color hl:176:regular,hl+:177:regular ``` - Renamed `--phony` to `--disabled` - You can dynamically enable and disable the search functionality using the new `enable-search`, `disable-search`, and `toggle-search` actions - You can assign a different color to the query string for when search is disabled ```sh fzf --color query:#ffffff,disabled:#999999 --bind space:toggle-search ``` - Added `last` action to move the cursor to the last match - The opposite action `top` is renamed to `first`, but `top` is still recognized as a synonym for backward compatibility - Added `preview-top` and `preview-bottom` actions - Extended support for alt key chords: alt with any case-sensitive single character ```sh fzf --bind alt-,:first,alt-.:last ```

fzf 0.25.1

2021-02-03T13:34:20+00:00

- Added `close` action - Close preview window if open, abort fzf otherwise - Bug fixes and improvements

fzf 0.26.0

2021-03-13T06:17:10+00:00

- Added support for fixed header in preview window ```sh # Display top 3 lines as the fixed header fzf --preview 'bat --style=header,grid --color=always {}' --preview-window '~3' ``` - More advanced preview offset expression to better support the fixed header ```sh # Preview with bat, matching line in the middle of the window below # the fixed header of the top 3 lines # # ~3 Top 3 lines as the fixed header # +{2} Base scroll offset extracted from the second field # +3 Extra offset to compensate for the 3-line header # /2 Put in the middle of the preview area # git grep --line-number '' | fzf --delimiter : \ --preview 'bat --style=full --color=always --highlight-line {2} {1}' \ --preview-window '~3:+{2}+3/2' ``` - Added `select` and `deselect` action for unconditionally selecting or deselecting a single item in `--multi` mode. Complements `toggle` action. - Sigificant performance improvement in ANSI code processing - Bug fixes and improvements - Built with Go 1.16

fzf 0.27.0

2021-04-06T13:57:45+00:00

- More border options for `--preview-window` ```sh fzf --preview 'cat {}' --preview-window border-left fzf --preview 'cat {}' --preview-window border-left --border horizontal fzf --preview 'cat {}' --preview-window top:border-bottom fzf --preview 'cat {}' --preview-window top:border-horizontal ``` - Automatically set `/dev/tty` as STDIN on execute action ```sh # Redirect /dev/tty to suppress "Vim: Warning: Input is not from a terminal" # ls | fzf --bind "enter:execute(vim {} < /dev/tty)" # "< /dev/tty" part is no longer needed ls | fzf --bind "enter:execute(vim {})" ``` - Bug fixes and improvements - Signed and notarized macOS binaries (Huge thanks to [BACKERS.md](https://github.com/junegunn/junegunn/blob/main/BACKERS.md)!)

fzf 0.27.1

2021-05-22T04:25:16+00:00

- Added `unbind` action. In the following Ripgrep launcher example, you can use `unbind(reload)` to switch to fzf-only filtering mode. - See https://github.com/junegunn/fzf/blob/master/ADVANCED.md#switching-to-fzf-only-search-mode - Vim plugin - Vim plugin will stop immediately even when the source command hasn't finished ```vim " fzf will read the stream file while allowing other processes to append to it call fzf#run(fzf#wrap({'source': 'cat /dev/null > /tmp/stream; tail -f /tmp/stream'})) ``` - It is now possible to open popup window relative to the currrent window ```vim let g:fzf_layout = { 'window': { 'width': 0.9, 'height': 0.6, 'relative': v:true, 'yoffset': 1.0 } } ```

fzf 0.27.2

2021-06-01T08:06:37+00:00

- 16 base ANSI colors can be specified by their names ```sh fzf --color fg:3,fg+:11 fzf --color fg:yellow,fg+:bright-yellow ``` - Fix bug where `--read0` not properly displaying long lines

fzf 0.27.3

2021-10-15T15:07:44+00:00

- Preview window is `hidden` by default when there are `preview` bindings but `--preview` command is not given - Fixed bug where `{n}` is not properly reset on `reload` - Fixed bug where spinner is not displayed on `reload` - Enhancements in tcell renderer for Windows (#2616) - Vim plugin - `sinklist` is added as a synonym to `sink*` so that it's easier to add a function to a spec dictionary ```vim let spec = { 'source': 'ls', 'options': ['--multi', '--preview', 'cat {}'] } function spec.sinklist(matches) echom string(a:matches) endfunction call fzf#run(fzf#wrap(spec)) ``` - Vim 7 compatibility

fzf 0.28.0

2021-11-03T16:10:44+00:00

- Added `--header-first` option to print header before the prompt line ```sh fzf --header $'Welcome to fzf\n▔▔▔▔▔▔▔▔▔▔▔▔▔▔' --reverse --height 30% --border --header-first ``` - Added `--scroll-off=LINES` option (similar to `scrolloff` option of Vim) - You can set it to a very large number so that the cursor stays in the middle of the screen while scrolling ```sh fzf --scroll-off=5 fzf --scroll-off=999 ``` - Fixed bug where preview window is not updated on `reload` (#2644) - fzf on Windows will also use `$SHELL` to execute external programs - See #2638 and #2647 - Thanks to @rashil2000, @vovcacik, and @janlazo

fzf 0.29.0

2021-12-24T16:56:56+00:00

- Added `change-preview(...)` action to change the `--preview` command - cf. `preview(...)` is a one-off action that doesn't change the default preview command - Added `change-preview-window(...)` action - You can rotate through the different options separated by `|` ```sh fzf --preview 'cat {}' --preview-window right,40% \ --bind 'ctrl-/:change-preview-window(right,70%|down,40%,border-top|hidden|)' ``` - Fixed rendering of the prompt line when overflow occurs with `--info=inline`

fzf 0.30.0

2022-04-04T14:07:30+00:00

- Fixed cursor flickering over the screen by hiding it during rendering - Added `--ellipsis` option. You can take advantage of it to make fzf effectively search non-visible parts of the item. ```sh # Search against hidden line numbers on the far right nl /usr/share/dict/words | awk '{printf "%s%1000s\n", $2, $1}' | fzf --nth=-1 --no-hscroll --ellipsis='' | awk '{print $2}' ``` - Added `rebind` action for restoring bindings after `unbind` - [Switching between Ripgrep mode and fzf mode ](https://github.com/junegunn/fzf/blob/master/ADVANCED.md#switching-between-ripgrep-mode-and-fzf-mode) - Bug fixes and improvements

fzf 0.31.0

2022-07-21T14:07:12+00:00

- Added support for an alternative preview window layout that is activated when the size of the preview window is smaller than a certain threshold. ```sh # If the width of the preview window is smaller than 50 columns, # it will be displayed above the search window. fzf --preview 'cat {}' --preview-window 'right,50%,border-left,<50(up,30%,border-bottom)' # Or you can just hide it like so fzf --preview 'cat {}' --preview-window '<50(hidden)' ``` - fzf now uses SGR mouse mode to properly support mouse on larger terminals - You can now use characters that do not satisfy `unicode.IsGraphic` constraint for `--marker`, `--pointer`, and `--ellipsis`. Allows Nerd Fonts and stuff. Use at your own risk. - Bug fixes and improvements - Shell extension - `kill` completion now requires trigger sequence (`**`) for consistency

fzf 0.32.0

2022-08-02T12:59:41+00:00

- Updated the scoring algorithm - Different bonus points to different categories of word boundaries (listed higher to lower bonus point) - Word after whitespace characters or beginning of the string - Word after common delimiter characters (`/,:;|`) - Word after other non-word characters ```sh # foo/bar.sh` is preferred over `foo-bar.sh` on `bar` fzf --query=bar --height=4 << EOF foo-bar.sh foo/bar.sh EOF ``` - Added a new tiebreak `chunk` - Favors the line with shorter matched chunk. A chunk is a set of consecutive non-whitespace characters. - Unlike the default `length`, this scheme works well with tabular input ```sh # length prefers item #1, because the whole line is shorter, # chunk prefers item #2, because the matched chunk ("foo") is shorter fzf --height=6 --header-lines=2 --tiebreak=chunk --reverse --query=fo << "EOF" N | Field1 | Field2 | Field3 - | ------ | ------ | ------ 1 | hello | foobar | baz 2 | world | foo | bazbaz EOF ``` - If the input does not contain any spaces, `chunk` is equivalent to `length`. But we're not going to set it as the default because it is computationally more expensive. - Bug fixes and improvements

fzf 0.32.1

2022-08-08T15:01:15+00:00

- Fixed incorrect ordering of `--tiebreak=chunk` - fzf-tmux will show fzf border instead of tmux popup border (requires tmux 3.3) ```sh fzf-tmux -p70% fzf-tmux -p70% --color=border:bright-red fzf-tmux -p100%,60% --color=border:bright-yellow --border=horizontal --padding 1,5 --margin 1,0 fzf-tmux -p70%,100% --color=border:bright-green --border=vertical # Key bindings (CTRL-T, CTRL-R, ALT-C) will use these options export FZF_TMUX_OPTS='-p100%,60% --color=border:green --border=horizontal --padding 1,5 --margin 1,0' ```

fzf 0.33.0

2022-08-28T22:26:40+00:00

- Added `--scheme=[default|path|history]` option to choose scoring scheme - (Experimental) - We updated the scoring algorithm in 0.32.0, however we have learned that this new scheme (`default`) is not always giving the optimal result - `path`: Additional bonus point is only given to the the characters after path separator. You might want to choose this scheme if you have many files with spaces in their paths. - `history`: No additional bonus points are given so that we give more weight to the chronological ordering. This is equivalent to the scoring scheme before 0.32.0. This also sets `--tiebreak=index`. - ANSI color sequences with colon delimiters are now supported. ```sh printf "\e[38;5;208mOption 1\e[m\nOption 2" | fzf --ansi printf "\e[38:5:208mOption 1\e[m\nOption 2" | fzf --ansi ``` - Support `border-{up,down}` as the synonyms for `border-{top,bottom}` in `--preview-window` - Added support for ANSI `strikethrough` ```sh printf "\e[9mdeleted" | fzf --ansi fzf --color fg+:strikethrough ```

fzf 0.34.0

2022-09-28T14:30:15+00:00

- Added support for adaptive `--height`. If the `--height` value is prefixed with `~`, fzf will automatically determine the height in the range according to the input size. ```sh seq 1 | fzf --height ~70% --border --padding 1 --margin 1 seq 10 | fzf --height ~70% --border --padding 1 --margin 1 seq 100 | fzf --height ~70% --border --padding 1 --margin 1 ``` - There are a few limitations - Not compatible with percent top/bottom margin/padding ```sh # This is not allowed (top/bottom margin in percent value) fzf --height ~50% --border --margin 5%,10% # This is allowed (top/bottom margin in fixed value) fzf --height ~50% --border --margin 2,10% ``` - fzf will not start until it can determine the right height for the input ```sh # fzf will open immediately (sleep 2; seq 10) | fzf --height 50% # fzf will open after 2 seconds (sleep 2; seq 10) | fzf --height ~50% (sleep 2; seq 1000) | fzf --height ~50% ``` - Fixed tcell renderer used to render full-screen fzf on Windows - `--no-clear` is deprecated. Use `reload` action instead.

fzf 0.35.0

2022-11-11T16:00:38+00:00

Putting it all together.. ```sh # With http://metaphorpsum.com/ and https://github.com/busyloop/lolcat label1=$(curl -s http://metaphorpsum.com/sentences/1 | lolcat -f) label2=$(curl -s http://metaphorpsum.com/sentences/1 | lolcat -f) # Using colors from 'cosmic_latte' # (See https://github.com/junegunn/fzf/blob/master/ADVANCED.md#generating-fzf-color-theme-from-vim-color-schemes) fzf --border=double \ --border-label="╣ ${label1} ╠" --border-label-pos=-3,bottom \ --color=bg+:#2b3740,bg:#202a31,spinner:#7d9761,hl:#898f9e,fg:#abb0c0,header:#898f9e,info:#459d90 \ --color=pointer:#7d9761,marker:#7d9761,fg+:#abb0c0,prompt:#7d9761,hl+:#7d9761,border:#2b3740,label:#2b3740 \ --preview='lolcat -f {}' --preview-label="┓ ${label2} ┏" \ --preview-window=top,border-bold \ --separator=$(lolcat -f -F 1.4 <<< ╸╸╸╸╸╸╸╸╸╸╸╸╸╸) ``` ---- - Added `start` event that is triggered only once when fzf finder starts. Since fzf consumes the input stream asynchronously, the input list is not available unless you use `--sync`. ```sh seq 100 | fzf --multi --sync --bind 'start:last+select-all+preview(echo welcome)' ``` - Added `--border-label` and `--border-label-pos` for putting label on the border ```sh # ANSI color codes are supported # (with https://github.com/busyloop/lolcat) label=$(curl -s http://metaphorpsum.com/sentences/1 | lolcat -f) # Border label at the center fzf --height=10 --border --border-label="╢ $label ╟" --color=label:italic:black # Left-aligned (positive integer) fzf --height=10 --border --border-label="╢ $label ╟" --border-label-pos=3 --color=label:italic:black # Right-aligned (negative integer) on the bottom line (:bottom) fzf --height=10 --border --border-label="╢ $label ╟" --border-label-pos=-3:bottom --color=label:italic:black ``` - Also added `--preview-label` and `--preview-label-pos` for the border of the preview window ```sh fzf --preview 'cat {}' --border --preview-label=' Preview ' --preview-label-pos=2 ``` - Info panel (match counter) will be followed by a horizontal separator by default - Use `--no-separator` or `--separator=''` to hide the separator - You can specify an arbitrary string that is repeated to form the horizontal separator. e.g. `--separator=╸` - The color of the separator can be customized via `--color=separator:...` - ANSI color codes are also supported ```sh fzf --separator=╸ --color=separator:green fzf --separator=$(lolcat -f -F 1.4 <<< ▁▁▂▃▄▅▆▆▅▄▃▂▁▁) --info=inline ``` - Added `--border=bold` and `--border=double` along with `--preview-window=border-bold` and `--preview-window=border-double`

fzf 0.35.1

2022-11-18T11:45:18+00:00

- Fixed a bug where fzf with `--tiebreak=chunk` crashes on inverse match query - Fixed a bug where clicking above fzf would paste escape sequences

fzf 0.36.0

2023-01-16T16:51:13+00:00

- Added `--listen=HTTP_PORT` option to start HTTP server. It allows external processes to send actions to perform via POST method. ```sh # Start HTTP server on port 6266 fzf --listen 6266 # Send actions to the server curl localhost:6266 -d 'reload(seq 100)+change-prompt(hundred> )' ``` - Added draggable scrollbar to the main search window and the preview window ```sh # Hide scrollbar fzf --no-scrollbar # Customize scrollbar fzf --scrollbar ┆ --color scrollbar:blue ``` - New event - Added `load` event that is triggered when the input stream is complete and the initial processing of the list is complete. ```sh # Change the prompt to "loaded" when the input stream is complete (seq 10; sleep 1; seq 11 20) | fzf --prompt 'Loading> ' --bind 'load:change-prompt:Loaded> ' # You can use it instead of 'start' event without `--sync` if asynchronous # trigger is not an issue. (seq 10; sleep 1; seq 11 20) | fzf --bind 'load:last' ``` - New actions - Added `pos(...)` action to move the cursor to the numeric position - `first` and `last` are equivalent to `pos(1)` and `pos(-1)` respectively ```sh # Put the cursor on the 10th item seq 100 | fzf --sync --bind 'start:pos(10)' # Put the cursor on the 10th to last item seq 100 | fzf --sync --bind 'start:pos(-10)' ``` - Added `reload-sync(...)` action which replaces the current list only after the reload process is complete. This is useful when the command takes a while to produce the initial output and you don't want fzf to run against an empty list while the command is running. ```sh # You can still filter and select entries from the initial list for 3 seconds seq 100 | fzf --bind 'load:reload-sync(sleep 3; seq 1000)+unbind(load)' ``` - Added `next-selected` and `prev-selected` actions to move between selected items ```sh # `next-selected` will move the pointer to the next selected item below the current line # `prev-selected` will move the pointer to the previous selected item above the current line seq 10 | fzf --multi --bind ctrl-n:next-selected,ctrl-p:prev-selected # Both actions respect --layout option seq 10 | fzf --multi --bind ctrl-n:next-selected,ctrl-p:prev-selected --layout reverse ``` - Added `change-query(...)` action that simply changes the query string to the given static string. This can be useful when used with `--listen`. ```sh curl localhost:6266 -d "change-query:$(date)" ``` - Added `transform-prompt(...)` action for transforming the prompt string using an external command ```sh # Press space to change the prompt string using an external command # (only the first line of the output is taken) fzf --bind 'space:reload(ls),load:transform-prompt(printf "%s> " "$(date)")' ``` - Added `transform-query(...)` action for transforming the query string using an external command ```sh # Press space to convert the query to uppercase letters fzf --bind 'space:transform-query(tr "[:lower:]" "[:upper:]" <<< {q})' # Bind it to 'change' event for automatic conversion fzf --bind 'change:transform-query(tr "[:lower:]" "[:upper:]" <<< {q})' # Can only type numbers fzf --bind 'change:transform-query(sed "s/[^0-9]//g" <<< {q})' ``` - `put` action can optionally take an argument string ```sh # a will put 'alpha' on the prompt, ctrl-b will put 'bravo' fzf --bind 'a:put+put(lpha),ctrl-b:put(bravo)' ``` - Added color name `preview-label` for `--preview-label` (defaults to `label` for `--border-label`) - Better support for (Windows) terminals where each box-drawing character takes 2 columns. Set `RUNEWIDTH_EASTASIAN` environment variable to `1`. - On Vim, the variable will be automatically set if `&ambiwidth` is `double` - Behavior changes - fzf will always execute the preview command if the command template contains `{q}` even when it's empty. If you prefer the old behavior, you'll have to check if `{q}` is empty in your command. ```sh # This will show // even when the query is empty : | fzf --preview 'echo /{q}/' # But if you don't want it, : | fzf --preview '[ -n {q} ] || exit; echo /{q}/' ``` - `double-click` will behave the same as `enter` unless otherwise specified, so you don't have to repeat the same action twice in `--bind` in most cases. ```sh # No need to bind 'double-click' to the same action fzf --bind 'enter:execute:less {}' # --bind 'double-click:execute:less {}' ``` - If the color for `separator` is not specified, it will default to the color for `border`. Same holds true for `scrollbar`. This is to reduce the number of configuration items required to achieve a consistent color scheme. - If `follow` flag is specified in `--preview-window` option, fzf will automatically scroll to the bottom of the streaming preview output. But when the user manually scrolls the window, the following stops. With this version, fzf will resume following if the user scrolls the window to the bottom. - Default border style on Windows is changed to `sharp` because some Windows terminals are not capable of displaying `rounded` border characters correctly. - Minor bug fixes and improvements

fzf 0.37.0

2023-01-24T13:18:39+00:00

- Added a way to customize the separator of inline info ```sh fzf --info 'inline: ╱ ' --prompt '╱ ' --color prompt:bright-yellow ``` - New event - `focus` - Triggered when the focus changes due to a vertical cursor movement or a search result update ```sh fzf --bind 'focus:transform-preview-label:echo [ {} ]' --preview 'cat {}' # Any action bound to the event runs synchronously and thus can make the interface sluggish # e.g. lolcat isn't one of the fastest programs, and every cursor movement in # fzf will be noticeably affected by its execution time fzf --bind 'focus:transform-preview-label:echo [ {} ] | lolcat -f' --preview 'cat {}' # Beware not to introduce an infinite loop seq 10 | fzf --bind 'focus:up' --cycle ``` - New actions - `change-border-label` - `change-preview-label` - `transform-border-label` - `transform-preview-label` - Bug fixes and improvements

fzf 0.38.0

2023-02-15T14:27:26+00:00

- New actions - `become(...)` - Replace the current fzf process with the specified command using `execve(2)` system call. See https://github.com/junegunn/fzf#turning-into-a-different-process for more information. ```sh # Open selected files in Vim fzf --multi --bind 'enter:become(vim {+})' # Open the file in Vim and go to the line git grep --line-number . | fzf --delimiter : --nth 3.. --bind 'enter:become(vim {1} +{2})' ``` - This action is not supported on Windows - `show-preview` - `hide-preview` - Bug fixes - `--preview-window 0,hidden` should not execute the preview command until `toggle-preview` action is triggered

fzf 0.39.0

2023-04-02T14:37:51+00:00

- Added `one` event that is triggered when there's only one match ```sh # Automatically select the only match seq 10 | fzf --bind one:accept ``` - Added `--track` option that makes fzf track the current selection when the result list is updated. This can be useful when browsing logs using fzf with sorting disabled. ```sh git log --oneline --graph --color=always | nl | fzf --ansi --track --no-sort --layout=reverse-list ``` - If you use `--listen` option without a port number fzf will automatically allocate an available port and export it as `$FZF_PORT` environment variable. ```sh # Automatic port assignment fzf --listen --bind 'start:execute-silent:echo $FZF_PORT > /tmp/fzf-port' # Say hello curl "localhost:$(cat /tmp/fzf-port)" -d 'preview:echo Hello, fzf is listening on $FZF_PORT.' ``` - A carriage return and a line feed character will be rendered as dim ␍ and ␊ respectively. ```sh printf "foo\rbar\nbaz" | fzf --read0 --preview 'echo {}' ``` - fzf will stop rendering a non-displayable character as a space. This will likely cause less glitches in the preview window. ```sh fzf --preview 'head -1000 /dev/random' ``` - Bug fixes and improvements

fzf 0.40.0

2023-04-30T17:12:27+00:00

- Added `zero` event that is triggered when there's no match - New actions - Added `track` action which makes fzf track the current item when the search result is updated. If the user manually moves the cursor, or the item is not in the updated search result, tracking is automatically disabled. Tracking is useful when you want to see the surrounding items by deleting the query string. ```sh # Narrow down the list with a query, point to a command, # and hit CTRL-T to see its surrounding commands. export FZF_CTRL_R_OPTS=" --preview 'echo {}' --preview-window up:3:hidden:wrap --bind 'ctrl-/:toggle-preview' --bind 'ctrl-t:track+clear-query' --bind 'ctrl-y:execute-silent(echo -n {2..} | pbcopy)+abort' --color header:italic --header 'Press CTRL-Y to copy command into clipboard'" ``` - Added `change-header(...)` - Added `transform-header(...)` - Added `toggle-track` action - Fixed `--track` behavior when used with `--tac` - However, using `--track` with `--tac` is not recommended. The resulting behavior can be very confusing. - Bug fixes and improvements

fzf 0.41.0

2023-05-25T15:32:09+00:00

- Added color name `preview-border` and `preview-scrollbar` - Added new border style `block` which uses [block elements](https://en.wikipedia.org/wiki/Block_Elements) - `--scrollbar` can take two characters, one for the main window, the other for the preview window - Putting it altogether: ```sh fzf-tmux -p 80% --padding 1,2 --preview 'bat --style=plain --color=always {}' \ --color 'bg:237,bg+:235,gutter:237,border:238,scrollbar:236' \ --color 'preview-bg:235,preview-border:236,preview-scrollbar:234' \ --preview-window 'border-block' --border block --scrollbar '▌▐' ``` - Bug fixes and improvements

fzf 0.41.1

2023-05-27T06:57:29+00:00

- Fixed a bug where preview window is not updated when `--disabled` is set and a reload is triggered by `change:reload` binding

fzf 0.42.0

2023-06-14T15:42:35+00:00

- Added new info style: `--info=right` - Added new info style: `--info=inline-right` - Added new border style `thinblock` which uses symbols for legacy computing [one eighth block elements](https://en.wikipedia.org/wiki/Symbols_for_Legacy_Computing) - Similarly to `block`, this style is suitable when using a different background color because the window is completely contained within the border. - This style may not render correctly depending on the font and the terminal emulator. - `thinblock` - ```sh BAT_THEME=GitHub fzf --info=right --border=thinblock --preview-window=border-thinblock \ --margin=3 --scrollbar=▏▕ --preview='bat --color=always --style=numbers {}' \ --color=light,query:238,fg:238,bg:251,bg+:249,gutter:251,border:248,preview-bg:253 ``` - `block` - ```sh BAT_THEME=GitHub fzf --info=right --border=block --preview-window=border-block \ --margin=3 --scrollbar=▌▐ --separator=━ --preview='bat --color=always --style=numbers {}' \ --color=light,query:238,fg:238,bg:251,bg+:249,gutter:251,border:248,preview-bg:253,preview-border:252 ```

fzf 0.43.0

2023-10-14T17:06:23+00:00

- (Experimental) Added support for Kitty image protocol in the preview window (currently not supported on Windows) ```sh fzf --preview=' if file --mime-type {} | grep -qF image/; then # --transfer-mode=memory is the fastest option but if you want fzf to be able # to redraw the image on terminal resize or on "change-preview-window", # you need to use --transfer-mode=stream. kitty icat --clear --transfer-mode=memory --stdin=no --place=${FZF_PREVIEW_COLUMNS}x${FZF_PREVIEW_LINES}@0x0 {} | sed \$d else bat --color=always {} fi ' ``` - (Experimental) `--listen` server can report program state in JSON format (`GET /`) ```sh # fzf server started in "headless" mode fzf --listen 6266 2> /dev/null # Get program state curl localhost:6266 | jq . # Increase the number of items returned (default: 100) curl localhost:6266?limit=1000 | jq . ``` - `--listen` server can be secured by setting `$FZF_API_KEY` environment variable. ```sh export FZF_API_KEY="$(head -c 32 /dev/urandom | base64)" # Server fzf --listen 6266 # Client curl localhost:6266 -H "x-api-key: $FZF_API_KEY" -d 'change-query(yo)' ``` - Added `toggle-header` action - Added mouse events for `--bind` - `scroll-up` (bound to `up`) - `scroll-down` (bound to `down`) - `shift-scroll-up` (bound to `toggle+up`) - `shift-scroll-down` (bound to `toggle+down`) - `shift-left-click` (bound to `toggle`) - `shift-right-click` (bound to `toggle`) - `preview-scroll-up` (bound to `preview-up`) - `preview-scroll-down` (bound to `preview-down`) ```sh # Twice faster scrolling both in the main window and the preview window fzf --bind 'scroll-up:up+up,scroll-down:down+down' \ --bind 'preview-scroll-up:preview-up+preview-up' \ --bind 'preview-scroll-down:preview-down+preview-down' \ --preview 'cat {}' ``` - Added `offset-up` and `offset-down` actions ```sh # Scrolling will behave similarly to CTRL-E and CTRL-Y of vim fzf --bind scroll-up:offset-up,scroll-down:offset-down \ --bind ctrl-y:offset-up,ctrl-e:offset-down \ --scroll-off=5 ``` - Shell extensions - Updated bash completion for fzf options - bash key bindings no longer requires perl; it will use awk or mawk instead if perl is not found - Basic context-aware completion for ssh command - Applied `--scheme=path` for better ordering of the result - Bug fixes and improvements

fzf 0.44.0

2023-11-12T13:10:54+00:00

- (Experimental) Sixel image support in preview window (not available on Windows) - [bin/fzf-preview.sh](bin/fzf-preview.sh) is added to demonstrate how to display an image using Kitty image protocol or Sixel. You can use it like so: ```sh fzf --preview='fzf-preview.sh {}' ``` - (Experimental) iTerm2 inline image protocol support in preview window (not available on Windows) ```sh # Using https://iterm2.com/utilities/imgcat fzf --preview 'imgcat -W $FZF_PREVIEW_COLUMNS -H $FZF_PREVIEW_LINES {}' ``` - HTTP server can be configured to accept remote connections ```sh # FZF_API_KEY is required for a non-localhost listen address export FZF_API_KEY="$(head -c 32 /dev/urandom | base64)" fzf --listen 0.0.0.0:6266 ``` - To allow remote process execution, use `--listen-unsafe` instead (`execute*`, `reload*`, `become`, `preview`, `change-preview`, `transform-*`) ```sh fzf --listen-unsafe 0.0.0.0:6266 ``` - Bug fixes

fzf 0.44.1

2023-11-17T10:20:41+00:00

- Fixed crash when preview window is hidden on `focus` event

fzf 0.45.0

2024-01-01T06:41:32+00:00

- Added `transform` action to conditionally perform a series of actions ```sh # Disallow selecting an empty line echo -e "1. Hello\n2. Goodbye\n\n3. Exit" | fzf --height '~100%' --reverse --header 'Select one' \ --bind 'enter:transform:[[ -n {} ]] && echo accept || echo "change-header:Invalid selection"' # Move cursor past the empty line echo -e "1. Hello\n2. Goodbye\n\n3. Exit" | fzf --height '~100%' --reverse --header 'Select one' \ --bind 'enter:transform:[[ -n {} ]] && echo accept || echo "change-header:Invalid selection"' \ --bind 'focus:transform:[[ -n {} ]] && exit; [[ {fzf:action} =~ up$ ]] && echo up || echo down' # A single key binding to toggle between modes fd --type file | fzf --prompt 'Files> ' \ --header 'CTRL-T: Switch between Files/Directories' \ --bind 'ctrl-t:transform:[[ ! {fzf:prompt} =~ Files ]] && echo "change-prompt(Files> )+reload(fd --type file)" || echo "change-prompt(Directories> )+reload(fd --type directory)"' ``` - Added placeholder expressions - `{fzf:action}` - The name of the last action performed - `{fzf:prompt}` - Prompt string (including ANSI color codes) - `{fzf:query}` - Synonym for `{q}` - Added support for negative height ```sh # Terminal height minus 1, so you can still see the command line fzf --height=-1 ``` - This handles a terminal resize better than `--height=$(($(tput lines) - 1))` - Added `accept-or-print-query` action that acts like `accept` but prints the current query when there's no match for the query ```sh # You can make CTRL-R paste the current query when there's no match export FZF_CTRL_R_OPTS='--bind enter:accept-or-print-query' ``` - Note that there are alternative ways to implement the same strategy ```sh # 'become' is apparently more versatile but it's not available on Windows. export FZF_CTRL_R_OPTS='--bind "enter:become:if [ -z {} ]; then echo {q}; else echo {}; fi"' # Using the new 'transform' action export FZF_CTRL_R_OPTS='--bind "enter:transform:[ -z {} ] && echo print-query || echo accept"' ``` - Added `show-header` and `hide-header` actions - Bug fixes