Skip to content

0.36.0

Compare
Choose a tag to compare
@junegunn junegunn released this 16 Jan 16:51
· 679 commits to master since this release
0.36.0
2023011
  • 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'
  • 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
      # 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 and prev-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 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.
      # 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.
      # 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