# fzf

From ArchWiki
Jump to navigation Jump to search
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

This article or section needs expansion.

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., `git commit <CTRL+T>`, select a few files using `<TAB>`, finally `<Return>`)
- `<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 don't 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` 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

## Alternatives

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

Categories:

- Search
- Commands

Hidden category:

- Pages or sections flagged with Template:Expansion