A python package to manage your vim themes/plugins
Python Vim script
Switch branches/tags
Clone or download
Latest commit b339818 Oct 21, 2017
Failed to load latest commit information.
ohmyvim search url Oct 21, 2017
plugin Fix pathogen warning from runtime_append_all_bundles deprecation Jul 1, 2013
profiles help Nov 15, 2012
snippets clean snippets Dec 30, 2011
templates buildout 2 Nov 3, 2013
tools update install script Oct 21, 2017
.gitignore ignore some files Jan 5, 2012
LICENSE licence. fix #19 Dec 23, 2016
MANIFEST.in add some tests Dec 11, 2011
README.rst require py3 Oct 22, 2016
bootstrap.py py3 Oct 22, 2016
buildout.cfg py3 Oct 22, 2016
setup.cfg add some tests Dec 11, 2011
setup.py bump version Dec 14, 2011


Oh My Vim!

This package allow you to manage your vim plugins

It's heavily inspired from oh-my-zsh


You must have python3.X installed on your system.

It's recommended to install oh-my-vim as a non root user.

If you don't know python and virtualenv then just run the install script:

$ curl https://raw.github.com/gawel/oh-my-vim/master/tools/install.sh | sh -

Or with wget:

$ wget --no-check-certificate -O- https://raw.github.com/gawel/oh-my-vim/master/tools/install.sh | sh -

If you know virtualenv/pip then run this in a virtualenv:

$ pip install oh-my-vim
$ bin/oh-my-vim upgrade

Have a look at your ~/.vimrc:

$ vim ~/.vimrc

And select your favorites profiles.


Browse all VimL projects available on github in your favorite browser:

$ oh-my-vim search [-t] [term]

Installation. You can use a git url or a requires.txt file/url wich contains git urls:

$ oh-my-vim install [--full] [giturl|requires.txt]

The --full options allow to install some extra dependencies. For example syntastic require flake8 and jslint. oh-my-vim will try to install them for you.

Remove a bundle:

$ oh-my-vim remove [bundle1|bundle2|...]

List installed packages:

$ oh-my-vim list

List all packages listed in Oh My Vim's registry:

$ oh-my-vim list -a

Generate a requires.txt file:

$ oh-my-vim list -u > requires.txt

Upgrade bundles (and oh-my-vim python package):

$ oh-my-vim upgrade [--full] [bundle1|bundle2|...]

Useful links


I'm a newbie. Can oh-my-vim turn me into a Vim guru ?

No, but it can help you to setup a friendly environment.

After the installation step install some useful plugins with the following:

$ oh-my-vim install -d useful

Then have a look at the defaults and map profiles and enable them in your .vimrc

You're now ready to go...!

What if I already use pathogen ?

Nothing. Just remove the pathogen stuff from your vimrc

Can I use oh-my-vim from Vim ?

Yes, and you should. You'll get some completion. Just use :OhMyVim <args>

Can I install a bundle from a mercurial repository ?

Yes. You just need to prefix your url with hg+:

$ oh-my-vim install hg+https://bitbucket.org/sjl/gundo.vim

Good project but I'm missing a feature. Can you add it ?

No. But you can. Fork the repository and submit a pull request.

I have a cool plugin and I want to add it to oh-my-vim-registry

Submit a pull request after adding it to the registry

Does oh-my-vim work on windows ?

No, it wont be so hard to port but I'm not supporting this OS

This is a great project. Can I offer you a beer ?