Difference between revisions of "Installing Emacs on OS X"

From WikEmacs
Jump to: navigation, search
m (Download and install Aquamacs)
(updated emacs version in path)
(18 intermediate revisions by 8 users not shown)
Line 1: Line 1:
Obtaining Emacs 24 on OS X is really simple. There are several popular ways to do it.  
+
OS X comes with a preinstalled version of Emacs, but alas it is the outdated Emacs 22. Fortunately, obtaining a newer release is really simple. There are several popular ways to do it.  
  
==== As a binary package ====
+
== Emacs 24 ==
  
Simply download a pretest (or a nightly build) from [http://emacsformacosx.com Emacs for OSX].  Probably the best option would be to get the latest pretest from [http://emacsformacosx.com/builds here].
+
=== As a binary package ===
  
==== Build it from source ====
+
Simply download a binary from [http://emacsformacosx.com Emacs for OSX]
  
The second easy way to obtain Emacs 24 is via [http://mxcl.github.com/homebrew/ homebrew]. Just type the following incantation in your shell and you’re done:
+
=== MacPorts ===
 +
 
 +
If you have [https://www.macports.org/ MacPorts] installed, you can just do:
  
 
<source lang="bash">
 
<source lang="bash">
$ brew install emacs --cocoa --use-git-head --HEAD
+
$ sudo port install emacs
$ cp -r /usr/local/Cellar/emacs/HEAD/Emacs.app /Applications/
+
</source>
 +
 
 +
to install Emacs 24. The MacPorts installer updates your PATH environment variable, so the MacPorts build of Emacs should be found by your shell before the (outdated) build that comes with Mac OS when you type 'emacs'. If you prefer the Emacs.app build, that's available by executing:
 +
 
 +
<source lang="bash">
 +
$ sudo port install emacs-app
 +
</source>
 +
 
 +
=== Homebrew ===
 +
 
 +
Emacs 24 is also available via [http://mxcl.github.com/homebrew/ homebrew]. Just type the following incantation in your shell and you’re done:
 +
 
 +
<source lang="bash">
 +
$ brew update
 +
$ brew install emacs --cocoa
 +
$ ln -s /usr/local/Cellar/emacs/24.3/Emacs.app /Applications
 +
or
 +
$ cp -r /usr/local/Cellar/emacs/24.3/Emacs.app /Applications/
 
</source>
 
</source>
 
The second step is optional, but it’s recommended if you like to start Emacs from the launchpad or from Spotlight.
 
The second step is optional, but it’s recommended if you like to start Emacs from the launchpad or from Spotlight.
Line 21: Line 40:
 
$ sudo rm -rf /usr/share/emacs
 
$ sudo rm -rf /usr/share/emacs
 
</source>
 
</source>
That’s all folk! You may now proceed to the configuration section.
 
  
==== Use a package manager (Emacs 23 only at time of writing) ====
+
Or just create an alias in your shell and when you invoke 'emacs' it will run the newly installed version:
  
* Fink
 
* MacPorts
 
 
<source lang="bash">
 
<source lang="bash">
port install emacs
+
$ alias emacs="/usr/local/Cellar/emacs/24.2/Emacs.app/Contents/MacOS/Emacs -nw"
 
</source>
 
</source>
  
You can add <tt>+<variant> [+<variant>...]</tt> where <tt>variant</tt> is one or more of:
+
To make it permanent, if using bash, add that line to ~/.bash_profile.
* dbus: Builds emacs with D-Bus support
+
 
* gtk: Builds emacs as an X11 program with GTK+2 widgets
+
That’s all folk! You may now proceed to the configuration section.
* motif: Builds emacs as an X11 program with Motif
+
 
* universal: Build for multiple architectures
+
== Emacs 23 ==
* x11: Builds emacs as a X11 program with Lucid widgets
+
 
The gtk, motif and x11 variants require (depend on) MacPorts' X11 libraries. They're mutually exclusive.
+
Binaries for Emacs 23 are still available from [http://emacsformacosx.com/builds Emacs for OSX].
  
==== Download and install [http://aquamacs.org Aquamacs] ====
+
== Aquamacs ==
  
A near-OS-X-native port of GNU Emacs, integrating Emacs with all the features of Mac OS X.
+
A near-OS-X-native port of GNU Emacs, integrating Emacs with all the features of Mac OS X. Available [http://aquamacs.org/ here]. As of this writing, the latest version (2.4) is based on Emacs 23.3. Comes bundled with some handy packages like [[AUCTeX]].
  
[[Category:OS X]][[Category:Beginner]][[Category:Install Or Upgrade]][[Category:Emacs 23]][[Emacs 24]]
+
[[Category:OS X]][[Category:Beginner]][[Category:Install Or Upgrade]][[Category:Emacs-23]][[Category:Emacs-23.4]][[Category:Emacs-24]]

Revision as of 07:44, 18 March 2013

OS X comes with a preinstalled version of Emacs, but alas it is the outdated Emacs 22. Fortunately, obtaining a newer release is really simple. There are several popular ways to do it.

Emacs 24

As a binary package

Simply download a binary from Emacs for OSX

MacPorts

If you have MacPorts installed, you can just do:

$ sudo port install emacs

to install Emacs 24. The MacPorts installer updates your PATH environment variable, so the MacPorts build of Emacs should be found by your shell before the (outdated) build that comes with Mac OS when you type 'emacs'. If you prefer the Emacs.app build, that's available by executing:

$ sudo port install emacs-app

Homebrew

Emacs 24 is also available via homebrew. Just type the following incantation in your shell and you’re done:

$ brew update
$ brew install emacs --cocoa
$ ln -s /usr/local/Cellar/emacs/24.3/Emacs.app /Applications
or
$ cp -r /usr/local/Cellar/emacs/24.3/Emacs.app /Applications/

The second step is optional, but it’s recommended if you like to start Emacs from the launchpad or from Spotlight.

Chances are good you have an older version of Emacs installed by default with OS X. It's suggested you to remove that older Emacs version to avoid conflicts with the new one. Do this:

$ sudo rm /usr/bin/emacs
$ sudo rm -rf /usr/share/emacs

Or just create an alias in your shell and when you invoke 'emacs' it will run the newly installed version:

$ alias emacs="/usr/local/Cellar/emacs/24.2/Emacs.app/Contents/MacOS/Emacs -nw"

To make it permanent, if using bash, add that line to ~/.bash_profile.

That’s all folk! You may now proceed to the configuration section.

Emacs 23

Binaries for Emacs 23 are still available from Emacs for OSX.

Aquamacs

A near-OS-X-native port of GNU Emacs, integrating Emacs with all the features of Mac OS X. Available here. As of this writing, the latest version (2.4) is based on Emacs 23.3. Comes bundled with some handy packages like AUCTeX.