Mac OS X GUI for Neovim
Objective-C++ C++ VimL Objective-C Python Shell Makefile
Latest commit 7e22f6e Nov 5, 2016 @bambu bambu committed on GitHub Merge pull request #297 from bambu/vim_locale
Fixed --version inconsistencies during make based on Locale

OS X GUI for Neovim


This source code is distributed under the terms of the GNU General Public License, version 3:


What's Done

Text editing, mouse support, tabs, clipboard, Mac menus, font selection, font size adjustments, confirm-on-close, multiple windows.

Still to do

See the list of issues.

Pull requests are welcome, and greatly appreciated!


See here.



  • compiles on OS X 10.9, 10.10 and 10.11.
  • You'll need to install Xcode and its command-line tools.
  • Homebrew isn't required but it's an easy way to install the rest of the dependencies.

Install via Homebrew

$ brew tap neovim/neovim
$ brew tap rogual/neovim-dot-app
$ brew install neovim-dot-app
$ brew linkapps neovim-dot-app

Install manually


$ brew install scons


$ brew install msgpack

A Neovim binary

$ brew tap neovim/homebrew-neovim
$ brew install --HEAD neovim

To compile:

$ make

This will look for a Neovim executable on your PATH. To specify an executable to use, just set the NVIM environment variable, e.g.:

$ NVIM=/path/to/nvim make

When the .app bundle is created, Vim's runtime files will be copied into it. By default, the build script asks Vim where its runtime files are, and Vim will probably say they're somewhere under /usr.

If you're compiling your own Neovim, and you don't want to install the runtime files system-wide, the build script can copy the runtime files directly from your neovim checkout. Just set VIM when compiling, e.g.:

$ VIM=/path/to/your/neovim/checkout make

If you're setting one of these options, you'll most likely want to set both.

Problems Compiling?

  • error: no member named 'ext' in 'msgpack::object::union_type'

This means your msgpack is out of date. Try:

brew uninstall msgpack
brew update
brew install msgpack
  • 'msgpack.hpp' file not found
  • ld: library not found for -lmsgpack

Homebrew installs things into /usr/local, but the compiler doesn't look there unless you've run:

xcode-select --install

so try doing that!

Running the Tests

$ build/test


I'm having Python problems

Neovim uses the first Python it finds on your PATH. If you've launched Neovim from anywhere other than a terminal, it will only see your system PATH, which probably doesn't have that fancy new version of Python you've installed on it.

To point Neovim at the Python installation you want to use, put this in your .nvimrc:

let g:python_host_prog='/path/to/python'