- Added
--listen=HTTP_PORT
option to start HTTP server. It allows external
processes to send actions to perform via POST method.# 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
# 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.# 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'
- Added
- New actions
- Added
pos(...)
action to move the cursor to the numeric positionfirst
andlast
are equivalent topos(1)
andpos(-1)
respectively
# 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.# 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
andprev-selected
actions to move between selected
items# `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
.curl localhost:6266 -d "change-query:$(date)"
- Added
transform-prompt(...)
action for transforming the prompt string
using an external command# 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# 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# a will put 'alpha' on the prompt, ctrl-b will put 'bravo' fzf --bind 'a:put+put(lpha),ctrl-b:put(bravo)'
- Added
- Added color name
preview-label
for--preview-label
(defaults tolabel
for--border-label
) - Better support for (Windows) terminals where each box-drawing character
takes 2 columns. SetRUNEWIDTH_EASTASIAN
environment variable to1
.- On Vim, the variable will be automatically set if
&ambiwidth
isdouble
- On Vim, the variable will be automatically set if
- 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.# 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 asenter
unless otherwise specified,
so you don't have to repeat the same action twice in--bind
in most cases.# 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 forborder
. Same holds true forscrollbar
. 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 displayingrounded
border
characters correctly.
- fzf will always execute the preview command if the command template
- Minor bug fixes and improvements