NAME

       fd - find entries in the filesystem

SYNOPSIS

       fd  [-HIEsiaLp0hV]  [-d  depth] [-t filetype] [-e ext] [-E exclude] [-c when] [-j num] [-x cmd] [pattern]
       [path...]

DESCRIPTION

       fd is a simple, fast and user-friendly alternative to find(1).

OPTIONS

       -H, --hidden
              Include hidden files and directories in the search results (default: hidden files and  directories
              are skipped).

       -I, --no-ignore
              Show  search  results  from  files  and directories that would otherwise be ignored by .gitignore,
              .ignore or .fdignore files.

       --no-ignore-vcs
              Show search results from files and directories that  would  otherwise  be  ignored  by  .gitignore
              files.

       -s, --case-sensitive
              Perform a case-sensitive search. By default, fd uses case-insensitive searches, unless the pattern
              contains an uppercase character (smart case).

       -i, --ignore-case
              Perform a case-insensitive search. By default,  fd  uses  case-insensitive  searches,  unless  the
              pattern contains an uppercase character (smart case).

       -g, --glob
              Perform a glob-based search instead of a regular expression search.

       --regex
              Perform a regular-expression based seach (default). This can be used to override --glob.

       -F, --fixed-strings
              Treat the pattern as a literal string instead of a regular expression.

       -a, --absolute-path
              Shows the full path starting from the root as opposed to relative paths.

       -L, --follow
              By  default,  fd  does not descend into symlinked directories. Using this flag, symbolic links are
              also traversed.

       -p, --full-path
              By default, the search pattern is only matched against the filename  (or  directory  name).  Using
              this flag, the pattern is matched against the full path.

       -0, --print0
              Separate  search results by the null character (instead of newlines). Useful for piping results to
              xargs.

       --show-errors
              Enable the display of filesystem errors for situations such as insufficient  permissions  or  dead
              symlinks.

       -h, --help
              Print help information.

       -V, --version
              Print version information.

       -d, --max-depth d
              Limit  directory  traversal  to  at  most  d levels of depth. By default, there is no limit on the
              search depth.

       -t, --type filetype
              Filter search by type:

              f, file
                     regular files

              d, directory
                     directories

              l, symlink
                     symbolic links

              x, executable
                     executable (files)

              e, empty
                     empty files or directories

              This option can be used repeatedly to allow for multiple file types.

       -e, --extension ext
              Filter search results by file extension ext.  This option can be  used  repeatedly  to  allow  for
              multiple possible file extensions.

       -E, --exclude pattern
              Exclude  files/directories  that  match  the  given glob pattern.  This overrides any other ignore
              logic.  Multiple exclude patterns can be specified.

       --ignore-file path
              Add a custom ignore-file in '.gitignore' format.  These files have a low precedence.

       -c, --color when
              Declare when to colorize search results:

              auto   Colorize output when standard output is connected to terminal (default).

              never  Do not colorize output.

              always Always colorize output.

       -j, --threads num
              Set number of threads to use for searching & executing (default: number of available CPU cores).

       -S, --size size
              Limit results based on the size of files using the format <+-><NUM><UNIT>

              '+'    file size must be greater than or equal to this

              '-'    file size must be less than or equal to this

              'NUM'  The numeric size (e.g. 500)

              'UNIT' The units for NUM. They are not case-sensitive.  Allowed unit values:

                     'b'    bytes

                     'k'    kilobytes

                     'm'    megabytes

                     'g'    gigabytes

                     't'    terabytes

                     'ki'   kibibytes

                     'mi'   mebibytes

                     'gi'   gibibytes

                     'ti'   tebibytes

       --changed-within date|duration
              Filter results based on the file modification time. The argument can be  provided  as  a  specific
              point in time (YYYY-MM-DD HH:MM:SS) or as a duration (10h, 1d, 35min).  --change-newer-than can be
              used as an alias.

              Examples:
                --changed-within 2weeks
                --change-newer-than "2018-10-27 10:00:00"

       --changed-before date|duration
              Filter results based on the file modification time. The argument can be  provided  as  a  specific
              point in time (YYYY-MM-DD HH:MM:SS) or as a duration (10h, 1d, 35min).  --change-older-than can be
              used as an alias.

              Examples:
                --changed-before "2018-10-27 10:00:00"
                --change-older-than 2weeks

       -x, --exec command
              Execute command for each search result. The following  placeholders  are  substituted  by  a  path
              derived from the current search result:

              {}     path

              {/}    basename

              {//}   parent directory

              {.}    path without file extension

              {/.}   basename without file extension

       -X, --exec-batch command
              Execute command with all search results at once.  A single occurence of the following placeholders
              is authorized and substituted by the paths derived from the search results before the  command  is
              executed:

              {}     path

              {/}    basename

              {//}   parent directory

              {.}    path without file extension

              {/.}   basename without file extension

ENVIRONMENT

       LS_COLORS
              Determines how to colorize search results, see dircolors(1).

EXAMPLES

       Find files and directories that match the pattern 'needle':
              $ fd needle

       Start a search in a given directory (/var/log):
              $ fd nginx /var/log

       Find all Python files (all files with the extention .py) in the current directory:
              $ fd -e py

       Open all search results with vim:
              $ fd pattern -X vim

SEE ALSO

       find(1)

                                                                                                           FD(1)