sponsor Vim development Vim logo Vim Book Ad

LeaderF : Quickly locate files, buffers, mrus, tags, ... in large project.

 script karma  Rating 76/28, Downloaded by 2335  Comments, bugs, improvements  Vim wiki

created by
Yggdroot Chen
 
script type
utility
 
description
LeaderF

This plugin is mainly used for locating files, buffers, mrus, tags in large project.

Written in Python.
Support fuzzy and regex searching.
Manage buffers and mrus.
Open multiple files at once.
Extensible.

Screenshots
https://github.com/Yggdroot/Images/blob/master/leaderf/leaderf_1.gif
https://github.com/Yggdroot/Images/blob/master/leaderf/leaderf_2.gif

Requirements

vim7.3 or higher. Only support vim7.4.330 or higher after v1.01.
vim compiled with Python support, you can check by using echo has('python') or echo has('python3') to see if the result is 1; Make sure that your python2 version is Python 2.7 or higher and python3 version is Python 3.1 or higher.
Installation

To install this plugin just put the plugin files in your ~/.vim (Linux) or ~/vimfiles (Windows).
For Vundle user, just add Plugin 'Yggdroot/LeaderF' to your .vimrc.

Usage

:LeaderfFile or :LeaderfFile [directory] or ,f
Launch LeaderF to search files.

:LeaderfBuffer or ,b
Launch LeaderF to search buffers.

:LeaderfMru
Launch LeaderF to search Mru.

:LeaderfMruCwd
Launch LeaderF to search Mru in current working directory.

:LeaderfTag
Launch LeaderF to navigate tags.

:LeaderfBufTag
Launch LeaderF to navigate tags in current buffer.

:LeaderfBufTagAll
Launch LeaderF to navigate tags in all opening buffers.

Once LeaderF is launched:

<C-C> : quit from LeaderF.
<C-R> : switch between fuzzy search mode and regex mode.
<C-F> : switch between full path search mode and name only search mode.
<ESC> : switch to normal mode.
<C-V>, <S-Insert> : paste from clipboard.
<C-U> : clear the prompt.
<C-J>, <Down>, <C-K>, <Up> : navigate the result list.
<2-LeftMouse> or <CR> : open the file under cursor or selected(when multiple files are selected).
<C-X> : open in horizontal split window.
<C-]> : open in vertical split window.
<C-T> : open in new tabpage.
<F5> : refresh the cache.
<C-LeftMouse> or <C-S> : select multiple files.
<S-LeftMouse> : select consecutive multiple files.
<C-A> : select all files.
<C-L> : clear all selections.
<BS> : delete the preceding character in the prompt.
<Del> : delete the current character in the prompt.
<Home>: move the cursor to the begin of the prompt.
<End> : move the cursor to the end of the prompt.
<Left>: move the cursor one character to the left.
<Right> : move the cursor one character to the right.

Github:
    https://github.com/Yggdroot/LeaderF
 
install details
To install this plugin just put the plugin files in your ~/.vim (Linux) or ~/vimfiles (Windows).
For Vundle user, just add Plugin 'Yggdroot/LeaderF' to your .vimrc.
 

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
LeaderF-master.zip 1.20 2019-05-27 8.0 Yggdroot Chen Feature #191: add support for GNU Global(Leaderf gtags)
For more details: Leaderf gtags -h
LeaderF-master.zip 1.19 2018-12-29 7.4 Yggdroot Chen Feature #57: Add support for rg(Leaderf rg)
For more details: Leaderf rg -h
Feature #130: Add Changelog file.
Feature #208: Add support for input file list.
Add --file option for Leaderf file.
Feature #213: Add support for input history.
Use <UP> and <Down> to loop the input history.
Add one-dark colorscheme.
Add --nowrap option for LeaderF.
LeaderF-1.11.zip 1.11 2017-07-07 7.4 Yggdroot Chen 0. Add async support
1. Better fuzzy match algorithm.
2. Faster speed.
3. Better tool to find the tags.
LeaderF.zip 1.0.4 2017-03-25 7.4 Yggdroot Chen 7.4.330 or higher
LeaderF.zip 1.0.3 2014-03-28 7.0 Yggdroot Chen fix a bug
ip used for rating: 18.217.144.32

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