tree Directory tree listing

Version 2.3.2 · source

Postcard A5 A4 A4 landscape A3 A3 landscape Letter Tabloid

Light · Postcard 102 × 152 mm · PDF

Dark · Postcard 102 × 152 mm · PDF

Ink saver · Postcard 102 × 152 mm · PDF

Light · A5 148 × 210 mm · PDF

Dark · A5 148 × 210 mm · PDF

Ink saver · A5 148 × 210 mm · PDF

Light · A4 210 × 297 mm · PDF

Dark · A4 210 × 297 mm · PDF

Ink saver · A4 210 × 297 mm · PDF

Light · A4 landscape 297 × 210 mm · PDF

Dark · A4 landscape 297 × 210 mm · PDF

Ink saver · A4 landscape 297 × 210 mm · PDF

Light · A3 297 × 420 mm · PDF

Dark · A3 297 × 420 mm · PDF

Ink saver · A3 297 × 420 mm · PDF

Light · A3 landscape 420 × 297 mm · PDF

Dark · A3 landscape 420 × 297 mm · PDF

Ink saver · A3 landscape 420 × 297 mm · PDF

Light · Letter 8.5 × 11 in · PDF

Dark · Letter 8.5 × 11 in · PDF

Ink saver · Letter 8.5 × 11 in · PDF

Light · Tabloid 11 × 17 in · PDF

Dark · Tabloid 11 × 17 in · PDF

Ink saver · Tabloid 11 × 17 in · PDF

Start here

tree

Show this directory as a tree

tree <dir>

Show another directory

tree -L 2

Limit depth to 2 levels

tree -a

Include hidden files

tree -d

Directories only

tree -I '<pattern>'

Hide matching names

tree -h

Show sizes, readable

tree --gitignore

Respect .gitignore

Concepts

Walk -L, -a, -x, -l
Filter -P, -I, --prune
Sort -t, -r, --dirsfirst
Print -h, -p, -D, -J, -H

Listing

tree

Print the current directory as a tree

tree <dir> ...

Several directories at once

tree -L <n>

Descend at most n levels

tree -a

Show hidden files too

tree -d

List directories only

tree -f

Print the full path of each entry

tree -l

Follow symlinks to directories

tree -x

Stay on one filesystem

tree --noreport

Omit the final count line

tree --filelimit <n>

Skip dirs holding more than n entries

tree --condense

Merge single-child dir chains

tree -i

No indentation lines (flat list)

Pair with -f for a plain list of paths.

tree -F

Append type markers (/ * @ |)

tree -Q

Quote filenames

Filtering

tree -I '<glob>'

Hide matching files and dirs

tree -I 'node_modules|dist'

Hide several names

tree -P '<glob>'

Show only matching files

tree -P '*.py' --prune

Matching files, no empty dirs

tree --gitignore

Apply .gitignore rules

tree --gitfile <file>

Use another ignore file

tree --matchdirs

Apply -P to directory names

tree --ignore-case

Case-insensitive -P and -I

tree --prune

Drop empty directories

Details

tree -h

Human-readable sizes

tree -s

Sizes in bytes

tree --du

Directory totals (implies -s)

tree --si

Sizes in powers of 1000

tree -p

Show permissions

tree -u / -g

Show owner / group

tree -D

Show modification date

tree --timefmt '<fmt>'

Date format (strftime), implies -D

tree -pugh

Mode, owner, group and size

tree --inodes

Show inode numbers

tree --metafirst

Metadata before the tree lines

Sorting

tree --dirsfirst

Directories before files

tree --filesfirst

Files before directories

tree -t

Sort by modification time

tree -r

Reverse the order

tree -v

Natural version sort (v2 before v10)

tree --sort <key>

name, size, mtime, ctime, version, none

tree -U

Unsorted, directory order

Output

tree -J

JSON output

tree -X

XML output

tree -H <baseHREF>

HTML page with links

tree -H . -T '<title>' -o <file>

HTML with title to a file

tree -o <file>

Write output to a file

tree -n

Never colourise

tree -C

Force colour, even in a pipe

Needed for `tree -C | less -R`.

tree -A

ANSI line-drawing characters

tree --charset <name>

Output charset (e.g. ASCII)

tree --hyperlink

Clickable OSC 8 file links

tree --fromfile .

Build a tree from paths on stdin

Recipes

Project overview

tree -a -L 3 --gitignore -I '.git' --dirsfirst# -I '.git': --gitignore does not hide the .git dir itself

Biggest directories

tree --du -h -L 2 --sort size -r# totals per directory, largest first

Tree of a file list

git ls-files | tree --fromfile .find . -name '*.md' | tree --fromfile .

Share it as JSON or HTML

tree -J -L 2 src > tree.jsontree -H . -T 'Docs' -o index.html docs/