Skip to main content

Curses Tree Style Path Picker

Project description


A Curses based, Tree style, Path Picker. For use as a terminal based file dialog library.


  • Pre-order file system traversal from a given point, or $PWD if not specified.
  • Expand or collapse child nodes one at a time or all at once.
  • Recursively get disk usage of a single node or all expanded nodes.
  • Toggle display of dotfiles.
  • Toggle marking of files that can then be piped into another program or simply echoed back to the screen upon exit.
  • Reset marking and expansion.
USAGE: [-h] [-a] [path]

Select paths from a directory tree.

path          A valid path.

-h, --help    Show this help message and exit.
-a, --hidden  Show all hidden paths too.


Key Action
UP, k, p Go up one line.
DOWN, j, n Go down one line.
RIGHT, l, f Expand child node, and move down one line (into child).
LEFT, h, b Collapse child node.
Tab Toggle expansion/collapse of child node.
PGDN, d, v Move down a page of lines at a time.
PGUP, V, u Move up a page of lines at a time.
J, N Move to next child node, of parent. (needs some TLC!)
K, P Move to parent node. (also currently pretty broken!)
g, < Move to first line.
G, > Move to last line.
m, SPC, RET Toggle marking of paths.
. Toggle display of dotfiles.
s Display total size of path, recursively
S Display, totol size of all currently expanded paths.
r Reset marking and expansion.
q, e, ESC Quit and display all marked paths.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for treepick, version 0.0.3
Filename, size File type Python version Upload date Hashes
Filename, size treepick-0.0.3-py3-none-any.whl (7.8 kB) File type Wheel Python version py3 Upload date Hashes View
Filename, size treepick-0.0.3.tar.gz (5.7 kB) File type Source Python version None Upload date Hashes View

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring DigiCert DigiCert EV certificate Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page