Emacs Mac Port

What is this?

The official repository of Emacs Mac port: https://bitbucket.org/mituharu/emacs-mac/overview

This is "Mac port" addition to GNU Emacs. This provides a native GUI support for OS X 10.10 - macOS 13. Note that Emacs 23 and later already contain the official GUI support via the NS (Cocoa) port. So if it is good enough for you, then you don't need to try this.

This Homebrew tap provides a collection of useful Homebrew formulas and casks with popular patches, making it easier to install Emacs Mac port on your Mac machine. It also offers pre-built bundles if you prefer not to use Homebrew.

IMPORTANT Note From Developer

If you find a bug, then please try to reproduce it with some official builds such as X11 or NS (Cocoa). If it turns out to be specific to the Mac port, then please report it to [email protected]. Otherwise (i.e., it is also reproducible with official ones), report it using M-x report-emacs-bug USING THE OFFICIAL BUILD as such.

Features

Please see the full feature list here.

Installation options

Homebrew

If you prefer to install with Homebrew, please enable this tap by:

$ brew tap railwaycat/emacsmacport

Formula

This tap provides the following formulas:

• emacs-mac: install the latest version of Emacs mac port (currently based on Emacs 29).
• emacs-mac@28: install Emacs mac port based on Emacs 28.

Cask

This tap provides the following casks, based on Emacs 29:

• emacs-mac
• emacs-mac-spacemacs-icon

and the following casks, based on Emacs 28:

• emacs-mac-28
• emacs-mac-28-spacemacs-icon

All of these casks can be installed by brew install --cask command.

Pre-built Download

Pre-built bundles available on the release page:

https://github.com/railwaycat/homebrew-emacsmacport/releases

Bundles are the same as those from Homebrew Cask.

Support macOS versions:

• Intel Mac
  • Monterey (macOS12)
  • Big Sur (macOS11)
  • Ventura (macOS13)
• Apple Silicon Mac
  • Monterey (macOS12)
  • Ventura (macOS13)

For macOS versions not be listed above, please install from Homebrew formula (install without --cask).

Intel Mac bundles are built by GitHub Actions, the version support limitation is from the macOS versions they support currently.

Apple Silicon bundles are built on a M1 Mac with Tart. The version support limitation is because Apple only supports macOS virtualization since Monterey (macOS12).

Useful links

• Emacs mac port on MacPorts (not be maintained by the maintainer of this repo):

  • emacs-mac-app
  • emacs-mac-app-devel

• Switch meta and option key - https://gist.github.com/3498096

• For helper scripts/Apps to start Emacs.app, see this document.