CheatPress

fd Fast file finder

Version 10.5.0 · source

fd, Postcard, light preview Light · Postcard 102 × 152 mm · PDF fd, Postcard, dark preview Dark · Postcard 102 × 152 mm · PDF fd, Postcard, ink saver preview Ink saver · Postcard 102 × 152 mm · PDF
fd, A5, light preview Light · A5 148 × 210 mm · PDF fd, A5, dark preview Dark · A5 148 × 210 mm · PDF fd, A5, ink saver preview Ink saver · A5 148 × 210 mm · PDF
fd, A4, light preview Light · A4 210 × 297 mm · PDF fd, A4, dark preview Dark · A4 210 × 297 mm · PDF fd, A4, ink saver preview Ink saver · A4 210 × 297 mm · PDF
fd, A4 landscape, light preview Light · A4 landscape 297 × 210 mm · PDF fd, A4 landscape, dark preview Dark · A4 landscape 297 × 210 mm · PDF fd, A4 landscape, ink saver preview Ink saver · A4 landscape 297 × 210 mm · PDF
fd, A3, light preview Light · A3 297 × 420 mm · PDF fd, A3, dark preview Dark · A3 297 × 420 mm · PDF fd, A3, ink saver preview Ink saver · A3 297 × 420 mm · PDF
fd, A3 landscape, light preview Light · A3 landscape 420 × 297 mm · PDF fd, A3 landscape, dark preview Dark · A3 landscape 420 × 297 mm · PDF fd, A3 landscape, ink saver preview Ink saver · A3 landscape 420 × 297 mm · PDF
fd, Letter, light preview Light · Letter 8.5 × 11 in · PDF fd, Letter, dark preview Dark · Letter 8.5 × 11 in · PDF fd, Letter, ink saver preview Ink saver · Letter 8.5 × 11 in · PDF
fd, Tabloid, light preview Light · Tabloid 11 × 17 in · PDF fd, Tabloid, dark preview Dark · Tabloid 11 × 17 in · PDF fd, Tabloid, ink saver preview Ink saver · Tabloid 11 × 17 in · PDF

Start here

fd <pattern>
Find by name (regex)
fd <pattern> <dir>
Search one folder
fd -e <ext>
Match an extension
fd -t d <pattern>
Directories only
fd -H <pattern>
Include hidden files
fd -I <pattern>
Include ignored files
fd -e <ext> -x <cmd>
Run per result
fd -g '<glob>'
Glob instead of regex

Concepts

  1. Walk tree current dir
  2. Match name regex, smart case
  3. Filter type, size, age
  4. Print or run parallel

Searching

fd
List everything below the current directory
fd <pattern>
Names matching a regex
fd <pattern> <dir> [<dir>]
Search in given directories
fd -g '<glob>'
Match with a glob pattern
Quote the glob so your shell does not expand it first.
fd -p '<regex>'
Match against the full path
fd -s <pattern>
Force case-sensitive
fd -i <pattern>
Force case-insensitive
fd -F <string>
Treat pattern as a literal string
fd --and <pattern> <pattern>
Name must match both patterns
fd --exact <name>
Match the whole filename only

Filters

fd -e <ext>
Only this extension
fd -e <ext> <pattern>
Extension plus name pattern
fd -t f
Regular files only
fd -t d
Directories only
fd -t l
Symlinks only
fd -t x
Executable files only
fd -t e
Empty files or directories
fd -d <n> <pattern>
Limit search depth
fd -S +<size>
Files larger than size, e.g. +10M
+ means at least, - at most. k, M, G are powers of 1000; ki, Mi, Gi of 1024.
fd --changed-within <dur>
Modified recently, e.g. 2d or 1h
fd --changed-before <dur>
Modified before a date or longer ago than a duration
fd -o <user>
Owned by this user
fd -E '<glob>'
Exclude matching paths
fd -L
Follow symlinks

Hidden and ignored

fd -H <pattern>
Include hidden files
fd -I <pattern>
Do not respect ignore files
fd -u <pattern>
Unrestricted: same as -HI
~/.config/fd/ignore
Global ignore file (gitignore syntax)
On Windows: %APPDATA%\fd\ignore.
.fdignore
Per-project ignore file, fd only
.ignore
Ignore file shared with other search tools

Output

fd -a <pattern>
Print absolute paths
fd -l <pattern>
Detailed listing, like ls -l
fd -0 <pattern>
NUL-separated output
Pair with xargs -0 for names with spaces.
fd --format '<template>'
Print each result through a template
fd -c never <pattern>
Turn colors off
fd -c always <pattern>
Force colors, e.g. into less -R

Running commands

fd -e <ext> -x <cmd>
Run cmd once per result, in parallel
fd -e <ext> -X <cmd>
Run cmd once with all results
fd -x <cmd> {}
Placeholder: full path
fd -x <cmd> {/}
Placeholder: file name
fd -x <cmd> {.}
Placeholder: path without extension
fd -x <cmd> {//}
Placeholder: parent directory
fd -x <cmd> {/.}
Placeholder: name without extension
fd -j <n> -x <cmd>
Set number of parallel jobs
Long form --threads. -j 1 runs one command at a time.

fd vs find

Equivalents
find ... fd ...
-iname '*foo*' fd foo
-name '*.md' fd -e md
-type f fd -t f
-mtime -2 --changed-within 2d
-exec c {} \; fd -x c
-exec c {} + fd -X c

Recipes

Convert all PNGs to WebP
fd -e png -x magick {} {.}.webp
Grep only some file types
fd -e cpp -e h -X rg 'std::cout'
Delete stray files, with a prompt
fd -H '^\.DS_Store$' -t f -X rm -i
Big files changed this week
fd -t f -S +50M --changed-within 7d -l