When it comes to managing files on a computer, finding specific files or directories quickly and efficiently can be a common task. Whether you're a developer looking for a specific code file, a system administrator searching for log files, or a regular user trying to locate a document, having a reliable and user-friendly file search tool can greatly simplify the process. One such tool that has gained popularity among Linux users is "fd". Designed as a user-friendly alternative to the traditional find command, fd provides a more intuitive and efficient method for searching files and directories. In this detailed tutorial, we will discuss what is fd, key differences between the fd and find command. We will also learn how to install and use fd command to efficiently search files and directories in Linux.
Table of Contents
What is fd Command?
fd is a program that helps you find files and directories in your computer's file system. It's designed to be a simple, fast, and easy-to-use alternative to the "find" command. While it may not have all the advanced features of "find," it offers convenient and practical options for most common uses.
fd is written in Rust, a programming language known for its focus on speed and reliability. It aims to provide an efficient and user-friendly way to search for files and directories on your Linux system.
Key Differences Between fd and find Command
The key difference between the fd and find commands is as follows:
- Syntax: The fd command has a simpler and more intuitive syntax compared to the "
find" command. Instead of using lengthy command syntax like "find -iname 'PATTERN'", you can directly use "fd PATTERN" to search for files. - Patterns: fd supports both regular expressions and glob-based patterns by default. This allows you to use flexible and powerful patterns to match file names or patterns of your choice.
- Speed: fd is designed to be very fast. It achieves this by parallelizing the process of traversing directories, resulting in quicker search results compared to "
find". - Colors: Similar to the "
ls" command, fd uses colors to highlight different types of files. This makes it easier to visually identify different file types in the search results. - Parallel Execution: fd supports parallel execution of commands. This means it can perform multiple search operations simultaneously, further improving performance in certain scenarios.
- Smart Case: By default, fd performs case-insensitive searches. However, if your search pattern contains an uppercase character, it automatically switches to case-sensitive mode. This smart behavior helps in more accurate searches.
- Ignoring Hidden and Git-Ignored Files: fd ignores hidden directories and files by default, so they won't appear in the search results. Additionally, it also ignores patterns specified in your
.gitignorefile, making it convenient when working with Git repositories. - Command Name Length: The name of the fd command is 50% shorter than the "
find" command. This makes it easier to type and remember when using the tool.
Overall, fd aims to provide a simpler, faster, and more user-friendly alternative to "find" by offering intuitive syntax, advanced pattern matching, speed optimizations, visual enhancements, and convenient default behaviors.
Install fd in Linux
To install fd on different Linux distributions, follow the specific instructions provided below:
On Alpine Linux:
$ sudo apk add fd
On Arch Linux:
$ sudo pacman -S fd
On Debian:
$ sudo apt-get install fd-find $ ln -s $(which fdfind) ~/.local/bin/fd
Note: The binary name for Debian is fdfind, so it's recommended to create a symbolic link to fd.
If the directory $HOME/.local/bin does not exist, you can create it and add it to your $PATH environment variable. Here are the steps to do so:
Check if the directory $HOME/.local/bin already exists by running the following command:
$ ls $HOME/.local/bin
If the directory does not exist and the command from the previous step returns an error, create the directory using the following command:
$ mkdir -p $HOME/.local/bin
Next, you need to add the directory to your $PATH environment variable. Edit your shell configuration file, such as ~/.bashrc, ~/.bash_profile, or ~/.zshrc, depending on the shell you are using.
Open the shell configuration file in a text editor:
$ nano ~/.bashrc
Add the following line at the end of the file:
export PATH="$HOME/.local/bin:$PATH"
Save the file and exit the text editor. In Nano, you can do this by pressing Ctrl + X, then Y, and finally Enter.
To apply the changes, either restart your terminal or run the following command:
$ source ~/.bashrc
Now, the directory $HOME/.local/bin has been created (if it didn't exist before), and it has been added to your $PATH environment variable. This means that any executable files placed in $HOME/.local/bin will be accessible from anywhere in your system by simply typing their names in the terminal.
On Fedora:
$ sudo dnf install fd-find
On Gentoo Linux:
# emerge -av fd
On openSUSE Linux:
$ sudo zypper in fd
On Void Linux:
$ sudo xbps-install -S fd
On NixOS / via Nix:
$ sudo nix-env -i fd
On Ubuntu (for versions newer than 19.04):
$ sudo apt install fd-find $ ln -s $(which fdfind) ~/.local/bin/fd
Note: The binary name for Ubuntu is fdfind, so it's recommended to create a symbolic link to fd.
On Ubuntu (for older versions):
Download the latest .deb package from the release page and install it using dpkg package manager like below:
$ sudo dpkg -i fd_8.7.0_amd64.deb # Adapt the version number and architecture accordingly
On FreeBSD:
# pkg install fd-find
From source (using Rust's package manager cargo):
Since fd is written in Rust, you can install it using cargo package manager. Just make sure Rust is installed on your Linux system. And then run the following command to install fd using cargo:
$ cargo install fd-find
These instructions should guide you through the installation process of fd on your chosen Linux distribution.
Mastering File Search with fd Command in Linux
1. Getting Help
Before start using fd command, you need to understand the various command line options provided by fd.
To get a summary of all the available command line options for fd, you have two options:
For a brief and concise help message, you can run fd -h in the terminal.
If you prefer a more detailed version of the help message, you can run fd --help.
2. Basic Search
The fd command is specifically designed to search for entries (files and directories) in your filesystem. The simplest way to use fd is by providing it with a single argument, which is the search pattern.
Let us try a simple search.
Example 1:
For instance, let's say you want to find an old script of yours that includes the word "file" in its name. You can run fd file in the terminal. This command will search the current directory and all its subdirectories recursively for any entries that contain the pattern "file".
$ fd file
In the given example, the command fd file is used to search for entries containing the word "file" in their names.
file1 file2 testdir/file3 testdir/file4
Here's an explanation of the example results:
file1andfile2: These are two files found in the current directory that have "file" in their names. They match the search pattern "file".testdir/file3andtestdir/file4: These are two files found within the subdirectory "testdir". They also have "file" in their names and match the search pattern "file".
Overall, the fd command, when executed with the search pattern "file", searches the current directory and its subdirectories recursively. It returns a list of files that contain the specified pattern in their names.
Example 2:
Let us try a different example with more sub-directories and files. Suppose you want to find any files or directories related to recipes. You can use fd with the search pattern "recipe" as follows:
$ fd recipe
When you execute this command, fd will recursively search the current directory and its subdirectories for any entries that contain the pattern "recipe". Here's a sample example of the search results:
Documents/Recipes Documents/Recipes/chocolate-cake-recipe.txt Documents/Recipes/pasta-recipes Documents/Recipes/pasta-recipes/creamy-alfredo-recipe.txt Pictures/Food/recipe-book-cover.jpg
In this example, fd found the directory "Recipes" in the "Documents" folder, a text file named "chocolate-cake-recipe.txt" within the "Recipes" directory, a subdirectory called "pasta-recipes" within "Recipes", and a picture file named "recipe-book-cover.jpg" in the "Pictures/Food" directory. These entries all match the search pattern "recipe".
3. Regular Expression Search
We can perform regular expression search with fd command. A regular expression allows us to define complex patterns to search for specific entries.
Example 1:
Take a look at the following example:
$ cd /etc/ $ fd '^x.*rc$'
In the given example, the fd command is used with a regular expression search pattern. The search pattern is specified as ^x.*rc$, which means it should start with "x" and end with "rc".
Sample output for the above command is given below:
X11/xinit/xinitrc X11/xinit/xinputrc X11/xinit/xserverrc
Let's understand the output results:
X11/xinit/xinitrc: This entry is found in the/etcdirectory. It matches the regular expression search pattern as it starts with "x" and ends with "rc". It represents a file namedxinitrclocated within theX11/xinitdirectory.X11/xinit/xinputrc:This entry is found in the/etcdirectory. It matches the regular expression search pattern as it starts with "x" and ends with "rc". It represents a file namedxinputrclocated within theX11/xinitdirectory.X11/xinit/xserverrc: This entry is also found in the/etcdirectory. It matches the regular expression search pattern as it starts with "x" and ends with "rc". It corresponds to a file namedxserverrclocated within theX11/xinitdirectory.
In this example, the fd command searches the /etc directory (as indicated by cd /etc) and its subdirectories for entries that match the specified regular expression pattern ^x.*rc$. The ^ represents the start of the line, .* matches any characters in between, and $ denotes the end of the line. Therefore, any entries that start with "x" and end with "rc" are considered matches and included in the search results.
Example 2:
Let's consider a different example for a regular expression search using the fd command.
Suppose you want to find all files that contain numbers in their names. You can use a regular expression to accomplish this. Here's an example:
$ fd '[0-9]+'
In this case, we are using the regular expression [0-9]+, which represents a sequence of one or more digits. Here is the output of the above command:
file1.txt file2.jpg document_2023.docx report_123.pdf
In this example, the fd command searches the current directory and its subdirectories using the regular expression [0-9]+. It returns all the files that have one or more digits in their names. The search results include files such as file1.txt, file2.jpg, document_2021.docx, and report_123.pdf, which match the specified regular expression pattern.
By using regular expressions with fd, you can create flexible and powerful search patterns to find entries that meet specific criteria, such as containing numbers, specific characters, or following certain patterns.
4. Search Files and Directories in a Specific Directory
When you want to search in a specific directory using the fd command, you can provide that directory as a second argument after the search pattern.
Here's an example for searching in a specific directory using the fd command:
Suppose you want to search for files with the extension ".log" in the "var/log" directory. You can use the following command:
$ fd .log /var/log
In this example, we are searching for entries that have the ".log" extension within the "/var/log" directory.
Sample output:
/var/log/alternatives.log /var/log/alternatives.log.1 /var/log/apt/eipp.log.xz /var/log/apt/history.log /var/log/apt/history.log.1.gz /var/log/apt/term.log [...]
These files are found within the "/var/log" directory and its subdirectories, and they have the ".log" extension.
By providing the target directory as the second argument to fd, you can narrow down the search to that specific directory. This allows you to search within a particular location of interest, making it easier to find relevant entries within a large filesystem.
5. List All Files Recursively
To list all files recursively using the fd command, you can call it without any arguments. This is particularly helpful for quickly getting an overview of all entries (files and directories) in the current directory, similar to using ls -R command.
For example, if you run fd without any additional arguments, it will display all the entries within the current working directory recursively. The output might look like this:
Desktop/ Documents/ Downloads/ Music/ Pictures/ Public/ Templates/ Videos/ document_2023.docx file1 file2 testdir/ testdir/file3 testdir/file4 testdir/report_123.pdf
To list all files in a specific directory, you can use a catch-all pattern such as . or ^ along with the directory path. For instance, running fd . testdir/ will provide a list of all files within the testdir/ directory, including its subdirectories.
$ fd . testdir/ testdir/file3 testdir/file4 testdir/report_123.pdf
6. Searching for a Particular File Extension
When we want to search for files with a specific file extension, we can use the -e (or --extension) option with the fd command. This is useful when we are interested in files of a particular type.
Here's an example for searching files with a specific file extension using the fd command:
Let's say you are working on a project and want to find all Python script files (files with the ".py" extension) within the project directory and its subdirectories. You can use the following command:
$ fd -e py
Running this command in the project directory will search for files with the ".py" extension.
The sample output could be:
script1.py script2.py folder1/script3.py folder2/subfolder/script4.py
These files are the Python script files found within the project directory and its subdirectories.
The -e option can also be combined with a search pattern. For instance, running the command:
$ fd -e docx file
will search for files with the extension ".docx" that also contain the pattern "file". The output might look like:
file5.docx testdir/file6.docx
These files match the search criteria: they have the ".docx" extension and contain the pattern "file".
By utilizing the -e option with fd and specifying the desired file extension, you can conveniently search for and locate files of a particular type.
7. Searching for a Particular File Name
If you want to search for a file with an exact match to the search pattern, you can use the -g (or --glob) option with the fd command.
For instance, let's say you want to find a file named "ssh_host_rsa_key.pub" within the "/etc" directory and its subdirectories. You can run the following command:
$ fd -g ssh_host_rsa_key.pub /etc
In this example, the fd command will search for a file that has an exact match to the provided search pattern "ssh_host_rsa_key.pub" within the "/etc" directory.
The output for this command will be:
/etc/ssh/ssh_host_rsa_key.pub
This file matches the exact search pattern "ssh_host_rsa_key.pub" and is found within the "/etc" directory.
By utilizing the -g option with fd, you can search for files that have an exact name match, making it easier to locate specific files within a given directory and its subdirectories.
8. Search for Hidden Files
By default, when using the fd command, it does not search hidden directories and does not display hidden files in the search results. However, if you want to change this behavior, you can make use of the -H (or --hidden) option.
Example 1:
Take a look at the following example.
$ fd bash
This command should return all files that match the search pattern "bash". But it didn't return any such files in my Debian 12 system.
Now let us run the same command again with -H flag and see what happens.
$ fd -H bash .bash_history .bash_logout .bashrc
Now we see some output. This command searches for files and directories that match the search pattern "bash" and includes hidden entries in the search results.
Example 2:
Now, we will see another example. Let us search for all files with the extension ".txt" within the testdir directory (including its subdirectories) using command:
$ fd . -e txt testdir/
It doesn't return anything in my system. Now let us run the same command with -H flag.
$ fd . -H -e txt testdir/
testdir/.secret.txt
See? Now it displays a hidden file named secret.txt.
9. Search for Ignored Files
If you are working in a directory that contains Git repositories or is a Git repository itself, fd has a default behavior of not searching folders and not displaying files that match any patterns specified in the .gitignore file. However, you can change this behavior by using the -I (or --no-ignore) option.
For instance, consider the following example:
$ fd num_cpu
In this case, fd is searching for files or directories that contain the pattern "num_cpu". However, if there are any matches within folders or files that are ignored by Git according to the .gitignore file, they will not be displayed in the search results.
To override this behavior and include the ignored files and folders in the search results, you can use the -I option, like so:
$ fd -I num_cpu
With this command, fd will search for files or directories that match the pattern "num_cpu", regardless of whether they are ignored by Git. The search result may include files or folders that were previously excluded due to Git's ignore rules.
If you want to search for all files and directories, including hidden entries and those ignored by Git, you can combine the -H (or --hidden) and -I (or --no-ignore) options:
$ fd -HI search_pattern
By using the -HI option together, fd will search for all files and directories, displaying both hidden entries and those ignored by Git. This allows you to perform a comprehensive search that includes all files and directories within the specified search pattern.
10. Combine fd with other Commands
Instead of simply displaying the search results, you may often need to perform actions on them. fd offers two methods for executing external commands on each search result:
- The
-x(or--exec) option allows you to run an external command individually for each search result in parallel. - The
-X(or--exec-batch) option executes the external command once with all the search results as arguments.
Here are some examples to illustrate their usage.
Example 1:
Let's say you want to find all text files within a directory and perform a word count on each file. You can achieve this using the -x (or --exec) option with the wc command:
$ fd -e docx -x wc -w
In this example, fd searches for files with the .docx extension. The -x option is used to execute the external command wc -w for each search result. The wc command with the -w option is used to count the number of words in each file.
The sample output could be:
0 ./document_2023.docx 0 ./file6.docx 18 ./testdir/file5.docx
Each line shows the word count followed by the file name.
By utilizing the -x option and specifying the external command (wc -w in this case), you can perform actions on each search result individually. This enables you to automate various tasks or apply operations to multiple files found by fd.
Example 2:
Here's the additional example for converting all *.jpg files to *.png files using the fd command:
$ fd -e jpg -x sh -c "convert {} {.}.png"In this example, fd searches for files with the .jpg extension. The -x option is used to execute the external command sh -c, allowing us to run a shell command with multiple arguments. The shell command consists of the following part:
convert {} {.}.pngis the command executed for each*.jpgfile found. Theconvertcommand is a popular image conversion utility, and{}represents the matched file name.{.}is used to extract the file name without the extension, andpngis appended to convert the file to the*.pngformat.
By running this command, each *.jpg file found by fd will be converted to the *.png format using the convert command.
Please make sure to have the necessary dependencies, such as the ImageMagick package, installed for the convert command to work properly.
11. Exclude Specific Files and Directories
To exclude specific files or directories during a search, you can utilize the -E (or --exclude) option with the fd command. This option allows you to specify an arbitrary glob pattern as an argument to exclude certain entries from the search results.
For example, if you want to exclude files with the .docx extension from the search, you can run the following command:
$ fd -E '*.docx' ...
In this example, fd will perform the search while excluding any files that match the *.docx glob pattern. The ... represents the current directory.
Sample output:
Desktop/ Documents/ Downloads/ Music/ Pictures/ Public/ Templates/ Videos/ file1 file2 testdir/ testdir/file3 testdir/file4 testdir/report_123.pdf
As you see in the output above, all the files with extension .docx are excluded from the search result.
To exclude a directory, for example testdir, the command would be:
$ fd -E testdir/ ... Desktop/ Documents/ Downloads/ Music/ Pictures/ Public/ Templates/ Videos/ document_2023.docx file1 file2 file6.docx
By using the -E option with fd and providing a glob pattern, you can easily exclude specific file types or directories from the search results, narrowing down the scope of your search to focus on the desired entries.
12. Search and Delete Files
You can utilize fd to delete files and directories that match your search pattern. If you only want to remove files, you can use the --exec-batch (or -X) option to invoke the rm command. Here's an example to recursively remove all .docx files:
$ fd -H '^\docx$' -tf -X rm
In this example, fd searches for .docx files, and the -H option ensures hidden files are included. The -tf option is used to display the file path relative to the current directory. The -X rm part executes the rm command on each matched file.
It's recommended to run fd without -X rm first if you are uncertain. Alternatively, you can use the interactive mode of rm by adding the -i option:
$ fd -H '^\.docx$' -tf -X rm -i
With this command, you will be prompted to confirm the deletion of each file.
Always exercise caution when using deletion commands to avoid unintentional removal of important files. Make sure to review the search results before executing commands that delete files and directories.
13. Use fd Command with other Programs
You can integrate fd with other programs. For instance, you can utilize fd in combination with xargs or parallel to perform command execution on the search results.
Although fd has its own built-in options for command execution (-x/--exec and -X/--exec-batch), you can still use it with xargs if you prefer.
Here's an example:
$ fd -0 -e docx | xargs -0 wc -l
Sample output for the above command:
0 ./document_2023.docx 0 ./file6.docx 4 ./testdir/file5.docx 4 total
In this example, fd is used to search for files with the .docx extension (-e docx). The -0 option is used with both fd and xargs to separate the search results and input by the NULL character (\0) instead of newlines. This ensures proper handling of filenames that may contain spaces or other special characters.
The output of fd is then passed as input to xargs, which in turn executes the wc -l command on each file. The wc -l command counts the number of lines in each file.
Frequently Asked Questions
fd?A: fd is a command-line tool in Linux used for finding files and directories in a fast and user-friendly manner.
fd differ from the find command?A: fd offers a more intuitive syntax, faster performance, and sensible defaults compared to find. It ignores hidden files by default, integrates with Git ignore patterns, and provides a simpler and faster search experience.
fd an alternative to the find command?A2: fd is a simpler and more intuitive alternative to the find command. It provides opinionated defaults, faster performance due to parallelized directory traversal, and features like colored output and pattern matching.
fd?A: The installation method for fd depends on your Linux distribution. For example, you can install fd in Fedora using sudo dnf install fd. Refer to the official documentation or package manager instructions specific to your distribution.
fd search using regular expressions?A: Yes, fd treats the search pattern as a regular expression by default. You can perform more complex searches using regular expressions.
fd exclude hidden files and directories from the search results?A: Yes, by default, fd ignores hidden files and directories.
fd in search results?A: You can use the -H or --hidden option to include hidden files in search results.
A: Use the -E or --exclude option followed by a glob pattern to exclude specific files or directories from the search results.
fd?A: Yes, fd provides options like -x and -X to execute external commands on the search results. You can also combine fd with tools like xargs or parallel for more flexibility.
fd faster than the find command?A: Yes, fd is generally faster than find due to its parallelized directory traversal and optimized search algorithms. You can refer the benchmark results in this link- https://github.com/sharkdp/fd#benchmark
A: Yes, you can utilize fd in combination with other programs like xargs or parallel to perform command execution on the search results.
Conclusion
In summary, the fd command is a user-friendly and efficient tool for finding files and directories in Linux. With its intuitive syntax, fast performance, and helpful features like pattern matching and filtering, fd simplifies file searches and enhances command-line productivity.
For more details, refer fd command GitHub repository given below.
