fzf

From ArchWiki
The printable version is no longer supported and may have rendering errors. Please update your browser bookmarks and please use the default browser print function instead.

fzf is a general-purpose command-line fuzzy finder.

Installation

Install the fzf package. The development version is fzf-gitAUR.

Configuration

Tango-view-fullscreen.pngThis article or section needs expansion.Tango-view-fullscreen.png

Reason: It should be at least mentioned that shell completer is not the only usecase which requires configuration. (Discuss in Talk:Fzf)

Shells

Optional fzf keybindings and completion are available for various shells:

  • Ctrl+t list files+folders in current directory (e.g., type git add , press Ctrl+t, select a few files using Tab, finally Enter)
  • Ctrl+r search history of shell commands
  • Alt+c fuzzy change directory

Bash

Source the desired files from your .bashrc:

  • /usr/share/fzf/key-bindings.bash
  • /usr/share/fzf/completion.bash

Zsh

Source the desired files from your .zshrc (after vi-mode, if using that, too):

  • /usr/share/fzf/key-bindings.zsh
  • /usr/share/fzf/completion.zsh

fish

For fish, keybindings are in:

  • /usr/share/fish/vendor_functions.d/fzf_key_bindings.fish

fish will source this by default but the bindings have to be enabled manually:

~/.config/fish/functions/fish_user_key_bindings.fish
function fish_user_key_bindings
	fzf_key_bindings
end

fzf completion in fish can be enabled with custom functions: https://github.com/junegunn/fzf/wiki/Examples-(fish)

Vim

The basic Vim plugin is already included within the package and installed to Vim's global plugin directory. Thus, you do not need to add anything to your .vimrc to be able to use it. It only provides the FZF command, though. There is an additional Vim plugin made by the author of fzf that defines some convenience functions, see https://github.com/junegunn/fzf.vim.

Arch specific fzf uses

Pacman

Try this to fuzzy-search through all available packages, with package info shown in a preview window, and then install selected packages:

$ pacman -Slq | fzf --multi --preview 'pacman -Si {1}' | xargs -ro sudo pacman -S

List all your installed packages, and then remove selected packages:

$ pacman -Qq | fzf --multi --preview 'pacman -Qi {1}' | xargs -ro sudo pacman -Rns

If you want to add package file list in preview – may be a bit slower updating preview window (make sure you run pacman -Fy with root privileges at least once before invocation to sync the pacman file database):

$ pacman -Slq | fzf --multi --preview 'cat <(pacman -Si {1}) <(pacman -Fl {1} | awk "{print \$2}")' | xargs -ro sudo pacman -S

The paruzAUR package also provides a fzf terminal UI for paruAUR and pacman.

Alternatives

  • skim – fuzzy finder written in Rust
  • fzy – fuzzy finder/selector