- Improved the usability of the time-based options, see #624 and #645 (@gorogoroumaru)
- Add new
--pruneflag, see #535 (@reima)
- Disable jemalloc on Android, see #662
- Support colored output on older Windows versions if either (1)
--color=alwaysis set or (2) the
TERMenvironment variable is set. See #469
- Add new
--owner [user][:group]filter. See #307 (pull #581) (@alexmaco)
- Add support for a global ignore file (
~/.config/fd/ignoreon Unix), see #575 (@soedirgo)
- Do not exit immediately if one of the search paths is missing, see #587 (@DJRHails)
- Reverted a change from fd 8.0 that enabled colors on all Windows terminals (see below) in order to support older Windows versions again, see #577. Unfortunately, this re-opens #469
- Fix segfault caused by jemalloc on macOS Catalina, see #498
--globbehavior with empty pattern, see #579 (@SeamusConnor)
--list-detailson FreeBSD, DragonFly BSD, OpenBSD and NetBSD. See #573 (@t6)
- Updated documentation for
--size, see #584
- Add a new
--list-detailsoption to show more details about the search results. This is basically an alias for
--exec-batch ls -lwith some additional
lsoptions. This can be used in order to:
- Add a new
--max-results=<count>option to limit the number of search results, see #472, #476 and #555 This can be useful to speed up searches in cases where you know that there are only N results. Using this option is also (slightly) faster than piping to
head -n <count>where
fdcan only exit when it finds the search results
<count> + 1.
- Add the alias
--max-results=1, see #561. (@SimplyDanny).
- Add new
--type pipefilters, see #511.
- Add new
--exact-depth <depth>options in addition to the existing option to limit the maximum depth. See #404.
- Support additional ANSI font styles in
LS_COLORS: faint, slow blink, rapid blink, dimmed, hidden and strikethrough.
- Preserve non-UTF8 filenames: invalid UTF-8 filenames are now properly passed to child-processes
fd's output, we replace non-UTF-8 sequences with the "�" character. However, if the output of
fdgoes to another process, we print the actual bytes of the filename. For more details, see #558 and #295.
LS_COLORSentries with unsupported font styles are not completely ignored, see #552
- Colored output will now be enabled by default on older Windows versions.
This allows the use of colored output if the terminal supports it (e.g.
MinTTY, Git Bash). On the other hand, this will be a regression for users
on older Windows versions with terminals that do not support ANSI escape
sequences. Affected users can use an alias
fd="fd --color=never"to continue using
fdwithout colors. There is no change of behavior for Windows 10. See #469.
- When using
--globin combination with
*character does not match a path separation character (
\\) anymore. You can use
**for that. This allows things like
fd -p -g '/some/base/path/*/*/*.txt'which would previously match to arbitrary depths (instead of exactly two folders below
/some/base/path. See #404.
- "Legacy" support to use
fd -exec(with a single dash) has been removed. Use
- Overall improved error handling and error messages.
--xdev) to not cross file system boundaries on Unix and Windows, see #507 (@FallenWarrior2k).
--base-directoryto change the working directory in which
fdis run, see #509 and #475 (@hajdamak).
fdwill not use colored output if the
NO_COLORenvironment variable is set, see #550 and #551 (@metadave).
fd --execwill return exit code 1 if one of the executed commands fails, see #526 and #531 (@fusillicode and @Giuffre)
- Fixed 'command not found' error when using zsh completion, see #487 (@barskern).
fd -Lshould include broken symlinks, see #357 and #497 (@tommilligan, @neersighted and @sharkdp)
- Display directories even if we don't have permission to enter, see #437 (@sharkdp)
- A flag can now be passed multiple times without producing an error, see #488 and #496 (@rootbid).
- Search results are sorted when using the
-Xoption to match the behaviour of piping to
xargs, see #441 and #524 (@Marcoleni @crash-g).
- Reduce number of
statsyscalls, improving the performance for searches where file metadata is required (
--changed-within, …), see #434 (@tavianator)
- Use jemalloc by default, improving the performance for almost all searches, see #481. Note that
*musl*builds do not profit from this.
- Added a new
--globoption to switch to glob-based searches (instead of regular expression based searches). This is accompanied by a new
--regexoption that can be used to switch back, if users want to
alias fd="fd --glob". See #284
- Added a new
--path-separator <sep>option which can be useful for Windows users who want/need
\, see #428 and #153 (@mookid)
- Added support for hidden files on Windows, see #379
fdis run with the
-Xoption, it now exposes the exit status of the command that was run, see #333.
- Exit immediately when Ctrl-C has been pressed twice, see #423
--changed-beforework for directories, see #470
fdbinaries should now be available for
armhftargets, see #457 (@detly)
fdis now available on Alpine Linux, see #451 (@5paceToast)
fdis now in the officla FreeBSD repositories, see #412 (@t6)
- Added OpenBSD install instructions, see #421 (@evitalis)
- Added metadata to the Debian package, see #416 (@cathalgarvey)
fdcan be installed via npm, see #438 (@pablopunk)
-X <cmd>option for batch execution of commands, see #360 (@kimsnj). This allows you to do things like:
fd … -X vim # open all search results in vim (or any other editor) fd … -X ls -l # view detailed stats about the search results with 'ls' fd -e svg -X inkscape # open all SVG files in Inkscape
- Support for 24-bit color codes (when specified via
LS_COLORS) as well as different font styles (bold, italic, underline).
- A few performance improvements, in particular when printing lots of colorized results to the console, see #370
LS_COLORShandling has been "outsourced" to a separate crate (https://github.com/sharkdp/lscolors) that is now being used by other tools as well: fselect, lsd. For details, see #363.
fdwill be available in Ubuntu Disco DIngo (19.04), see #373 (@sylvestre)
- This release should come with a static ARM binary (
arm-unknown-linux-musleabihf), see #320 (@duncanfinney)
- Various documentation improvements, see #389
- Added support for filtering by file modification time by adding two new options
--changed-within <..>. For more details, see the
--helptext, the man page, the relevant issue #165 and the PR #339 (@kimsnj)
--show-errorsoption to enable the display of filesystem error messages such as "permission denied", see #311 (@psinghal20 and @majecty)
--maxdepthas a (hidden) alias for
--max-depth, see #323 (@mqudsi)
--search-pathoption which can be supplied to replace the positional
pathargument at any position.
- Loosen strict handling of missing
--ignore-file, see #280 (@psinghal20)
.ignorefiles, see #156.
fdcould previously get stuck when run from the root directory in the presence of zombie processes. This curious bug has been fixed in Rust 1.29 and higher. For more details, see #288, rust-lang/rust#50619 and the fix
fdhas officially landed in Debian! See #345 for details. Thanks goes to @sylvestre, @paride and possibly others I don't know about.
- Added Chinese translation of README (@chinanf-boy)
A special thanks goes to @joshleeb for his amazing improvements throughout the code base (new tests, refactoring work and various other things)!
--sizefilter option, see #276 (@stevepentland, @JonathanxD and @alexmaco)
-t e) to search for empty files and/or directories, see #273
- With the new version,
.gitignorefiles will only be respected in Git repositories, not outside.
- A few performance improvements for
- Starting with this release, we will offer pre-built ARM binaries, see #244
- Added instructions on how to use
emacs, see #282 (@redguardtoo)
fdis now in the official openSUSE repositories, see #275 (@avindra)
fdis now available via MacPorts, see #291 (@raimue)
-t x) to search for executable files only, see #246 (@PramodBisht)
- Added support for
.fdignorefiles, see #156 and #241.
--ignore-fileoption to add custom ignore files, see #156.
--fixed-stringson invalid regular expressions, see #234 (@PramodBisht)
- Detect when user supplied path instead of pattern, see #235.
.rgignorefiles are not parsed anymore. Use
.fdignorefiles or add custom files via
- Updated to
- Properly normalize absolute paths, see #268
- Invalid utf8 filenames displayed when
-eis used, see #250
--typeis used, fifos/sockets/etc. are always shown, see #260
- The Arch Linux package is now simply called
- There is now a
fdebuild for Gentoo Linux.
- There is a
- There is a
- There is a Fedora
- The Arch Linux package is now simply called
> fd -e tar.gz
--literaloption that treats the pattern as a literal string instead of a regular expression, see #157
> fd -F 'file(1).txt'
Fixed wrong file owner for files in deb package, see #213
- Replaced old gif by a fancy new SVG screencast (@marionebl)
- Updated benchmark results (fd has become faster in the meantime!). There is a new repository that hosts several benchmarking scripts for fd: https://github.com/sharkdp/fd-benchmarks
For example, it's possible to search for C++ source or header files:
> fd -e cpp -e c -e cxx -e h pattern
- The size of the output buffer (for sorting search results) is now limited to 1000 entries. This improves the search speed significantly if there are a lot of results, see #191 (@sharkdp).
- Fix a bug where long-running searches could not be killed via Ctrl-C, see #210 (@Doxterpepper)
- fd's exit codes are now in accordance with Unix standards, see #201 (@Doxterpepper)
- Bash, zsh and fish completion should now work with the Ubuntu
.debpackages, see #195 and #209 (@tmccombs and @sharkdp)
- There is a new section on how to set up
fdin the README, see #168.
- Support for multiple search paths, see #166 (@Doxterpepper)
--no-ignore-vcsoption to disable
.gitignoreand other VCS ignore files, without disabling
.ignorefiles - see #156 (@ptzz).
- Handle terminal signals, see #128 (@Doxterpepper)
- Fixed hang on
--execwhen user input was required, see #178 and #193 (@reima)
- Debian packages are now created via Travis CI and should be available for this and all future releases (@tmccombs).
- fd is now available on Void Linux (@maxice8)
- The minimum required Rust version is now 1.20
@Doxterpepper deserves a special mention for his great work that is included in this release and for the support in ticket discussions and concerning Travis CI fixes. Thank you very much!
Thanks also go out to @tmccombs for the work on Debian packages and for reviewing a lot of pull requests!
-xoption does not spawn an intermediate shell anymore. This improves the performance of parallel command execution and fixes a whole class of (present and potentially future) problems with shell escaping. The drawback is that shell commands cannot directly be called with
--exec. See #155 for the full discussion. These changes have been implemented by @reima (Thanks!).
--execdoes not escape cmd.exe metacharacters on Windows (see #155, as above).
- fd is now available in the FreeBSD ports (@andoriyu)
- The minimal
rustcversion is now checked when building with
cargo, see #164 (@matematikaadit)
- The output directory for the shell completion files is created if it does not exist (@andoriyu)
- Added new
-xoption for parallel command execution (@mmstick, see #84 and #116). See the corresponding README section for an introduction.
- Auto-disable color output on unsupported Windows shells like
cmd.exe(@iology, see #129)
- Added the
-Xoption to suppress certain files/directories in the search results (see #89).
- Added ripgrep aliases
--no-ignore --hidden, respectively (@unsignedint, see #92)
--ignore-case(@iology, see #95)
- Made smart case really smart (@reima, see #103)
- Added RedoxOS support (@goyox86, see #131)
- The dot
.can now match newlines in file names (@iology, see #111)
- The short
--typeargument for symlinks has been changed from
l(@jcpetkovich, see #83)
- Various improvements in root-path and symlink handling (@iology, see #82, #107, and #113)
- Fixed absolute path handling on Windows (@reima, #93)
- Fixed: current directory not included when using relative path (see #81)
--typebehavior for unknown file types (@iology, see #150)
- Some fixes around
--exec(@iology, see #142)
- Major updates and bugfixes to our continuous integration and deployment tooling on Travis (@matematikaadit, see #149, #145, #133)
- Code style improvements & automatic style checking via
rustfmton Travis (@Detegr, see #99)
- Added a man page (@pickfire, see #77)
- fd has been relicensed under the dual license MIT/Apache-2.0 (@Detegr, see #105)
- Major refactorings and code improvements (Big thanks to @gsquire, @reima, @iology)
- First version of
- There is now a Nix package (@mehandes)
- fd is now in the official Arch Linux repos (@cassava)
- Improved tooling around shell completion files (@ImbaKnugel, see #124)
- Updated tutorial in the
- The minimum required version of Rust has been bumped to 1.19.
A lot of things have happened since the last release and I'd like to thank all contributors for their great support. I'd also like to thank those that have contributed by reporting bugs and by posting feature requests.
I'd also like to take this chance to say a special Thank You to a few people that have stood out in one way or another: To @iology, for contributing a multitude of bugfixes, improvements and new features. To @reima and @Detegr for their continuing great support. To @mmstick, for implementing the most advanced new feature of fd. And to @matematikaadit for the CI/tooling upgrades.
- Added filtering by file extension, for example
fd -e txt, see #56 (@reima)
- Add option to force colored output:
--color always, see #49 (@Detegr)
- Generate Shell completions for Bash, ZSH, Fish and Powershell, see #64 (@ImbaKnugel)
- Better & extended
--helptext (@abaez and @Detegr)
- Proper Windows support, see #70
- The integration tests have been re-written in Rust ✨, making them platform-independent and easily callable via
cargo test- see #65 (many thanks to @reima!)
- New tutorial in the README (@deg4uss3r)
- Reduced number of
statsyscalls for each result from 3 to 1, see #36.
- Enabled Appveyor CI
- Added file type filtering, e.g.
find --type directoryor
find -t f(@exitium)
- Directories are now traversed in parallel, leading to significant performance improvements (see benchmarks)
- Added AUR packages (@wezm)
- Changed short flag for
- Throw an error if root directory is not existent, see #39
- Use absolute paths if the root dir is an absolute path, see #40
- Handle invalid UTF-8, see #34 #38
--versionby switching from
- It's now possible to install
fdvia homebrew on macOS:
brew install fd.
- Windows compatibility (@sebasv), see #29 #35
- Safely exit on broken output pipes (e.g.: usage with
tail, ..), see #24
- Backport for rust 1.16, see #23
LS_COLORSenvironment variable directly, instead of
- Added unit and integration tests
- Added optional second argument (search path)
- Parse dircolors files, closes #20
- Colorize each path component, closes #19
- Add short command line option for --hidden, see #18
- Option to follow symlinks, disable colors, closes #16, closes #17
- Option to search hidden directories, closes #12
- Configurable search depth, closes #13
- Detect interactive terminal, closes #11