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)