otty / apps

All apps/fd

fd

A simple, fast and user-friendly alternative to 'find'.

Runs as fd, fdfind|macOS, Linux, Windows|github.com

Open form in Otty otty.toml

Sync rules

What travels, what stays, what never leaves

fd in your home directory Every rule on this page, by file

· ~/.config/fd/ignore Sync

Only what the catalog names. A directory that syncs brings everything inside it except what is listed as excluded here.

apps/fd/otty.tomlThe file this page is generated from

id = "fd"

name = "fd"

homepage = "https://github.com/sharkdp/fd"

description = "A simple, fast and user-friendly alternative to 'find'."

# The project's own logo, from doc/logo.png in its repository.

icon = "https://raw.githubusercontent.com/sharkdp/fd/master/doc/logo.png"

executables = ["fd", "fdfind"]

[dotfiles]

# fd.1, ENVIRONMENT: "If XDG_CONFIG_HOME is set, use $XDG_CONFIG_HOME/fd/ignore.

# Otherwise, use $HOME/.config/fd/ignore." The README gives the Windows spelling:

# the global ignore file "is usually located in ~/.config/fd/ignore in macOS or

# Linux, and %APPDATA%\fd\ignore in Windows" — the XDG location on macOS too,

# which is [configHome].

paths = ["[configHome]/fd/ignore"]

exclude = []

secret = []

# Read once at startup for each search.

side_effect = false

# No machine_lines: the global ignore file is a list of glob patterns, the same

# set of directories a user wants skipped on every machine.

[commands]

format = 1

label = "Search files"

description = "Find files and directories by pattern. Leaves out --exec/--exec-batch, --size and time filters."

quality = "ai-draft"

base = "fig:fd"

parser = { end_of_options = "--", interleave = "permute", long_equals = true, short_attached = true, short_bundles = true }

[[commands.source]]

id = "fig"

kind = "completion"

url = "https://github.com/withfig/autocomplete/blob/master/src/fd.ts"

license = "MIT"

[[commands.field]]

id = "pattern"

label = "Pattern"

description = "Regular expression, or glob with Glob search."

type = "string"

position = 0

sources = ["fig"]

[[commands.field]]

id = "path"

label = "Search in"

type = "path"

position = 1

multiple = true

path = { kind = "directory", role = "input" }

sources = ["fig"]

[[commands.field]]

id = "hidden"

label = "Include hidden"

type = "boolean"

option = ["--hidden", "-H"]

sources = ["fig"]

[[commands.field]]

id = "no_ignore"

label = "Ignore .gitignore rules"

type = "boolean"

option = ["--no-ignore", "-I"]

sources = ["fig"]

[[commands.field]]

id = "case_sensitive"

label = "Case-sensitive"

type = "boolean"

option = ["--case-sensitive", "-s"]

sources = ["fig"]

[[commands.field]]

id = "ignore_case"

label = "Case-insensitive"

type = "boolean"

option = ["--ignore-case", "-i"]

sources = ["fig"]

[[commands.field]]

id = "glob"

label = "Glob search"

type = "boolean"

option = ["--glob", "-g"]

sources = ["fig"]

[[commands.field]]

id = "full_path"

label = "Match full path"

type = "boolean"

option = ["--full-path", "-p"]

sources = ["fig"]

[[commands.field]]

id = "absolute_path"

label = "Absolute paths"

type = "boolean"

option = ["--absolute-path", "-a"]

sources = ["fig"]

[[commands.field]]

id = "follow"

label = "Follow symlinks"

type = "boolean"

option = ["--follow", "-L"]

sources = ["fig"]

[[commands.field]]

id = "list_details"

label = "Long listing"

type = "boolean"

option = ["--list-details", "-l"]

sources = ["fig"]

[[commands.field]]

id = "print0"

label = "Separate with NUL"

type = "boolean"

option = ["--print0", "-0"]

sources = ["fig"]

[[commands.field]]

id = "max_depth"

label = "Max depth"

type = "integer"

option = ["--max-depth", "-d"]

sources = ["fig"]

[[commands.field]]

id = "type"

label = "Type"

description = "f file, d directory, l symlink, x executable, e empty, s socket, p pipe."

type = "string"

option = ["--type", "-t"]

multiple = true

suggestions = [{ value = "f", label = "f" }, { value = "d", label = "d" }, { value = "l", label = "l" }, { value = "x", label = "x" }, { value = "e", label = "e" }, { value = "s", label = "s" }, { value = "p", label = "p" }]

sources = ["fig"]

[[commands.field]]

id = "extension"

label = "Extension"

type = "string"

option = ["--extension", "-e"]

multiple = true

sources = ["fig"]

[[commands.field]]

id = "exclude"

label = "Exclude glob"

type = "string"

option = ["--exclude", "-E"]

multiple = true

sources = ["fig"]

[[commands.task]]

id = "by-name"

label = "Find by name"

fields = ["pattern", "path", "hidden", "type", "extension"]

required = ["pattern"]

[[commands.task]]

id = "by-ext"

label = "Find by extension"

fields = ["extension", "path", "hidden", "max_depth"]

required = ["extension"]

[[commands.group]]

id = "basic"

label = "Basic"

fields = ["pattern", "path", "hidden", "glob", "max_depth", "type", "extension", "exclude"]

[[commands.group]]

id = "advanced"

label = "Advanced"

fields = ["absolute_path", "follow", "list_details", "print0", "full_path", "no_ignore", "case_sensitive", "ignore_case"]

Use it with your dotfile manager

Same data, in the shape your tool already reads

Opens Otty and adds this tool to what it syncs

Opens otty://sync/add/fd. Otty ships with this catalog, so the link only has to name the tool — nothing is downloaded.

Every one of these is generated from the same rules as this page.