fzf for MAC

Free, open-source command-line fuzzy finder for files, command history, processes and any list.

fzf Overview

fzf is a free, open-source fuzzy finder for the command line. Give it any list, such as files, command history, Git branches or running processes, and type a few letters: fzf shows the closest matches instantly, even when the letters are not next to each other, and returns the one you pick. It is a single small program that handles millions of items in milliseconds. fzf is made by Junegunn Choi and released under the MIT license.

fzf runs in Terminal on Apple Silicon and Intel Macs and installs with Homebrew (brew install fzf). Its shell integration for Zsh, Bash and Fish adds three handy shortcuts: Control-T to insert files, Control-R to search command history, and Option-C (Alt-C) to jump to a folder. It also has plugins for Vim and Neovim.

Key Features

fzf works with any list you can print in Terminal.

  • Fuzzy matching: find items by typing a few letters in any order of closeness.
  • Fast: handles millions of items in milliseconds.
  • Single program: one small file with no dependencies.
  • Shell shortcuts: Control-T for files, Control-R for history and Alt-C to change folder.
  • Fuzzy completion: type ** and press Tab to complete paths and more.
  • Preview window: show a file's contents or other details next to the list.
  • Vim and Neovim: plugins to search files, buffers and more inside the editor.
  • Highly customizable: key bindings, layout, colors and actions.

What’s New in Version 0.74.5

fzf 0.74.5 fixes several bugs.

  • Fixed --popup unzooming the window when opened over a zoomed tmux pane on tmux 3.8 or later
  • Fixed --gap-line cutting a character cluster at the end of a line
  • Fixed unrecognized escape sequences leaking into the query
  • Fixed a key being lost when it arrived together with an escape sequence
  • Fixed the focus event not firing after a reload

fzf FAQ

Is fzf free?

Yes. fzf is free and open source, released under the MIT license.

How do I install fzf on a Mac?

Run brew install fzf in Terminal if you use Homebrew. Ready-made programs for Apple Silicon and Intel Macs are also on its GitHub releases page.

How do I turn on fzf's keyboard shortcuts in Zsh?

Add the line source <(fzf --zsh) to your ~/.zshrc file and open a new Terminal window. For Bash, use eval "$(fzf --bash)" in ~/.bashrc; for Fish, fzf --fish | source.

What do Control-T, Control-R and Alt-C do?

Control-T inserts the files or folders you pick onto the command line, Control-R searches your command history, and Alt-C moves to the folder you pick. On a Mac, Alt is the Option key.

What is fuzzy matching?

Fuzzy matching finds items that contain the letters you type in order, even if other letters come between them. For example, typing dlrp can find download-report.txt.

Can fzf show a preview of files?

Yes. The --preview option shows a file's contents, or the output of any command, next to the list as you move through it.

Can I use fzf inside Vim or Neovim?

Yes. fzf comes with a basic Vim plugin, and the separate fzf.vim plugin adds commands to search files, buffers, lines and more.

Can fzf search more than files?

Yes. fzf works on any list printed to it, such as Git branches, running processes or command history. You pipe the list into fzf and it returns your choice.

Can I make fzf use fd or ripgrep for file search?

Yes. Set FZF_DEFAULT_COMMAND or FZF_CTRL_T_COMMAND to an fd or ripgrep command, and fzf uses its file list, which also respects .gitignore.

Where does the fzf download on fzf.FULLMAC.app come from?

The download button leads to fzf's official GitHub page at https://github.com/junegunn/fzf, with the install instructions and releases. fzf.FULLMAC.app does not change or repackage the tool.

Similar Apps

FULLMAC.app does not host this app. Download buttons lead to the developer’s own pages.