Search mode

-x, --extended

Extended-search mode. Since 0.10.9, this is enabled by default. You can disable it with +x or --no-extended.

-e, --exact

Enable exact-match

-i

Case-insensitive match (default: smart-case match)

+i

Case-sensitive match

--literal

Do not normalize latin script letters for matching.

--algo=TYPE

Fuzzy matching algorithm (default: v2)

v2 Optimal scoring algorithm (quality)
v1 Faster but not guaranteed to find the optimal result (performance)

-n, --nth=N[,..]

Comma-separated list of field index expressions for limiting search scope. See FIELD INDEX EXPRESSION for the details.

--with-nth=N[,..]

Transform the presentation of each line using field index expressions

-d, --delimiter=STR

Field delimiter regex for --nth and --with-nth (default: AWK-style)

--disabled

Do not perform search. With this option, fzf becomes a simple selector interface rather than a "fuzzy finder". You can later enable the search using enable-search or toggle-search action.

Search result

+s, --no-sort

Do not sort the result

--tac

Reverse the order of the input

--tiebreak=CRI[,..]

Comma-separated list of sort criteria to apply when the scores are tied.

length Prefers line with shorter length
begin Prefers line with matched substring closer to the beginning
end Prefers line with matched substring closer to the end
index Prefers line that appeared earlier in the input stream

- Each criterion should appear only once in the list
- index is only allowed at the end of the list
- index is implicitly appended to the list when not specified
- Default is length (or equivalently length,index)
- If end is found in the list, fzf will scan each line backwards

Interface

-m, --multi

Enable multi-select with tab/shift-tab. It optionally takes an integer argument which denotes the maximum number of items that can be selected.

+m, --no-multi

Disable multi-select

--no-mouse

Disable mouse

--bind=KEYBINDS

Comma-separated list of custom key bindings. See KEY/EVENT BINDINGS for the details.

--cycle

Enable cyclic scroll

--keep-right

Keep the right end of the line visible when it's too long. Effective only when the query string is empty.

--no-hscroll

Disable horizontal scroll

--hscroll-off=COL

Number of screen columns to keep to the right of the highlighted substring (default: 10). Setting it to a large value will cause the text to be positioned on the center of the screen.

--filepath-word

Make word-wise movements and actions respect path separators. The following actions are affected:

backward-kill-word
backward-word
forward-word
kill-word

--jump-labels=CHARS

Label characters for jump and jump-accept

Layout

--height=HEIGHT[%]

Display fzf window below the cursor with the given height instead of using the full screen.

--min-height=HEIGHT

Minimum height when --height is given in percent (default: 10). Ignored when --height is not specified.

--layout=LAYOUT

Choose the layout (default: default)

default Display from the bottom of the screen
reverse Display from the top of the screen
reverse-list Display from the top of the screen, prompt at the bottom

--reverse

A synonym for --layout=reverse

--border[=STYLE]

Draw border around the finder

rounded Border with rounded corners (default)
sharp Border with sharp corners
horizontal Horizontal lines above and below the finder
vertical Vertical lines on each side of the finder
top
bottom
left
right
none

--no-unicode

Use ASCII characters instead of Unicode box drawing characters to draw border

--margin=MARGIN

Comma-separated expression for margins around the finder.

--padding=PADDING

Comma-separated expression for padding inside the border. Padding is distinguishable from margin only when --border option is used.

e.g. fzf --margin 5% --padding 5% --border --preview 'cat {}' \ --color bg:#222222,preview-bg:#333333

--info=STYLE

Determines the display style of finder info.

default Display on the next line to the prompt
inline Display on the same line
hidden Do not display finder info

--no-info

A synonym for --info=hidden

--prompt=STR

Input prompt (default: '> ')

--pointer=STR

Pointer to the current line (default: '>')

--marker=STR

Multi-select marker (default: '>')

--header=STR

The given string will be printed as the sticky header. The lines are displayed in the given order from top to bottom regardless of --layout option, and are not affected by --with-nth. ANSI color codes are processed even when --ansi is not set.

--header-lines=N

The first N lines of the input are treated as the sticky header. When --with-nth is set, the lines are transformed just like the other lines that follow.

Display

--ansi

Enable processing of ANSI color codes

--tabstop=SPACES

Number of spaces for a tab character (default: 8)

--color=[BASE_SCHEME][,COLOR_NAME[:ANSI_COLOR][:ANSI_ATTRIBUTES]]...

Color configuration. The name of the base color scheme is followed by custom color mappings.

--no-bold

Do not use bold text

--black

Use black background

History

--history=HISTORY_FILE

Load search history from the specified file and update the file on completion. When enabled, CTRL-N and CTRL-P are automatically remapped to next-history and previous-history.

--history-size=N

Maximum number of entries in the history file (default: 1000). The file is automatically truncated when the number of the lines exceeds the value.

Preview

--preview=COMMAND

Execute the given command for the current line and display the result on the preview window. {} in the command is the placeholder that is replaced to the single-quoted string of the current line. To transform the replacement string, specify field index expressions between the braces (See FIELD INDEX EXPRESSION for the details).

--preview-window=[POSITION][,SIZE[%]][,border-BORDER_OPT][,[no]wrap][,[no]follow][,[no]cycle][,[no]hidden][,+SCROLL[OFFSETS][/DENOM]][,~HEADER_LINES][,default]

Scripting

-q, --query=STR

Start the finder with the given query

-1, --select-1

Automatically select the only match

-0, --exit-0

Exit immediately when there's no match

-f, --filter=STR

Filter mode. Do not start interactive finder. When used with --no-sort, fzf becomes a fuzzy-version of grep.

--print-query

Print query as the first line

--expect=KEY[,..]

Comma-separated list of keys that can be used to complete fzf in addition to the default enter key. When this option is set, fzf will print the name of the key pressed as the first line of its output (or as the second line if --print-query is also used). The line will be empty if fzf is completed with the default enter key. If --expect option is specified multiple times, fzf will expect the union of the keys. --no-expect will clear the list.

--read0

Read input delimited by ASCII NUL characters instead of newline characters

--print0

Print output delimited by ASCII NUL characters instead of newline characters

--no-clear

Do not clear finder interface on exit. If fzf was started in full screen mode, it will not switch back to the original screen, so you'll have to manually run tput rmcup to return. This option can be used to avoid flickering of the screen when your application needs to start fzf multiple times in order.

--sync

Synchronous search for multi-staged filtering. If specified, fzf will launch ncurses finder only after the input stream is complete.

--version

Display version information and exit

Note that most options have the opposite versions with --no- prefix.

Examples

Exact-match (quoted)

Anchored-match

Negation

Exact-match by default

OR operator

e.g. ^core go$ | rb$ | py$

AVAILABLE KEYS: (SYNONYMS)

AVAILABLE EVENTS:

backward-eof

AVAILABLE ACTIONS:

ACTION: DEFAULT BINDINGS (NOTES): abort ctrl-c ctrl-g ctrl-q esc accept enter double-click accept-non-empty (same as accept except that it prevents fzf from exiting without selection) backward-char ctrl-b left backward-delete-char ctrl-h bspace backward-delete-char/eof (same as backward-delete-char except aborts fzf if query is empty) backward-kill-word alt-bs backward-word alt-b shift-left beginning-of-line ctrl-a home cancel (clear query string if not empty, abort fzf otherwise) change-prompt(...) (change prompt to the given string) clear-screen ctrl-l clear-selection (clear multi-selection) close (close preview window if open, abort fzf otherwise) clear-query (clear query string) delete-char del delete-char/eof ctrl-d (same as delete-char except aborts fzf if query is empty) deselect deselect-all (deselect all matches) disable-search (disable search functionality) down ctrl-j ctrl-n down enable-search (enable search functionality) end-of-line ctrl-e end execute(...) (see below for the details) execute-silent(...) (see below for the details) first (move to the first match) forward-char ctrl-f right forward-word alt-f shift-right ignore jump (EasyMotion-like 2-keystroke movement) jump-accept (jump and accept) kill-line kill-word alt-d last (move to the last match) next-history (ctrl-n on --history) page-down pgdn page-up pgup half-page-down half-page-up preview(...) (see below for the details) preview-down shift-down preview-up shift-up preview-page-down preview-page-up preview-half-page-down preview-half-page-up preview-bottom preview-top previous-history (ctrl-p on --history) print-query (print query and exit) refresh-preview reload(...) (see below for the details) replace-query (replace query string with the current selection) select select-all (select all matches) toggle (right-click) toggle-all (toggle all matches) toggle+down ctrl-i (tab) toggle-in (--layout=reverse* ? toggle+up : toggle+down) toggle-out (--layout=reverse* ? toggle+down : toggle+up) toggle-preview toggle-preview-wrap toggle-search (toggle search functionality) toggle-sort toggle+up btab (shift-tab) unix-line-discard ctrl-u unix-word-rubout ctrl-w up ctrl-k ctrl-p up yank ctrl-y

ACTION COMPOSITION

e.g. fzf --multi --bind 'ctrl-a:select-all+accept' fzf --multi --bind 'ctrl-a:select-all' --bind 'ctrl-a:+accept'

ACTION ARGUMENT

e.g. fzf --bind 'ctrl-a:change-prompt(NewPrompt> )' fzf --bind 'ctrl-v:preview(cat {})' --preview-window hidden

If the argument contains parentheses, fzf may fail to parse the expression. In that case, you can use any of the following alternative notations to avoid parse errors.

action-name[...] action-name~...~ action-name!...! action-name@...@ action-name#...# action-name$...$ action-name%...% action-name^...^ action-name&...& action-name*...* action-name;...; action-name/.../ action-name|...| action-name:...

COMMAND EXECUTION

fzf --bind "enter:execute(less {})"

You can use the same placeholder expressions as in --preview.

fzf switches to the alternate screen when executing a command. However, if the command is expected to complete quickly, and you are not interested in its output, you might want to use execute-silent instead, which silently executes the command without the switching. Note that fzf will not be responsive until the command is complete. For asynchronous execution, start your command as a background process (i.e. appending &).

On *nix systems, fzf runs the command with $SHELL -c if SHELL is set, otherwise with sh -c, so in this case make sure that the command is POSIX-compliant.

RELOAD INPUT

See https://github.com/junegunn/fzf/issues/1750 for more info.

e.g. # Update the list of processes by pressing CTRL-R ps -ef | fzf --bind 'ctrl-r:reload(ps -ef)' --header 'Press CTRL-R to reload' \ --header-lines=1 --layout=reverse

# Integration with ripgrep RG_PREFIX="rg --column --line-number --no-heading --color=always --smart-case " INITIAL_QUERY="foobar" FZF_DEFAULT_COMMAND="$RG_PREFIX '$INITIAL_QUERY'" \ fzf --bind "change:reload:$RG_PREFIX {q} || true" \ --ansi --disabled --query "$INITIAL_QUERY"

PREVIEW BINDING

e.g.

# Default preview command with an extra preview binding fzf --preview 'file {}' --bind '?:preview:cat {}'

# A preview binding with no default preview command # (Preview window is initially empty) fzf --bind '?:preview:cat {}'

# Preview window hidden by default, it appears when you first hit '?' fzf --bind '?:preview:cat {}' --preview-window hidden