Simple, color-coded, pretty printed directory tree cli tool.

Print Pretty Tree

a.k.a. ptree is a simple Python script that displays the directory tree of the current working directory with color-coded output for easy file identification.


To install print-pretty-tree, you can use either pip or other package managers like npm, pnpm, or yarn.

Install using pip

If you have Python and pip installed:

pip install print-pretty-tree --user

Install using other package managers

If you have npm 5.2 or higher, we recommend using npx to run packages globally. This way, you don't need to install the package globally and can still use it as a tool.

npx print-pretty-tree

If you still want to install print-pretty-tree globally, on the command line, run the following command:

npm install -g print-pretty-tree

If you get an EACCES permissions error, you may need to reinstall npm with a version manager or manually change npm's default directory. For more information, see the npm docs here.


Once you have installed print-pretty-tree, you can run the script in any directory.

You can run any of the commands below in any directory, regardless of how you installed it.


The script excludes certain files and folders like node_modules and .git by default to make the output easier to manage. It will recursively display the directory structure in a visually pleasing way.

Local Development

# clone the repo
git clone https://github.com/itsbrex/print-pretty-tree.git
# cd into the repo
cd print-pretty-tree
# build the package
python3 -m build


  • To add more file types and colors to the output, you can modify the FILE_TYPE_COLORS dictionary in the script.
  • You can also customize the excluded file patterns by modifying the EXCLUDED_PATTERNS list in the script.