sponsor Vim development Vim logo Vim Book Ad

Projx : Light weight project explorer

 script karma  Rating 5/5, Downloaded by 1594  Comments, bugs, improvements  Vim wiki

created by
Sureshkumar Manimuthu
script type
projx is a simple to install, light weight project explorer plugin. It opens a project navigation panel on  the right/left side of the vim screen. When enter is pressed on a file name the file is opened in a new tab or jumps to an existing tab that already has the file
It supports project wide grep that will show all the instances in the quickfix window.
When enabled, it automatically creates and updates tag file for the list of files in the project.

Works well with cppnav plugin

To use this plugin, simply place a .projx file in the root of working directory with all the file names (with relative path) in the project (one per line)
:Projx [<project file>] to open or close the project navigation panel. Optionally specify the project file name to this command.
:Pgrep <regx> to search for a string across all the files in the project. Results are listed in the quickfix window. Preview/jump to the location using p or <enter> keys.
:Ptags to update the tag file. This plugin automatically updates the tag file on init (if any of the file is newer than the tag file)
:Pfilter <wildcard expression> to see only the specific files on the navigation panel
Set the following variables in .vimrc/_vimrc file to control some of the options.
let g:projx_file_def = <default project file name>           " .projx is used by default
let g:projx_right_win = <1/0>                                            " use right/left navigation panel
let g:projx_win_size = xxx                                                 " set the navigation panel width to xxx
let g:projx_ctag_path = <ctag executable name/path> " omit this to disable tab file creation
install details
Linux/Unix/Cygwin : Copy the projx.vim to ~/.vim/plugin/
Windows : Copy the projx.vim to %HOME%\vimfiles\plugin\

Some useful shortcuts to add to .vimrc/_vimrc
  nmap <silent> <F3> :Pgrep expand("<cword>")<CR>  "search word under cursor
  nmap <silent> <F7> :Projx<CR>  " Open/Close project panel
  nmap <silent> <Tab>     <C-W><C-W> " Tab to jump between windows

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
projx.vim 1.1 2013-11-25 7.0 Sureshkumar Manimuthu Auto resize the navigation panel when vim is resized.
projx.vim 1.0 2013-11-21 7.0 Sureshkumar Manimuthu 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