Shell Python HTML Ruby
Need help with vimrc?
Click the “chat” button below for chat support from the developer who created it, or find similar developers for support.
amix

Description

The ultimate Vim configuration (vimrc)

23.2K Stars 6.2K Forks MIT License 399 Commits 19 Opened issues

Services available

Need anything else?

VIM

The Ultimate vimrc

Over the last 10 years, I have used and tweaked Vim. This configuration is the ultimate vimrc (or at least my version of it).

There are two versions:

  • The Basic: If you want something small just copy basic.vim into your ~/.vimrc and you will have a good basic setup
  • The Awesome: Includes a ton of useful plugins, color schemes, and configurations

I would, of course, recommend using the awesome version.

How to install the Awesome version?

Install for your own user only

The awesome version includes a lot of great plugins, configurations and color schemes that make Vim a lot better. To install it simply do following from your terminal:

git clone --depth=1 https://github.com/amix/vimrc.git ~/.vim_runtime
sh ~/.vim_runtime/install_awesome_vimrc.sh

Install for multiple users

To install for multiple users, the repository needs to be cloned to a location accessible for all the intended users.

git clone --depth=1 https://github.com/amix/vimrc.git /opt/vim_runtime
sh ~/.vim_runtime/install_awesome_parameterized.sh /opt/vim_runtime user0 user1 user2
# to install for all users with home directories
sh ~/.vim_runtime/install_awesome_parameterized.sh /opt/vim_runtime --all

Naturally,

/opt/vim_runtime
can be any directory, as long as all the users specified have read access.

Fonts

I recommend using IBM Plex Mono font (it's an open-source and awesome font that can make your code beautiful). The Awesome vimrc is already setup to try to use it.

Some other fonts that Awesome will try to use:

How to install the Basic version?

The basic version is just one file and no plugins. Just copy basic.vim and paste it into your vimrc.

The basic version is useful to install on remote servers where you don't need many plugins, and you don't do many edits.

git clone --depth=1 https://github.com/amix/vimrc.git ~/.vim_runtime
sh ~/.vim_runtime/install_basic_vimrc.sh

How to install on Windows?

Use gitforwindows to checkout the repository and run the installation instructions above. No special instructions needed ;-)

How to install on Linux

If you have vim aliased as

vi
instead of
vim
, make sure to either alias it:
alias vi=vim
. Otherwise,
apt-get install vim

How to update to latest version?

Just do a git rebase!

cd ~/.vim_runtime
git pull --rebase
python update_plugins.py

Some screenshots

Colors when editing a Python file:

Screenshot 1

NERD Tree plugin in a terminal window: Screenshot 3

Distraction free mode using goyo.vim and vim-zenroom2: Screenshot 4

Included Plugins

I recommend reading the docs of these plugins to understand them better. Each plugin provides a much better Vim experience!

  • ack.vim: Vim plugin for
    the_silver_searcher
    (ag) or ack -- a wicked fast grep
  • bufexplorer.zip: Quickly and easily switch between buffers. This plugin can be opened with
    
    
  • ctrlp.vim: Fuzzy file, buffer, mru and tag finder. It's mapped to
    
    
  • goyo.vim and vim-zenroom2:
  • lightline.vim: A light and configurable statusline/tabline for Vim
  • NERD Tree: A tree explorer plugin for vim
  • openfileunder_cursor.vim: Open file under cursor when pressing
    gf
  • pathogen.vim: Manage your vim runtimepath
  • snipmate.vim: snipmate.vim aims to be a concise vim script that implements some of TextMate's snippets features in Vim
  • ale: Syntax and lint checking for vim (ALE requires NeoVim >= 0.2.0 or Vim 8 with +timers +job +channel)
  • vim-commentary: Comment stuff out. Use
    gcc
    to comment out a line (takes a count),
    gc
    to comment out the target of a motion.
    gcu
    uncomments a set of adjacent commented lines.
  • vim-expand-region: Allows you to visually select increasingly larger regions of text using the same key combination
  • vim-fugitive: A Git wrapper so awesome, it should be illegal
  • vim-indent-object: Defines a new text object representing lines of code at the same indent level. Useful for python/vim scripts
  • vim-multiple-cursors: Sublime Text style multiple selections for Vim, CTRL+N is remapped to CTRL+S (due to YankRing)
  • vim-yankstack: Maintains a history of previous yanks, changes and deletes
  • vim-zenroom2 Remove all clutter and focus only on the essential. Similar to iA Writer or Write Room
  • gist-vim Easily create gists from Vim using the
    :Gist
    command

Included color schemes

Included modes

How to include your own stuff?

After you have installed the setup, you can create ~/.vimruntime/myconfigs.vim to fill in any configurations that are important for you. For instance, my my_configs.vim looks like this:

~/.vim_runtime (master)> cat my_configs.vim
map ct :cd ~/Desktop/Todoist/todoist
map cw :cd ~/Desktop/Wedoist/wedoist 

You can also install your plugins, for instance, via pathogen you can install vim-rails:

cd ~/.vim_runtime
git clone git://github.com/tpope/vim-rails.git my_plugins/vim-rails

Key Mappings

The leader is

,
, so whenever you see
 it means 
,
.

Normal mode mappings

Fast saving of a buffer (

w
):
nmap w :w!

Map

 to 
/
(search) and
+
to
?
(backwards search):
map  /
map  ?
map   :noh

Disable highlights when you press

:
map   :noh

Smart way to move between windows (

j
etc.):
map  j
map  k
map  h
map  l

Closing of the current buffer(s) (

bd
and (
ba
)):
" Close current buffer
map bd :Bclose

" Close all buffers map ba :1,1000 bd!

Useful mappings for managing tabs:

map tn :tabnew
map to :tabonly
map tc :tabclose
map tm :tabmove 

" Opens a new tab with the current buffer's path " Super useful when editing files in the same directory map te :tabedit =expand("%:p:h")/

Switch CWD to the directory of the open buffer:

map cd :cd %:p:h:pwd

Open

ack.vim
for fast search:
map g :Ack 

Quickly open a buffer for scripbble:

map q :e ~/buffer

Toggle paste mode on and off:

map pp :setlocal paste!

Visual mode mappings

Visual mode pressing

*
or
#
searches for the current selection:
vnoremap  * :call VisualSelection('f')
vnoremap  # :call VisualSelection('b')

When you press gv you

Ack.vim
after the selected text:
vnoremap  gv :call VisualSelection('gv', '')

When you press

r
you can search and replace the selected text:
vnoremap  r :call VisualSelection('replace')

Surround the visual selection in parenthesis/brackets/etc.:

vnoremap $1 `>a)`
vnoremap $2 `>a]`
vnoremap $3 `>a}`
vnoremap $$ `>a"`
vnoremap $q `>a'`
vnoremap $e `>a``

Insert mode mappings

Quickly insert parenthesis/brackets/etc.:

inoremap $1 ()i
inoremap $2 []i
inoremap $3 {}i
inoremap $4 {o}O
inoremap $q ''i
inoremap $e ""i
inoremap $t <>i

Insert the current date and time (useful for timestamps):

iab xdate =strftime("%d/%m/%y %H:%M:%S")

Command line mappings

$q is super useful when browsing on the command line. It deletes everything until the last slash:

cno $q eDeleteTillSlash()

Bash like keys for the command line:

cnoremap       
cnoremap       
cnoremap       

cnoremap cnoremap

Write the file as sudo (works only on Unix). Super useful when you open a file and you don't have permissions to save your changes. Vim tip:

:W 

Plugin related mappings

Open bufexplorer to see and manage the current buffers (

o
):
map o :BufExplorer

Open ctrlp.vim plugin to quickly find a file or a buffer (

j
or
f
):
" Quickly find and open a file in the CWD
let g:ctrlp_map = ''

" Quickly find and open a recently opened file map f :MRU

" Quickly find and open a buffer map b :CtrlPBuffer

NERD Tree mappings:

map nn :NERDTreeToggle
map nb :NERDTreeFromBookmark 
map nf :NERDTreeFind

goyo.vim and vim-zenroom2 lets you only focus on one thing at a time. It removes all the distractions and centers the content. It has a special look when editing Markdown, reStructuredText and textfiles. It only has one mapping. (

z
)
map z :Goyo

vim-multiple-cursors mappings to manage multiple cursors at once:

let g:multi_cursor_start_word_key      = ''
let g:multi_cursor_select_all_word_key = ''
let g:multi_cursor_start_key           = 'g'
let g:multi_cursor_select_all_key      = 'g'
let g:multi_cursor_next_key            = ''
let g:multi_cursor_prev_key            = ''
let g:multi_cursor_skip_key            = ''
let g:multi_cursor_quit_key            = ''

vim-yankstack mappings to manage the kill-ring (clipboard):

nmap  yankstack_substitute_older_paste
nmap  yankstack_substitute_newer_paste

ctrl-p mappings to easily find and open a file, buffer, etc.:

let g:ctrlp_map = ''
map j :CtrlP
map  :CtrlPBuffer

vim-snipmate mappings to autocomplete via snippets:

ino  =snipMate#TriggerSnippet()
snor  i=snipMate#TriggerSnippet()

vim-surround mappings to easily surround a string with

_()
gettext annotation:
vmap Si S(i_f)
au FileType mako vmap Si S"i${ _(2f"a) }

ale to easily go to the next Ale syntax/lint error:

nmap  a (ale_next_wrap)

Spell checking

Pressing

ss
will toggle spell checking:
map ss :setlocal spell!

Shortcuts using

 instead of special characters:
map sn ]s
map sp [s
map sa zg
map s? z=

Cope

Query

:help cope
if you are unsure what cope is. It's super useful!

When you search with

Ack.vim
, display your results in cope by doing:
cc

To go to the next search result do:

n

To go to the previous search results do:

p

Cope mappings:

map cc :botright cope
map co ggVGy:tabnew:set syntax=qfpgg
map n :cn
map p :cp

How to uninstall

Just do following: * Remove

~/.vim_runtime
* Remove any lines that reference
.vim_runtime
in your
~/.vimrc

Looking for a remote-first job?

Maintaining this Vim configuration isn't my day job. Daily I am the founder/CEO of Doist. You could come and help us build the workplace of the future while living a balanced life (anywhere in the world 🌍🌎🌏).

PS: Using Vim isn't a requirement 😄

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.