Github url


by spf13

spf13 /spf13-vim

The ultimate vim distribution

14.5K Stars 3.7K Forks Last release: Not found Apache License 2.0 951 Commits 0 Releases

Available items

No Items, yet!

The developer of this repository has not created any items for sale yet. Need a bug fixed? Help with integration? A different license? Create a request here:

spf13-vim : Steve Francia's Vim Distribution

\_\_ \_ \_\_\_\_\_ \_ \_\_\_ \_ \_\_ / \_/ |\_\_\_ / \_\_ \_\_(\_)\_ \_\_ \_\_\_ / \_\_| '\_ \| |\_| | |\_ \ \_\_\_\_\_\ \ / /| | '\_ ` \_ \ \_\_ \ |\_) | \_| |\_\_\_) |\_\_\_\_\_|\ V / | | | | | | | |\_\_\_/ .\_\_/|\_| |\_|\_\_\_\_/ \_/ |\_|\_| |\_| |\_| |\_|

spf13-vim is a distribution of vim plugins and resources for Vim, Gvim and MacVim.

It is a good starting point for anyone intending to use VIM for development running equally well on Windows, Linux, *nix and Mac.

The distribution is completely customisable using a




, and


Vim RC files.

spf13-vim image

Unlike traditional VIM plugin structure, which similar to UNIX throws all files into common directories, making updating or disabling plugins a real mess, spf13-vim 3 uses the Vundle plugin management system to have a well organized vim directory (Similar to mac's app folders). Vundle also ensures that the latest versions of your plugins are installed and makes it easy to keep them up to date.

Great care has been taken to ensure that each plugin plays nicely with others, and optional configuration has been provided for what we believe is the most efficient use.

Lastly (and perhaps, most importantly) It is completely cross platform. It works well on Windows, Linux and OSX without any modifications or additional configurations. If you are using MacVim or Gvim additional features are enabled. So regardless of your environment just clone and run.



To make all the plugins work, specifically neocomplete, you need vim with lua.

Linux, *nix, Mac OSX Installation

The easiest way to install spf13-vim is to use our automatic installer by simply copying and pasting the following line into a terminal. This will install spf13-vim and backup your existing vim configuration. If you are upgrading from a prior version (before 3.0) this is also the recommended installation.

Requires Git 1.7+ and Vim 7.3+

curl -L \> && sh

If you have a bash-compatible shell you can run the script directly: ```bash


Installing on Windows On Windows and *nix [Git] and [Curl] are required. Also, if you haven't done so already, you'll need to install [Vim]. The quickest option to install all three dependencies ([Git], [Curl], [Vim] and [spf13-vim]) is via [Chocolatey] NuGet. After installing [Chocolatey], execute the following commands on the _command prompt_: C:\> choco install spf13-vim _Note: The [spf13-vim package] will install Vim also!_ If you want to install [msysgit], [Curl] and [spf13-vim] individually, follow the directions below. ### Installing dependencies #### Install [Vim] After the installation of Vim you must add a new directory to your environment variables path to make it work with the script installation of spf13. Open Vim and write the following command, it will show the installed directory: :echo $VIMRUNTIME C:\Program Files (X86)\Vim\vim74 Then you need to add it to your environment variable path. After that try execute vim within command prompt (press Win-R, type cmd, press Enter) and you’ll see the default vim page. #### Install [msysgit] After installation try running git --version within _command prompt_ (press Win-R, type cmd, press Enter) to make sure all good: C:\> git --version git version 1.7.4.msysgit.0 #### Setup [Curl] _Instructions blatently copied from vundle readme_ Installing Curl on Windows is easy as [Curl] is bundled with [msysgit]! But before it can be used with [Vundle] it's required make curl run in _command prompt_. The easiest way is to create curl.cmd with this content @rem Do not use "echo off" to not affect any child calls. @setlocal @rem Get the abolute path to the parent directory, which is assumed to be the @rem Git installation root. @for /F "delims=" %%I in ("%dp0..") do @set git_install_root=%%fI @set PATH=%git_install_root%\bin;%git_install_root%\mingw\bin;%PATH% @if not exist "%HOME%" @set HOME=%HOMEDRIVE%%HOMEPATH% @if not exist "%HOME%" @set HOME=%USERPROFILE% @curl.exe %* And copy it to C:\Program Files\Git\cmd\curl.cmd, assuming [msysgit] was installed to c:\Program Files\Git to verify all good, run: C:\> curl --version curl 7.21.1 (i686-pc-mingw32) libcurl/7.21.1 OpenSSL/0.9.8k zlib/1.2.3 Protocols: dict file ftp ftps http https imap imaps ldap ldaps pop3 pop3s rtsp smtp smtps telnet tftp Features: Largefile NTLM SSL SSPI libz #### Installing spf13-vim on Windows The easiest way is to download and run the spf13-vim-windows-install.cmd file. Remember to run this file in **Administrator Mode** if you want the symlinks to be created successfully. ## Updating to the latest version The simpliest (and safest) way to update is to simply rerun the installer. It will completely and non destructively upgrade to the latest version. ```bash curl -L -o - | sh

Alternatively you can manually perform the following steps. If anything has changed with the structure of the configuration you will need to create the appropriate symlinks.

cd $HOME/to/spf13-vim/ git pull vim +BundleInstall! +BundleClean +q

### Fork me on GitHub

I'm always happy to take pull requests from others. A good number of people are already [contributors]( to [spf13-vim]( Go ahead and fork me.

# A highly optimized .vimrc config file

![spf13-vimrc image](

The .vimrc file is suited to programming. It is extremely well organized and folds in sections. Each section is labeled and each option is commented.

It fixes many of the inconveniences of vanilla vim including
  • A single config can be used across Windows, Mac and linux
  • Eliminates swap and backup files from littering directories, preferring to store in a central location.
  • Fixes common typos like :W, :Q, etc
  • Setup a solid set of settings for Formatting (change to meet your needs)
  • Setup the interface to take advantage of vim's features including
    • omnicomplete
    • line numbers
    • syntax highlighting
    • A better ruler & status line
    • & more
  • Configuring included plugins






for any local customizations.

For example, to override the default color schemes:

echo colorscheme ir\_black \>\> ~/.vimrc.local

Before File

Create a


file to define any customizations that get loaded before the spf13-vim



For example, to prevent autocd into a file directory:

bash echo let g:spf13\_no\_autochdir = 1 \>\> ~/.vimrc.before.local

For a list of available spf13-vim specific customization options, look at the



Fork Customization

There is an additional tier of customization available to those who want to maintain a fork of spf13-vim specialized for a particular group. These users can create




files in the root of their fork. The load order for the configuration is:

  1. .vimrc.before
    • spf13-vim before configuration
  2. .vimrc.before.fork
    • fork before configuration
  3. .vimrc.before.local
    • before user configuration
  4. .vimrc.bundles
    • spf13-vim bundle configuration
  5. .vimrc.bundles.fork
    • fork bundle configuration
  6. .vimrc.bundles.local
    • local user bundle configuration
  7. .vimrc
    • spf13-vim vim configuration
  8. .vimrc.fork
    • fork vim configuration
  9. .vimrc.local
    • local user configuration



for specifics on what options can be set to override bundle configuration. See


for specifics on what options can be overridden. Most vim configuration options should be set in your


file, bundle configuration needs to be set in your



You can specify the default bundles for your fork using


file. Here is how to create an example


file in a fork repo for the default bundles.

bash echo let g:spf13\_bundle\_groups=[\'general\', \'programming\', \'misc\', \'youcompleteme\'] \>\> .vimrc.before.fork

Once you have this file in your repo, only the bundles you specified will be installed during the first installation of your fork.

You may also want to update your


file so that the

link points to your repository and your

file to pull down your fork.

For an example of a fork of spf13-vim that provides customization in this manner see taxilian's fork.

Easily Editing Your Configuration


opens a new tab containing the .vimrc configuration files listed above. This makes it easier to get an overview of your configuration and make customizations.


sources the .vimrc file, instantly applying your customizations to the currently running vim instance.

These two mappings can themselves be customized by setting the following in .vimrc.before.local:

bash let g:spf13\_edit\_config\_mapping='<leader>ev'
let g:spf13_apply_config_mapping='<leader>sv'


spf13-vim contains a curated set of popular vim plugins, colors, snippets and syntaxes. Great care has been made to ensure that these plugins play well together and have optimal configuration.

Adding new plugins



for any additional bundles.

To add a new bundle, just add one line for each bundle you want to install. The line should start with the word "Bundle" followed by a string of either the project name or the githubusername/githubprojectname. For example, the github project spf13/vim-colors can be added with the following command

echo Bundle \'spf13/vim-colors\' \>\> ~/.vimrc.bundles.local

Once new plugins are added, they have to be installed.

vim +BundleInstall! +BundleClean +q

Removing (disabling) an included plugin



if it doesn't already exist.

Add the UnBundle command to this line. It takes the same input as the Bundle line, so simply copy the line you want to disable and add 'Un' to the beginning.

For example, disabling the 'AutoClose' and 'scrooloose/syntastic' plugins

echo UnBundle \'AutoClose\' \>\> ~/.vimrc.bundles.local echo UnBundle \'scrooloose/syntastic\' \>\> ~/.vimrc.bundles.local

Remember to run ':BundleClean!' after this to remove the existing directories

Here are a few of the plugins:


If you undo changes and then make a new change, in most editors the changes you undid are gone forever, as their undo-history is a simple list. Since version 7.0 vim uses an undo-tree instead. If you make a new change after undoing changes, a new branch is created in that tree. Combined with persistent undo, this is nearly as flexible and safe as git ;-)

Undotree makes that feature more accessible by creating a visual representation of said undo-tree.

QuickStart Launch using




NERDTree is a file explorer plugin that provides "project drawer" functionality to your vim editing. You can learn more about it with

:help NERDTree


QuickStart Launch using




  • Use
    to toggle NERDTree
  • Use
    to load NERDTreeFind which opens NERDTree where the current file is located.
  • Hide clutter ('.pyc', '.git', '.hg', '.svn', '.bzr')
  • Treat NERDTree more like a panel than a split.


Ctrlp replaces the Command-T plugin with a 100% viml plugin. It provides an intuitive and fast mechanism to load files from the file system (with regex and fuzzy find), from open buffers, and from recently used files.

QuickStart Launch using




This plugin is a tool for dealing with pairs of "surroundings." Examples of surroundings include parentheses, quotes, and HTML tags. They are closely related to what Vim refers to as text-objects. Provided are mappings to allow for removing, changing, and adding surroundings.

Details follow on the exact semantics, but first, consider the following examples. An asterisk (*) is used to denote the cursor position.

Old text Command New text ~ "Hello \*world!" ds" Hello world! [123+4\*56]/2 cs]) (123+456)/2 "Look ma, I'm \*HTML!" cs"<q> <q>Look ma, I'm HTML!</q>
  if *x&gt;3 { ysW( if ( x&gt;3 ) {
  my $str = *whee!; vllllS' my $str = 'whee!';

For instance, if the cursor was inside

"foo bar"

, you could type


to convert the text to

'foo bar'


There's a lot more, check it out at

:help surround


NERDCommenter allows you to wrangle your code comments, regardless of filetype. View

help :NERDCommenter

or checkout my post on NERDCommenter.

QuickStart Toggle comments using


in Visual or Normal mode.


Neocomplete is an amazing autocomplete plugin with additional support for snippets. It can complete simulatiously from the dictionary, buffer, omnicomplete and snippets. This is the one true plugin that brings Vim autocomplete on par with the best editors.

QuickStart Just start typing, it will autocomplete where possible


  • Automatically present the autocomplete menu
  • Support tab and enter for autocomplete
  • <c-k></c-k>
    for completing snippets using Neosnippet.

neocomplete image


YouCompleteMe is another amazing completion engine. It is slightly more involved to set up as it contains a binary component that the user needs to compile before it will work. As a result of this however it is very fast.

To enable YouCompleteMe add


to your list of groups by overriding it in your


like so:

let g:spf13\_bundle\_groups=['general', 'programming', 'misc', 'scala', 'youcompleteme']

This is just an example. Remember to choose the other groups you want here.

Once you have done this you will need to get Vundle to grab the latest code from git. You can do this by calling


. You should see YouCompleteMe in the list.

You will now have the code in your bundles directory and can proceed to compile the core. Change to the directory it has been downloaded to. If you have a vanilla install then

cd ~/.spf13-vim-3/.vim/bundle/YouCompleteMe/

should do the trick. You should see a file in this directory called There are a few options to consider before running the installer:

  • Do you want clang support (if you don't know what this is then you likely don't need it)?
    • Do you want to link against a local libclang or have the installer download the latest for you?
  • Do you want support for c# via the omnisharp server?

The plugin is well documented on the site linked above. Be sure to give that a read and make sure you understand the options you require.

For java users wanting to use eclim be sure to add

let g:EclimCompletionMethod = 'omnifunc'

to your .vimrc.local.


Syntastic is a syntax checking plugin that runs buffers through external syntax checkers as they are saved and opened. If syntax errors are detected, the user is notified and is happy because they didn't have to compile their code or execute their script to find them.


AutoClose does what you expect. It's simple, if you open a bracket, paren, brace, quote, etc, it automatically closes it. It handles curlys correctly and doesn't get in the way of double curlies for things like jinja and twig.


Fugitive adds pervasive git support to git directories in vim. For more information, use

:help fugitive



to view

git status

and type


on any file to stage or unstage it. Type


on a file to enter

git add -p

and stage specific hunks in the file.



on an open file to see what changes have been made to that file



to bring up git status


  • <leader>gs</leader>
  • <leader>gd</leader>
  • <leader>gc</leader>
  • <leader>gb</leader>
  • <leader>gl</leader>
  • <leader>gp</leader>
    :Git push
  • <leader>gw</leader>
  • :Git ___ will pass anything along to git.

fugitive image


The most feature complete and up to date PHP Integration for Vim with proper support for PHP 5.3+ including latest syntax, functions, better fold support, etc.

PIV provides:

  • PHP 5.3 support
  • Auto generation of PHP Doc (,pd on (function, variable, class) definition line)
  • Autocomplete of classes, functions, variables, constants and language keywords
  • Better indenting
  • Full PHP documentation manual (hit K on any function for full docs)

php vim itegration image


Ack.vim uses ack to search inside the current directory for a pattern. You can learn more about it with

:help Ack

QuickStart :Ack


Tabularize lets you align statements on their equal signs and other characters


  • <leader>a= :Tabularize /=<cr></cr></leader>
  • <leader>a: :Tabularize /:<cr></cr></leader>
  • <leader>a:: :Tabularize /:\zs<cr></cr></leader>
  • <leader>a, :Tabularize /,<cr></cr></leader>
  • <leader>a<bar> :Tabularize /<bar><cr></cr></bar></bar></leader>


spf13-vim includes the Tagbar plugin. This plugin requires exuberant-ctags and will automatically generate tags for your open files. It also provides a panel to navigate easily via tags



while the cursor is on a keyword (such as a function name) to jump to its definition.

Customizations: spf13-vim binds


to toggle the tagbar panel

tagbar image

Note: For full language support, run

brew install ctags

to install exuberant-ctags.

Tip: Check out

:help ctags

for information about VIM's built-in ctag support. Tag navigation creates a stack which can traversed via


(to find the source of a token) and


(to jump back up one level).


EasyMotion provides an interactive way to use motions in Vim.

It quickly maps each possible jump destination to a key allowing very fast and straightforward movement.

QuickStart EasyMotion is triggered using the normal movements, but prefixing them with


For example this screen shot demonstrates pressing


easymotion image


Airline provides a lightweight themable statusline with no external dependencies. By default this configuration uses the symbols


as separators for different statusline sections but can be configured to use the same symbols as Powerline. An example first without and then with powerline symbols is shown here:

airline image

To enable powerline symbols first install one of the Powerline Fonts or patch your favorite font using the provided instructions. Configure your terminal, MacVim, or Gvim to use the desired font. Finally add

let g:airline\_powerline\_fonts=1

to your



Additional Syntaxes

spf13-vim ships with a few additional syntaxes:

  • Markdown (bound to *.markdown, *.md, and *.mk)
  • Twig
  • Git commits (set your
    mvim -f

Amazing Colors

spf13-vim includes solarized and spf13 vim color pack:

  • ir_black
  • molokai
  • peaksea


:color molokai

to switch to a color scheme.

Terminal Vim users will benefit from solarizing their terminal emulators and setting solarized support to 16 colors:

let g:solarized\_termcolors=16 color solarized

Terminal emulator colorschemes:


It also contains a very complete set of snippets for use with snipmate or neocomplete.

Intro to VIM

Here's some tips if you've never used VIM before:



  • VIM has two (common) modes:
    • insert mode- stuff you type is added to the buffer
    • normal mode- keys you hit are interpreted as commands
  • To enter insert mode, hit
  • To exit insert mode, hit

Useful commands

  • Use
    to exit vim
  • Certain commands are prefixed with a
    key, which by default maps to
    . Spf13-vim uses
    let mapleader = ","
    to change this to
    which is in a consistent and convenient location.
  • Keyboard cheat sheet.

AnalyticsBitdeli Badge

We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.