fMacVim

MacVim + essential plugins + my custom .vimrc

Introduction

I don't see this as another collection of dotfiles, but a practical selection of the best plugins and configs for those willing to enjoy the power of Vim on their Mac. I was inspired by YADR and spf13-vim, or other famous alternatives like Janus, but I did not wanted to have such a big package, I wanted to keep it even simpler.

If you don't like the idea of the complete package, I strongly encourage you to scrabble and take anything you may like in here! But I expect you to (at least) say hi if you like it :P This includes GNU/Linux users, because most of the code in here must work as well for you (I'm using it actually :P).

Installation

I provide you with two options (the easy or the easiest):

1) Easy install

Clone this repositoty and execute the installation script:

git clone git://github.com/fbeeper/fMacVim.git 
cd fMacVim 
./install.sh

Besides the opportunity of re-customization, this installation includes terminal support for the customized Vim, including the Solarized theme.

Note that you will find an uninstaller too ;)

./uninstall.sh

2) The easiest install

I took MacVim, included all plugins and configs in the package for you to drag and drop it into your /Applications directory:

Download and enjoy!

Details

fMacVim includes:

• The best .vimrc I've been able to curate (no blogger/githubber was harmed on this process :P). Even though I didn't kept it minimal, I've made an effort to organize and comment everything. You should take a look at it!

• A personal selection of essential vim plugins:

  • Pathogen.vim (super easy plugin management) by Tim Pope

  • Solarized (pleasant colorscheme) by Ethan Schoonover

  • Powerline (cool statusline replacement) by Kim Silkebækken

  • Menlo patched for powerline (nice font with support for Powerline coolness) by Steve Losh

  • NERDTree (useful file system explorer) by Martin Grenfell

  • NERDCommenter (comment your code easily ,cl ,cu) by Martin Grenfell

  • Signature (easy marks and signs) by kshenoy

  • Clang complete (C/C++ completion using clang) by Xavier Deguillard

  • Supertab (handy addition for text completion) by Eric Van Dewoestine

  • SnipMate (snippets galore!) originally by Michael Sanders but current package by Rok Garbas

  • Fugitive.vim (nice git integration) by Tim Pope

  • Gitv ('gitk clone' plugin for fugitive) by Greg Sexton

  • Gundo (Missing Lion's file versioning at Vim? :P) by Steve Losh

  • OpenGL and GLSL syntax hl (the missing highlighting) by Marc Costa

• Custom key bindings:

  Quick access to useful commands:

  • F1 Toggle Gundo, navigate and use the history tree of your editions
  • F2 Toggle NERDTree, navigate your FS right from Vim
  • F3 Toggle PASTE mode, paste without breaking indentation
  • F4 Toggle Gitv, explore git history right from Vim
  • F5/F6 Change theme mode Dark/Light
  • F7 Toggle invisibles
  • F8 Run make
  • F9 Activate auto-closing brackets
  • F10 De-activate auto-closing brackets

  Safari-like tab switching

  • Ctrl+Tab/Ctrl+Shift+Tab Circle back and forth
  • Cmd+1-9 Go to specific tabs

  Search

  • # and * To search back and forth (working for visual selections too!)
  • , Enter To remove search highlighting

  Other bindings

  • , is mapped as Vim's <leader> (just in case you look for it)
  • , cl/cu Comment/uncomment lines thanks to NERDCommenter
  • z f/d Create/Delete folds (configured to work manually and will be preserved between sessions)
  • Space Will toggle folds in normal mode
  • , n Toggle line numbering mode in normal mode
  • And a huge list of things Vim could do

Anyway, I strongly encourage you to have a look at my .vimrc to discover what changes/customizations I've done! :D

What's the future of fMacVim?

This is nowhere near to be perfect, so I expect to bring future updates.

• An updater would be really necessary!
• I should build .vimrc and .gvimrc separately, I know!
• I should consider splitting the .vimrc to make it easier to navigate/maintain.
• I will consider creating a custom Toolbar/Menu.
• A better documentation would be interesting, wouldn't it?
• I've got some shortcuts/functions I haven't added to this release I might add in the future. Or not... because it would mean not keeping this simple.
• I'm thinking to remove OpenGL highlighting from this package, it may be too specific for my needs.
• I really want to make this package compatible for Linux too, with gtk-vim instead of MacVim :)

I'd be pleased to hear any comments, ideas, code, questions, or whatever you may want to say!

You'll easily find me at: github.com/fbeeper, or @fbeeper.

License

JIC anybody asks, the Vim licence seems a good fit for any of the "work" I've done packing this ;) For any other concerns about licensing, take a look at:

:help license