sponsor Vim development Vim logo Vim Book Ad

vtreeexplorer : tree based file explorer - the original

 script karma  Rating 908/287, Downloaded by 22215  Comments, bugs, improvements  Vim wiki

created by
scott urban
script type
Creates a tree based file explorer within vim.

This is like the directory explorer plugin that ships with vim, but instead of presenting just one directory at a time, this plugin present portions of the filesystem hierarch in a tree view.  This type of view should be familiar from modern graphical file managers.  This explorer persents navigation, exploration, and opening of files only -  unlike the standard directory explorer that allow you to delete and rename files.   This a handy tool for becoming familiar with source trees.

Feature summary:
- directories are foldable (fold markers are highlighted invisible)
- directories and links are syntax highlighted
- open a file in a new window
- mappings for naviagation (keyboard and mouse) - goto parent, change dir, go up, cd to home, refesh, etc
- lazy loading of directory structure - one directory at a time.  Recursive expansion also available.

May not work well for obscure systems - unix and windows work well.  Please send bugs or patches.

This is a reimplementation of the treeexplorerer (see http://vim.sourceforge.net/scripts/script.php?script_id=183 ) that doesn't require perl or the tree command - it's pure vim.

install details
1. un-gzip, untar in your $HOME/.vim, $VIMRUNTIME, or equivalent directories.  Or un-gzip and un-tar and source the vtreeexplorer.vim file to test.

2. you can add the help to your help index with :helptags ~/.vim/doc (if you put the files there).


quick help is at top of window

See vtreeexplorer.txt of :help vtreeexplorer (if you did :helptags above) for more detailed help.

rate this script Life Changing Helpful Unfulfilling 
script versions (upload new version)

Click on the package to download.

package script version date Vim version user release notes
vtreeexplorer-1.28.tar.gz 1.28 2007-12-28 7.0 scott urban Added 'O' command which replaces explorer window with editing of file when activated on file in tree - idea from Brian Doyle.
vtreeexplorer-1.27.tar.gz 1.27 2007-11-10 7.0 scott urban Add feature where files and directories matching global variable g:treeExplHidePattern will be not shown.  Can be updated at anytime.  Hiding toggled with the existing mechanism. Thanks to Vaclav Kulakovsky for the idea and patch.
vtreeexplorer-1.26.tar.gz 1.26 2007-11-10 7.0 scott urban Fix for bug that occurs when opening a file after splitting the vtree window. Thanks to genelisp/isaac
vtreeexplorer-1.25.tar.gz 1.25 2007-11-10 7.0 scott urban Added support for tabs with the 'e' shortcut - thanks to Krzysztof Kościuszkiewicz
vtreeexplorer-1.24.tar.gz 1.24 2006-08-21 7.0 scott urban Don't clobber yank register, fixes for vim 7, misc fixes.  Thanks to A. Kruize, D. Mayle, M. Grentel
vtreeexplorer-1.23.tar.gz 1.23 2005-10-30 6.0 scott urban Fixes for functionality on windows.
vtreeexplorer-1.22.tar.gz 1.22 2005-10-28 6.0 scott urban - bug fix for vim6 - thanks to Steve Hall
- avoid register clobbering - thanks to Bindu Wavell
vtreeexplorer-1.21.tar.gz 1.21 2005-10-27 6.0 scott urban - more compact default layout (width of tree layout is customizable)
- updated contact info
vtreeexplorer-1.20.tar.gz 1.20 2004-12-30 6.0 scott urban Auto-loading for TreeExplorer buffer type - useful if you save and restore a session with the explorer in it. Updated email address.
vtreeexplorer-1.19.tar.gz 1.19 2003-01-26 6.0 scott urban Fix for filenames that contain '#' - thanks to Klaus Fabritius.
vtreeexplorer.tar.gz 1.16 2002-09-19 6.0 scott urban Minor fix when opening modified buffer that is  already open in more than 1 window - Yegappan Lakshman
vtreeexplorer.tar.gz 1.15 2002-07-23 6.0 scott urban Syntax bug - must have hit  'J' instead of 'j' at some point.
vtreeexplorer.tar.gz 1.14 2002-07-22 6.0 scott urban Add mapping for mouse button on tree - like 'open' (thanks to Douglas Potts).
vtreeexplorer.tar.gz 1.13 2002-02-17 6.0 scott urban Bugfix for VSTreeExplore - thanks to Benoit Cerrina
Added help documenation.
vtreeexplorer.vim 1.10 2002-01-18 6.0 scott urban Added directory sorting and D mapping to toggle between 3 modes. Highlighting change for links. Support for opening more than one tree explorer at once.  Code cleanups and factoring.
vtreeexplorer.vim 1.9 2002-01-17 6.0 scott urban Added ~ to chars escaped in file names. Suppressed message output. Handle when top dir is of the form C:\ for dos/win systems.
vtreeexplorer.vim 1.8 2002-01-17 6.0 scott urban Changed recursive expand from E to X mapping. Added E mapping to open regular file explorer on cursor dir.  Added :CD command to switch to direcotry (useful maybe to CD: D: on windows?) - still some escaping bugs on that one.  Fixed bug for dirs/files that start with tree parts. Better escaping of file/dir names. Other minor fixes and clean ups.
vtreeexplorer.vim 1.7 2002-01-17 6.0 scott urban Added command to refresh cursor dir.  Added command to recursively expand subdirs of cursor dir (caution: this could take a long time for big subdir trees).  Changed the hidded files toggle to refresh current dir after. Fixes for windows. Other minor fixes. Using CVS version numbers now, sorry for the jump.
vtreeexplorer.vim 1.01 2002-01-16 6.0 scott urban Fixed problem with esaping dir names with spaces - still some issues with using it in windows.
vtreeexplorer.vim 1.0 2002-01-16 6.0 scott urban Initial upload
ip used for rating:

If you have questions or remarks about this site, visit the vimonline development pages. Please use this site responsibly.
Questions about Vim should go to the maillist. Help Bram help Uganda.
Vim at Github