Version 2.1.1 (05/31/2023)
Version 2.1.0 (12/26/2022)
- Various spelling corrections.
- Fix issue where following links while doing JSON output would lead to
incorrect JSON output. (simonpmind)
- Fix issue where .info patterns relative to the .info file that did not use
a wildcard for matching the prefix were not matching files properly.
- Added support for making trees from tab indented files (--fromtabfile)
(gitlab @AvidSeeker), also cleaned up some other issues in the fromfile
- Fix buffer overflow in listdir() when file names are allowed to be longer
than 256 characters (like when using fromfile.) (Javier Jaramago Fernández)
- If when attempting to open a .gitignore or .info file from a top level
directory and failing, recursively check the parents for such a file. This
stops when successful at opening such a file. This behavior might in the
future be modified to open all such files in all parents to until root is
reached. (Damien Bezborodov) Note that this requires the use of realpath()
which I think may be an issue for some OSes.
- Fix issue where tree would never descend (-l) a symbolic link when a full
tree is gathered (--du/matchdirs/prune) (gitlab @6ramr)
This is a bit bigger release, due to not realizing that gitlab/github was
not sending me email and email@example.com was broken. This has
been fixed and I think I have gone through most all of the outstanding issues
that were submitted over the last few months. Note to those that are sending
me git merge requests: because I distribute this in multiple ways and places,
and I tend to manually go over patches and often re-work them in any event, I
will not likely ever directly accept any merge requests. I will still use the
patch information from them for inclusion into the code, so you are more than
welcome to still submit such merges.
Version 2.0.4 (09/06/2022)
- Add support for --info and --gitignore for the --fromfile option.
(Suggested by Piotr Andruszkow)
- Add options --infofile and --gitfile to load .info and .gitignore files
explicitly. Each implies --info or --gitignore respectively.
- Add NULL guard for json_printinfo() and xml_printinfo() (and fix ftype
printing for XML) (Kenta Arai)
- Fix getcharset() to not return a getenv() pointer (fix for ENV34-C issue.)
- Another attempt at fixing extraneous /'s in HTML URLs/output. (Sebastian
- Fixed XML output (Dave Rice)
- Remove the (very outdated) French version of the manpage. Look to
localization projects such as Debian's 'manpages-l10n' for localized
- Add support for the NO_COLOR environment variable (https://no-color.org/).
Equivalent to the -n option (can be still be overridden with -C).
- Removed many C99isms to enable compiling on C90 compilers with fewer
warnings. (Sith Wijesinghe and Matthew Sessions) It should not be
necessary to avoid using a standard that is old enough to drink,
furthermore it is all but impossible to remove the remaining warnings and
have modern features like compound literals. In the meantime I've added
-std=c11 to the default CFLAGS for Linux and will likely not worry about
C90 compatibility going forward unless there is some other reason for it.
- Added a helper function for long command line arguments to clean up option
processing (and fixes the processing for a few of the options such as
- Added --hintro and --houtro options to select files to use as the HTML
intro and outro. Use /dev/null or an empty file to eliminate them
entirely. This should make it much easier to create your own custom CSS
or embed one or more trees into a web page.
- Defer printing the version until the character set is known so we can use
the linedraw copyright symbol.
- Revert change to the error code to not return an error (code 2) when
attempting to list a non-directory that actually exists. Tree will still
return an error when attempting to list a non-existing directory/file.
- Added option --fflinks which will process symbolic link information from
a file generated with 'tree -if --noreport' when using --fromfile.
(Suggested by Chentao Credungtao)
- Updated the totals reporting code to also include in the total the file or
directory that is being listed. This should make a correct report when
doing something like 'tree *'.
Version 2.0.3 (08/26/2022)
- Brown paper bag release:
- Fix missing comma in JSON output. (jogbear?)
Version 2.0.2 (02/16/2022)
- Fix segfault when filelimit is used and tree encounters a directory it
cannot enter. (Kenta Arai)
- Use += when assigning CFLAGS and LDFLAGS in the Makefile allowing
them to be modified by environment variables during make. (Ben Brown)
Possibly assumes GNU make.
- Fixed broken -x option (stops recursing.) (balping)
- Fix use after free (causing segfault) for dir/subdir in list.c (Erik
Skultety / Ben Brown)
- Fixes for .gitignore functionality (Saniya Maheshwari / Mig-hub ? / Carlos
- Fixed * handing in patmatch. Worked almost like ** before, now properly
stops at /'s. These issues were the result of forgetting that patmatch()
was just to match filenames to patterns, not paths.
- Patterns starting with / are actually relative to the .gitignore file,
not the root of the filesystem, go figure.
- Patterns without /'s in .gitignore apply to any file in any directory
under the .gitignore, not just the .gitignore directory
- Remove "All rights reserved" from copyright statements. A left-over from
trees original artistic license.
- Add in --du and --prune to --help output (Nxueyamao?)
- Fixed segfault when an unknown directory is given with -X
- Fixed output up for -X and -J options.
- Remove one reference to strnlen which isn't necessary since it may not
be available on some OS's.
Version 2.0.1 (01/03/2022)
- Okay, apparently the stddata addition is causing havoc (who knew how many
scripts just haphazardly hand programs random file descriptors, that's
surely not a problem.) Going forward the stddata option will only work
if the environment variable STDDATA_FD is present or set to the descriptor
to produce the JSON output on.
- Fix HTML url output issue. (Maxim Cournoyer) It was definitely broken in
the 2.0.0 release, and this should normalize it with respect to older
versions, however I think it needs to be updated to work better.
- Update MANPATH for OS X (Michiel Beijen)
- Fixed an error with * in the patchmatch code where *foo*bar would match
*foo alone. (Josey Smith)
Version 2.0.0 (12/21/2021)
- Simplify Makefile and the following changes: prefix -> PREFIX,
BINDIR -> DESTDIR, -O4 -> -O3, mode 644 for man page installation
- Make patterns ending in '/' match directories (but not files) for -I / -P
(Michiel Beijen) should also fix issues with --gitignore as well
- Fix --gitignore not matching files relative to the path of the .gitignore
(Taylor Faubion) I did say it was hacked together.
- Refactored color.c a bit to simplify the code as a prelude to meta
Version 1.8.0 (11/16/2018)
- This started out as a 1.9.0 release but then I got fed up with the
abundance of directory listers (8 in total, 2 each for each output
mode). Nothing is terribly well tested since there are a lot of changes
and I would like to get this out the door finally, please report
breakage. This reduced so much code that all the below additions only
resulted in a code base that is only 54 lines larger than 1.8.0.
- Rolled all the directory listers into 2 functions that call output
specific functions (removes one TODO).
- -R option now recursively calls the emit_tree() function rather than using
system() to re-call tree. Also removes a TODO.
- Adds --info to print information about files/directories from information
found in .info files (removes a maybe do) In HTML output, comments show as
mouse over tooltips, which I imagine will be the most useful use of this
- Output un-indented JSON on file descriptor 3 ("stddata") automatically if
file descriptor 3 is present (currently Linux only.) Maybe switch to BSON.
- Always HTML escape filenames in HTML output even when -C is used.
- Return a non-zero exit status if there is a failure to open any directory.
- Added --gitignore option to filter out files specified by .gitignore
files. (also reads $GIT_DIR/info/exclude if present.) To facilitate
gitignore, adds support for ** on pattern matching to allow /**/ to
match a single /. This is not well tested and kind of hacked together,
so may not work correctly. (Jake Zimmerman and others)
- Now also supports multiple -I and -P instances. (Michiel Beijen and
- Now prints meta data for the top level directory as well.
- Split spaghetti code in main into individual functions.
- Properly sort --fromfile input (Chentao Credungtao via Debian)
- Make tree colorization use reset (rs code in dir_colors,) not normal color
when resetting attributes (Filips Romāns via Debian).
- Honor -n (no color) even if the CLICOLOR_FORCE environment variable is set
- Fix --sort option to not require =
- Defer sorting for --du until the entire sub-directory tree has been
- Optimized makefile, HP/UX support (Osipov, Michael). Note that this
changes the prefix default to /usr/local, which is becoming required for
many systems now.
- Renamed (the by now very obsolete) doc/tree.1.fr to doc/tree.fr.1 (Jonas
- Fix JSON string escaping such that it is not using the HTML escaping (Fox
- Add --filesfirst option (John A. Fedoruk). Cleaned up sorting code to make
--dirsfirst and --filesfirst top level meta-sorts.
- "arial" not "ariel" (Mark), HTML style-sheet cleaned up in any event.
- Deprecate using local -DLINUX / -DCYGWIN and use the OS provided
__linux__ or __CYGWIN__ (Jonas Stein)
- XML/HTML/JSON output needs to be mutually exclusive, last command line
switch wins. (Sergei Maximov)
- Make sure we use xmalloc instead of malloc in a number of places
Version 1.7.0 (04/23/2014)
- Added an experimental --fromfile option (suggested by several people.)
This may eventually be replaced or supplimented by a --fromjson option.
- Added support for BSD's CLICOLOR and CLICOLOR_FORCE environment variables.
(Suggested by Alyssa Ross)
- Use strftime() exclusively when formatting date/time to respect locale.
- Some man page fixes and cleanups curtsey of Kirill Kolyshkin
- Update BINDIR in Makefile for MacOS X -- It is not allowed to install
programs to /usr/bin on MacOS X any longer due to System Integrity
Protection (SIP) (Shawn Mehan)
- Misc patches from Jacob Wahlgren:
- Improved command line switch error reporting.
- Symbolic links not displayed if a -P pattern is active
- Missing argument error reporting fixes on long format switches.
- Fixed JSON output hanging commas (John Lane, Tad, others)
- JSON size output ignored -h/--si flags (Wagner Camarao)
- Fixed issue with malformed multibyte string handling. (Mantas
- Fixed issue where mbstowcs() fails to null terminate the string due to
improper UTF-8 encoding leading to garbage being printed. (Nick Craig-Wood)
- Found a bug where the wrong inode (and device) information would be printed
for symbolic links. (Stephan Gabert)
Version 1.6.0 (05/24/11)
- Allow user/group names up to 32 characters before clipping.
- Made -i compress XML and JSON output as much as possible by eliminating
- Added --caseinsensitive (renamed --ignore-case ala grep) flag so patterns
match without regard to case, courtesy of Jason A Donenfeld.
- Added --matchdirs option courtesy of Brian Mattern & Jason A. Donenfeld
- Fixed possible buffer overflow on large uid/gids w/o user names/group
names (Alexandre Wendling <firstname.lastname@example.org>)
- Added JSON support courtesy of Florian Sesser <email@example.com>.
- Fixed formatting error with HTML output when -L 1 specified. (Sascha Zorn
- Added file size sorting (Philipp M?ller <firstname.lastname@example.org>)
- Added '--sort[=]<name>' option, ala ls.
- Fixed OS X makefile problems (Ryan Hollis <email@example.com>)
- Fixed possible memory overflow in read_dir (path/lbuf not equal in size
to pathsize/lbufsize.) (Han Hui <firstname.lastname@example.org>)
- Fix S_ISDOOR/S_IFDOOR spelling mistake for Solaris. (Tim Mooney
- Make tree more reliably detect UTF-8 locales. (Mantas Mikulnas
<email@example.com> and others.)
- Return non-zero exit status on option errors, print usage to stdout when
not an error, add the posix '--' option terminator, Change -S description
to mean CP437 (console) output codes, not ASCII. (Ivan Shmakov
Version 1.5.3 (11/24/09)
- Re-org of code into multiple files, split HTML and Unix listdir() into
separate functions, various code cleanups and optimizations.
- Fixed a memory leak in listdir() when memory was allocated early and not
freed before function exit.
- Fixed possible buffer overflow where symbolic links are followed.
- Fixed links printing "argetm" before the name of the link when the LINK
setting for DIR_COLORS is set to target (Markus Schnalke
- More fully support dir colors -- added support for su, sg, tw, ow, & st
options (and "do" in theory).
- Use the environment variable "TREE_COLORS" instead of "LS_COLORS" for
color information if it exists.
- Added --si flag to print filesizes in SI (powers of 1000) units (Ulrich
- Added -Q to quote filenames in double quotes. Does not override -N or -q.
- Control characters are no longer printed in carrot notation, but as
backslashed octal, ala ls, except for codes 7-13 which are printed as
\a, \b, \t, \n, \v, \f and \r respectively. Spaces and backslashes are
also now backslashed as per ls, for better input to scripts unless -Q
is in use (where "'s are backslashed.) (Ujjwal Kumar)
- Added -U for unsorted listings (directory order).
- Added -c for sorting by last status change (ala ls -c).
- --dirsfirst is now a meta-sort and does not override -c, -v, -r or -t, but
is disabled by -U.
- After many requests, added the ability to process the entire tree before
emitting output. Used for the new options --du, which works like the du
command: sums the amount of space under each directory and prints a total
amount used in the report and the --prune option which will prune all empty
directories from the output (makes the -P option output much more readable.)
It should be noted that this will be slow to output when processing large
directory trees and can consume copious amounts of memory, use at your own
- Added -X option to emit the directory tree in XML format (turns colorization
- Added --timefmt option to specify the format of time display (implies -D).
Uses the strftime format.
Version 22.214.171.124 (01/22/09)
- Properly quote directories for the system command when tree is re-launched using the -R option.
- Fixed possible indentation problem if dirs[*] is not properly zeroed (Martin Nagy).
- Use strcoll() instead of strcmp() to sort files based on locale if set.
- Change "const static" to "static const" to remove some compiler warnings for Solaris (Kamaraju Kusumanchi).
- Actually use TREE_CHARSET if it's defined.
- Automatically select UTF-8 charset if TREE_CHARSET is not set, and the locale is set to *UTF-8 (overridden with --charset option.)
Version 126.96.36.199 (08/29/08)
- Set locale before checking MB_CUR_MAX.
- Added HP-NonStop platform support (Craig McDaniel <firstname.lastname@example.org>)
- Fixed to support 32 bit UID/GIDs.
- Added Solaris build options to Makefile (edit and uncomment to use). Provided by Wang Quanhong
Version 1.5.2 (06/06/08)
- Added strverscmp.c file for os's without strverscmp. Source file is
attributed to: Jean-Franois Bignolles <email@example.com>
- Try different approach to MB_CUR_MAX problem.
- Changed the argument to printit() to be signed char to avoid warnings.
Version 188.8.131.52 (06/04/08)
- Added --filelimit X option to not descend directories that have more than X number of files in them.
- Added -v option for version sorting (also called natural sorting) ala ls.
Version 184.108.40.206 (06/11/07)
- Fixed compile issues related to MB_CUR_MAX on non-linux machines.
- Removed unnecessary features.h
Version 1.5.1 (?)
- Regression in HTML output, fixed formatting issues.
Version 1.5.0 (08/15/04)
- Remove extraneous / at end of user input directory names when using -f
- List available charsets if --charset option is missing charset argument.
- Fixed --charset option processing bug.
- Fixed missing <br>'s when -i option used with -H.
- Added -h option for human readable output.
- Colorization bugfix for special files and directories (make tree behave as
Version 1.4 (02/21/02 (b1), 03/24/02 (b2), 02/06/03 (b3))
- Added -T option to change title and H1 header in HTML output.
- Added -r option to reverse alpha sort output, ala. 'ls -r'.
- '|' wildcard support added by David MacMahon <davidm@astron.Berkeley.EDU>.
- Remove extraneous '/' at the end of dirs and dir-symlinks in HTML output.
- Removed several possible overflow problems by dynamically allocating
arrays in several places.
- Better support for Locales and printing utf-8 encoded characters in
filenames (still hackish).
- Fixed -t to alphasort files with same time-stamps.
- Fixed encoding of filenames in HTML output, Kyosuke and others.
- Patches by Kyosuke Tokoro <NBG01720@nifty.ne.jp>:
- Now, runs OS/2 systems.
- Print the file attributes in 'adhrs' format for each file, instead
of the protections in 'drwxrwxrwx' format, when running the tree
on OS/2 with option -p.
- Added --charset option, to specify which character set is used for
- You can specify any IANA registered character set name. But I have
tested only following character sets:
Shift_JIS EUC-JP IBM850
UTF-8 ISO-8859-1 US-ASCII
- Now, `-S' option is equal to `--charset=IBM437'.
- When running on OS/2 systems, the default value of this option
is according to current codepage. On the other systems, no default.
- Change font-weight to font-size in CSS .VERSION.
- Change version to standard major.minor.patch format.
- Switch from artistic license to GPLv2.
Version 1.3 (02/15/99)
- Added large file support under Linux.
- Fixed crashing on missing command line arguments.
- Fixed several memory leaks
- Added --dirsfirst option to list directories first.
- Fixed formatting error when unable to open directories.
- Fixed bug in parse_dir_colors().
- Changed -I to also ignore directories.
- Added --nolinks command to turn off hyperlinks with the HTML output.
- Fixed several memory leaks in listdir().
- Some additional code cleanup in listdir().
- Some systems may define TRUE/FALSE, so don't create the enums for TRUE
and FALSE if that's the case.
- Fixed over-allocation bug in read_dir().
- Added crude beginnings of color output for HTML via CSS (Ted Tiberio
- Fixed buffer overflow problem in dircolors parsing.
- Fixed recursive symlink detection.
- Added --inodes and --device options.
- Added --noreport option.
Version 1.2 (01/05/97)
- Fixed long pathname problem by dynamically allocating the path.
- Added recursive symlink detection.
- Added --help and --version options.
- When -C is used and LS_COLORS is undefined, tree uses a default color
scheme (thus -C always forces color output now).
- Added -S to show ASCII tree lines (Gerald Scheidl)
- Made tree more portable (Guido Socher and others)
Following options curtsey of Francesc Rocher:
- Added -o <filename> to redirect the output.
- Added -H <baseHRef> to print the tree in HTML format.
- Added -L to set the maximum level of directories to print.
- Added -R to recursively restart the search at the level given by `-L'
option (adding as well `-o 00Tree.html').
Version 1.1 (07/09/96)
- Added -D to print the date of the last modification.
- Added -t option to sort by last modification time (ala ls -t).
- Added -I <pattern>, simular to the -P option except tree does not print
those files which match the pattern.
- Made tree print non-printable characters in filenames in standard unix
- Added -N option to make tree print filenames without any processing.
- Added -q option to make tree print non-printable characters in filenames
as question marks.
- Added `|' to -F output and made it only print character type after the
link on sym-links, not on the symlink name itself.
- Added -u option to display username/uid, and -g option to display group
- Fully (pass the salt) implemented dircolors support.
Version 1.0 (??/??/90?)
- Made some changes to the Makefile to insure proper installation and for
multi-architecture support and a bug-fix.
- Made root directory colorized if dircolors is enabled.
- Put 's around permission and size info, 'cause I think it looks better.
- Added -A option to enable ANSI-lines hack.
- Added some sanity checks for dircolors support.
- Added -P <pattern> to list only those files that match the wildcard
given in <pattern>.
- Fixed error where relative symbolic links to directories would not be
followed when the -l option was used.
- Made uid 0 the same as anyone else (-a was default for uid 0)
- Added -x directive to stay on one filesystem (ala find -xdev).
- The original, a model of perfection...