Home

UPDATE

We recently, June 2016, started to migrate the MacVim backend (VimR-MacVim) to a NeoVim backend (VimR-NeoVim). The old wiki can be found in VimR MacVim.

init.vim

• Don't forget to set termguicolors in your init.vim, e.g. vim-airline will look strange without this option set.

Supported Gestures

• Pinch to zoom in or out.
• Two-finger scrolling.

Ligatures

• Turn it on in the Appearance Preferences.

$PATH in VimR

We set $PATH of neovim to the result of the following command:

$SHELL -l -c "env | grep '^PATH=' | sed 's/^PATH=//'" # without -l when $SHELL is tcsh

where we get $SHELL from NSProcessInfo.

Command Line Tool

VimR comes with a command line tool vimr:

$ vimr file1 file2 ...     # opens file1, file2, ... in tabs in the front most window.
$ vimr -n file1 file2 ...  # opens file1, file2, ... in tabs in a new window.
$ vimr -s file1 file2 ...  # opens file1, file2, ... in separate new windows
$ vimr --cwd /some/path    # set the working directory to /some/path
$ vimr -h                  # show help
usage: vimr [-h] [--dry-run] [--cwd CWD] [-n | -s] [file [file ...]]

Open files in VimR: By default all files are open in tabs in the front most
window or in a new window if there is none. The working directory will be set
to the current directory.

positional arguments:
  file

optional arguments:
  -h, --help  show this help message and exit
  --dry-run   Just print the 'open' command.
  --cwd CWD   Set the working directory.
  -n          Open files in tabs in a new window.
  -s          Open files in separate windows.

It can be installed via Preferences ➝ General ➝ "Copy 'vimr' CLI tool..." button:

VimR Specific Settings in init.vim

if has("gui_vimr")
" VimR specific settings like
"	color xyz
endif

TBD