I have MacVim installed and I am trying to set it up as the editor for Git (version control), but I can't run 'mvim' from the command line as it isn't recognised. How do I setup mvim so I can run it from Terminal?
12 Answers
I don't think I'd to add anything to the path, did
brew install macvim
mvim -v
should then open macvim in the terminal, you can also go ahead and alias that
alias vim='mvim -v'
-
39Anyone reading this today using homebrew you'll have to run
brew linkapps
after installing macvim. Sep 29, 2011 at 18:20 -
1The '-v' option works if you've installed from source or from download as well as shown in other answers. Oct 17, 2012 at 1:37
-
7
-
If running
brew linkapps
didn't help, also runbrew doctor
and watch for macvim-related warning messages - you may need to runbrew link --overwrite macvim
if suggested.– ArtJul 11, 2016 at 12:42 -
There should be a script named mvim in the root of the .bz2 file. Copy this somewhere into your $PATH ( /usr/local/bin would be good ) and you should be sorted.
-
9
-
2A year ago that was what you got when you downloaded MacVim. Now it's a.tbz file, but the script is still there. Mar 9, 2011 at 10:39
-
6You can locate the file by using find from your root directory.
sudo find . -name mvim
Mine was in /Applications/MacVim-snapshot-64/mvim.– tltjrAug 26, 2012 at 21:32 -
20Since mvim is simply a shell script, you can download it directly from the MacVim source at GitHub here: raw.github.com/b4winckler/macvim/master/src/MacVim/mvim Sep 26, 2012 at 19:43
-
10As per :help mvim I had to add
/Applications/MacVim.app/Contents/bin
to my path then it worked fine.– hraynaudSep 22, 2017 at 18:21
If you go the brew route, the best way to install would be:
brew install macvim --with-override-system-vim
That will provide mvim, vim, vi, view, etc. in /usr/local/bin (all symlinked to the copy in the Cellar). This also removes the need to create any aliases and also changes your vi, vim, etc. to all use the same Vim distribution as your MacVim.
-
Whilst the
--override-system-vim
did create some of the symlinks for me, it failed to override/usr/bin/vim
and/usr/bin/vi
and so I still had to manuallyalias
these in my.profile
. Feb 8, 2012 at 18:49 -
12Dave, that sounds like a PATH problem, /usr/local/bin needs to be first in your PATH. This answer, pointing at brew, should be the number one answer, as it gets you everything you need. Feb 16, 2012 at 0:03
-
3fyi running
brew doctor
should notify you of any PATH or configuration issues for brew.– AndrewAug 2, 2012 at 15:43 -
Awesome! Thanks for posting this. I added --override-system-vim and didn't even realize how useful it would be.– xer0xMar 28, 2014 at 2:25
-
If you already have macVim installed: /Applications/MacVim.app/Contents/MacOS/Vim -g
will give you macVim GUI.
just add an alias.
i use gvim
because that is what i use on linux for gnome-vim.
alias gvim='/Applications/MacVim.app/Contents/MacOS/Vim -g'
-
1Also using
alias vim=/Applications/MacVim.app/Contents/MacOS/Vim
is a great idea. Then you don't need to install MacVim via either MacPorts or Homebrew to update Vim in your terminal, you can just install the release packages from the GitHub release page.– w0rpApr 19, 2017 at 8:59 -
2Note: also useful if homebrew refuses to install macvim because you're staying on "this old version" of macOS for whatever reason. :)– tekHeddMay 17, 2020 at 18:30
-
2Thanks for that tip, @tekHedd. I'm staying on "this old version" of macOS because I have 32-bit versions of expensive software that I don't want to replace and which has been converted to a subscription model, so I'm keeping the "old" OS so I can run the "old" software that I paid for "in perpetuity" for as long as I reasonably can. YMMV.– AugustNov 26, 2020 at 8:02
In addition, if you want to use MacVim (or GVim) as $VISUAL
or $EDITOR
, you should be aware that by default MacVim will fork a new process from the parent, resulting in the MacVim return value not reaching the parent process. This may confuse other applications, but Git seems to check the status of a temporary commit message file, which bypasses this limitation. In general, it is a good practice to export VISUAL='mvim -f'
to ensure MacVim will not fork a new process when called, which should give you what you want when using it with your shell environment.
Assume MacVim is installed in the Application folder.
Instead of adding MacVim path to your environment, create a link by typing this in terminal:
sudo ln -s /Applications/MacVim.app/Contents/bin/mvim /usr/local/bin/mvim
Then, open a new terminal window/tab and type mvim
.
If you have homeBrew installed, this is all you have to do:
brew install macvim
brew linkapps
Then type mvim
in your terminal to run MacVim.
-
Well that's how to do it with a fresh installation, I think he's asking how to make an alias when it's already installed. May 9, 2016 at 3:27
-
2Warning:
brew linkapps
has been deprecated and will eventually be removed!– MarkFeb 13, 2017 at 18:41
Here's what I did:
After building Macvim I copied mvim to one of my $PATH destinations (In this case I chose /usr/local/bin)
cp -v [MacVim_source_folder]/src/MacVim/mvim /usr/local/bin
Then when you invoke mvim it is now recognised but there is an annoying thing. It opens the visual MacVim window, not the one in terminal. To do that, you have to invoke
mvim -v
To make sure every time you call mvim you don't have to remember to add the '-v' you can create an alias:
alias mvim='mvim -v'
However, this alias will only persist for this session of the Terminal. To have this alias executed every time you open a Terminal window, you have to include it in your .profile The .profile should be in your home directory. If it's not, create it.
cd ~
mvim -v .profile
include the alias command in there and save it.
That's it.
-
Tried this but it didn't work for me. VIM_APP_DIR=~/Downloads/MacVim-snapshot-64/MacVim.app $ mvim -v x.x Sorry, cannot find MacVim.app. Try setting the VIM_APP_DIR environment variable to the directory containing MacVim.app. Mar 6, 2012 at 16:09
-
This works when you build MacVim from source, github.com/macvim-dev/macvim/blob/master/README_mac.txt, thanks @douglas– mbenegasNov 4, 2015 at 17:45
-
1
-
1With this
-v
flag changing the font doesn't work.-v
enables vi mode. Can imagine that other things don't work in this mode, besides setting a custom font.– UserApr 1, 2018 at 11:47
I'm adding Bard Park's comment here for that was the real answer for me:
Since mvim is simply a shell script, you can download it directly from the MacVim source at GitHub here: http://raw.github.com/b4winckler/macvim/master/src/MacVim/mvim
-
/usr/local/bin was in my PATH, but the bin folder was absent. I had trouble working directly in /usr/local, (probably a permissions issue), so I created a bin directory in my Documents folder. There I created an mvim file, into which I copied the contents of Bard Park's link. I dragged the bin folder with the mvim script to /usr/local. I was asked for my password, then allowed to place the mvim script where I wanted it. But the script didn't run yet. I entered: sudo chmod 755 mvim to give the script execute permissions. Now from the command line when I type mvim filename, MacVim launches. Nov 6, 2015 at 18:50
-
In order to drag the bin folder into /usr/local, first I entered: open . from the command line in /usr/local. Doing so brings up the finder GUI for that file location. Nov 6, 2015 at 19:39
I'd seriously recommend installing MacVim via MacPorts (sudo port install MacVim
).
When installed, MacPorts automatically updates your profile to include /opt/local/bin in your path, and so when mvim is installed as /opt/local/bin/mvim during the install of MacVim you'll find it ready to use straight away.
When you install the MacVim port the MacVim.app bundle is installed in /Applications/MacPorts for you too.
A good thing about going the MacPorts route is that you'll also be able to install git too (sudo port install git-core
) and many many other ports. Highly recommended.
-
1Thanks I'll give this a go. I installed MacVim and Git using the UI installers. But its looking like Macports is the way to go.– FredJan 13, 2010 at 18:44
-
56Don't use mac port versions unless you absolutely need to. It installs all the dependency libraries ignoring darwin native ones. This can i.e. replace your perl 5.10 with 5.8 in path etc. Check homebrew (brew) system instead. May 26, 2010 at 14:03
-
3@SlavaNadvorny maybe true when this was written. I currently have a development environment with MacVim, scipy, haskell, multiple versions of erlang, python and perl all functioning properly with macports. The same was not possible with brew (at this time this was written). I do like brew's non-sudo install and wished it worked in this case.– user246672Mar 5, 2012 at 16:08
-
-
fwiw, I used both normal MacVim app (installed via downloaded) and the MacPorts version (
sudo port install MacVim
), in fact at one point, I had both installed (which is fine, but unnecessary). Theport
MacVim didn't have the "version" string set (it was null) and asked to upgrade itself (via the gui) which produced an error (no permission, of course), so since I wasn't sure what version I was running, I ultimatelyport uninstall MacVim
and just kept the "normal" MacVim app, and updated my pathPATH=$PATH:/Applications/MacVim.app/Contents/bin
to findmvim
etc from terminal.– michaelJan 7 at 12:43
This works for me:
λ brew link --overwrite macvim
Linking /usr/local/Cellar/macvim/8.0-146_1... 12 symlinks created
For Mac .app
bundles, you should install them via cask, if available, as using symlinks can cause issues. You may even get the following warning if you brew linkapps
:
Unfortunately
brew linkapps
cannot behave nicely with e.g. Spotlight using either aliases or symlinks and Homebrew formulae do not build "proper".app
bundles that can be relocated. Instead, please consider usingbrew cask
and migrate formulae using.app
s to casks.
For MacVim, you can install with:
brew cask install macvim
You should then be able to launch MacVim like you do any other macOS app, including mvim
or open -a MacVim
from a terminal session.
UPDATE: A bit of clarification about brew
and brew cask
. In a nutshell, brew
handles software at the unix level, whereas brew cask
extends the functionality of brew
into the macOS domain for additional functionality such as handling the location of macOS app bundles. Remember that brew
is also implemented on Linux so it makes sense to have this division. There are other resources that explain the difference in more detail, such as What is the difference between brew
and brew cask
?
so I won't say much more here.
-
Could we add some clarity about what the difference between using the cask install vs not cask install? Hard to tell what the differences are when both cask and not cask install commands work...– ftrotterNov 5, 2019 at 20:55
-
I added a short blurb but I don't know all the details so I didn't go into detail.– Ryan H.Nov 7, 2019 at 15:05
vim
from the command-line.echo $PATH
") and add the folder to the MacVim executable to it if it's not there already (use "export PATH=$PATH:path/to/folder
"). Mind the$
signs, they are important!