Linux

The fzf command

1. Introduction

When working with the command line, mostly every day no matter what operating system you are using, it is useful to have some tools/plugins that will make your work much easier. Tools and plugins, like fzf, are designed to facilitate your work through just a simple command instead of multiple instructions.

Statistically using autocomplete will reduce typing by 25%.

For example, auto-completion will save you most of the time when writing commands which could be considered a basic thing to have in your terminal. Having auto-completion tools is not about being lazy and not manually typing each line of code. Automating your process is the key to increasing your productivity.

2. What is the fzf command?

This is the best and most powerful command interactive Unix filter for command-line that can be used with any list, files, command history, processes, hostnames, bookmarks, git commits, and many more.

Link to the fzf GitHub project, you can find here.

3. How to install it?

This command is available to install on the following platforms: Unix, macOS, and even Windows.

fzf project consists of the following components:

  • fzf executable
  • fzf-tmux script for launching fzf in a tmux pane
  • shell extension
  • Vim/NeoVim plugin

3.1. Install fzf on Unix

To install this tool on Unix you have multiple options.

The first option is an external package manager called: HomeBrew (this is available for Unix and macOS). If you have this package manager you can run this command:

brew install fzf

The second option is cloning the git repository:

git clone --depth 1 https://github.com/junegunn/fzf.git ~/.fzf
~/.fzf/install

As a result of successful installation from the git repo you will see this output:

Output after a successful installation
Fig. 1: Output after a successful installation

The third option is with using the default package manager that Linux System offers or another package manager that you have, depending on the Linux distribution:

sudo apk add fzf

3.2. Install fzf on macOS

Installing on macOS you can use the above-mentioned package manager HomeBrew and run this command:

brew install fzf

Another way to install it on macOS is through MacPorts and running this command:

sudo port install fzf

3.3. Install fzf on Windows

On windows, there are pre-build binaries and you can download them from here. For this operating system, there are some limitations as the official documentation noted.

NOTE: If you want to install just the fzf executable you can just simply download it from here.

4. Shell key bindings

There are some shell key bindings that you can use to leverage the features of this tool.

  • CTRL + T – list files and folders in the current directory
  • CTRL + R – search history of shell commands
  • ALT + C – change directory

5. Filename autocomplete

Particularly to use the autocomplete feature for filenames, you will have just type vim (or vim ** in case the previous command doesn’t work) and TAB. A new panel will show up in your command line showing all the existing files from your current directory. To navigate between results you have to use the up and down arrows. After you choose one you have to press ENTER. The new directory will be selected to be used for vim command.

Filename autocomplete in the current directory.
Fig. 2: Filename autocomplete in the current directory

6. Kill command autocomplete

Killing a process is similar to the searching files presented in the previous section. You just have to type kill -9 (or kill -9 ** in case the previous command doesn’t work) and TAB. A new panel will be open in the current command line showing all the active processes. After you select a value you have to press ENTER. That newly selected value will be used in the kill command.

Output of the kill command autocomplete
Fig. 3: Output of the kill command autocomplete

7. Using different search modes

This command besides the above things mentioned has some searching criteria syntax that will help you to customize your search.

  • fuzzy match the pattern word to lookup: cat test.txt | fzf -f sbt
  • match exactly the given word: cat test.txt | fzf -f "'sbt"
  • items that start with the given word: cat test.txt | fzf -f ^sbt
  • items that end with that given word: cat test.txt | fzf -f .txt$
  • negation that given items don’t include the given word: cat test.txt | fzf -f ‘!sbt’
  • items don’t start with the given word: cat test.txt | fzf -f ‘!^sbt’
  • items don’t end with the given word: cat test.txt | fzf -f '!.txt$’

The -f stands for filter command.

You can provide multiple patterns to lookup separated by a bar character which acts as an OR operator.

Output of the multiple tuning search command with fzf
Fig. 4: Output of the multiple tuning search command with fzf

You can also check the documentation of this command by typing: man fzf in your terminal.

8. Final words

Just to sum up the content of this article, basically, it will cover the fzf command, how to install it and how to use it. Besides that, we present some basic examples for each functionality that this command has. You will be familiar with that command to be able to properly use it and give you an overview of its power of it. Using this tool will mostly improve your productivity while using the command line.

Iulian Timis

My name is Iulian and I graduated Faculty of Electronics, Telecommunications, and Information Technology. My master's degree was in Computer Science, Information Security. I am passionate about technology and the security area. During my career I was working as a Java Developer, on the backend and frontend side, sometimes doing some DevOps tasks.
Subscribe
Notify of
guest

This site uses Akismet to reduce spam. Learn how your comment data is processed.

0 Comments
Inline Feedbacks
View all comments
Back to top button