https://github.com/rogual/neovim-dot-app

Mac OS X GUI for Neovim
https://github.com/rogual/neovim-dot-app

Last synced: about 20 hours ago
JSON representation

Mac OS X GUI for Neovim

• Host: GitHub
• URL: https://github.com/rogual/neovim-dot-app
• Owner: rogual
• Created: 2015-03-24T16:37:50.000Z (almost 10 years ago)
• Default Branch: master
• Last Pushed: 2020-10-01T07:02:14.000Z (over 4 years ago)
• Last Synced: 2024-11-29T19:45:50.143Z (2 months ago)
• Language: Objective-C++
• Homepage:
• Size: 853 KB
• Stars: 1,131
• Watchers: 24
• Forks: 62
• Open Issues: 65
• Metadata Files:
  • Readme: README.md
  • Contributing: CONTRIBUTING.md

Awesome Lists containing this project

README

        
# OS X GUI for Neovim

![](https://raw.githubusercontent.com/rogual/neovim-osx-gui/screenshots/1.png)

## License

This source code is distributed under the terms of the GNU General

Public License, version 3:

http://www.gnu.org/licenses/gpl-3.0.html

## Features

### 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](https://github.com/rogual/neovim-dot-app/issues).

Pull requests are welcome, and greatly appreciated!

## Contributing

See [here](https://github.com/rogual/neovim-dot-app/blob/master/CONTRIBUTING.md).

## Compiling

### Prerequisites

* Neovim.app compiles on OS X 10.9 to 10.14.

* 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.

### Dependencies

#### SCons

    $ brew install scons

#### MsgPack-C

    $ 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

## Q&A

### 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'