sponsor Vim development Vim logo Vim Book Ad

Filesearch : Filesystem searching using glob or regular expression patterns

 script karma  Rating 55/16, Downloaded by 1809  Comments, bugs, improvements  Vim wiki

created by
Jeet Sukumaran
script type
'Filesearch' is a plugin for searching the local filesystem for files by name
or content. The searches can be done using either glob patterns (searching for
filenames only) or regular expression patterns (searching for filenames or
file content).

Three commands are provided:

    :Fsglob /{glob}/[filetype-options] [paths]

        Search filesystem for files with names matching the glob pattern
        given by {glob}, which can include wildcard characters.

    :Fsfind /{pattern}/[filetype-options] [paths]

        Search filesystem for files with names matching the regular expression
        pattern given by {pattern}.

    :Fsgrep /{pattern}/[filetype-options] [paths]

        Search filesystem for files with lines of content matching the regular
        expression pattern {pattern}.

By default searches are carried out recursively starting from the current
directory, but the search paths can be adjusted through the use of optional
arguments. Searches can also be restricted to specific filetypes through the
use of filetype filter options (e.g., "py" for Python files, "cpp" for C++
source and header files).

Results will be shown in new buffer (the "catalog viewer"). They can be
browsed using all the normal Vim movement keys, and can be selected for
viewing the in main (previous) window, a new vertical or horizontal split
window, or new tab page.

Detailed usage description is given in the help file, which can be viewed
on-line here:


The public source code repository can be found here:


Vim has much of this functionality built-in (e.g. "vimgrep", "find").  But I
find that the browsing, navigation and management of the results from these
native Vim commands not the most convenient. For example, `:find` automatically
goes to the first match, and you have to type `:2find` to go to the second
match. I would prefer to view the results in single buffer, apply normal Vim
search and movement commands to navigate to the results of my choice, and the
ability to easily open target files/lines in a new window or tab page. There
are also a number of plugins that do achieve something similar (e.g., the
excellent 'Ack' plugin). But I wanted to be able to use Vim-dialect regular
expressions when working inside Vim, and also wanted a little more control over
how the results are displayed and sorted. Thus, I wrote this plugin.
install details
If Pathogen is installed, you can install Filesearch by unpacking the source
archive in $VIMRUNTIME/bundle.  Otherwise, unpack the source archive and copy
"autoload/filesearch.vim" to $VIMRUNTIME/autoload, "plugin/filesearch.vim" to $VIMRUNTIME/plugin and "doc/filesearch.txt" to

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
vim-filesearch-v1.2.0.tar.gz 1.2.0 2011-07-06 7.0 Jeet Sukumaran - Do not clobber default register when rendering buffer.
- Reorganization of into autoload plugin (thanks Kien N).
vim-filesearch-v1.0.0.tar.gz 1.0.0 2011-06-27 7.0 Jeet Sukumaran Alternate archive format.
vim-filesearch-v1.0.0.zip 1.0.0 2011-06-27 7.0 Jeet Sukumaran 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.