Emacs Plus formulae for the Homebrew package manager
Switch branches/tags
Nothing to show
Clone or download


Emacs Plus

Emacs Plus is GNU Emacs formulae based on emacs formulae. The difference is that some of the options available from emacs formulae are enabled by default in emacs-plus and some new additional options are available for user.

Upgrade from Emacs 25.x

With release of Emacs 26.1 many options were removed from the formula, as features behind them are already in released version.

But most of the users might suffer due to removal of --natural-title-bar option. In order to duplicate its behaviour add following lines to your init.el file.

(add-to-list 'default-frame-alist
             '(ns-transparent-titlebar . t))

(add-to-list 'default-frame-alist
             '(ns-appearance . light)) ;; or dark - depending on your theme

In case for some reason you still want to use old Emacs 25 formula, it is available as emacs-plus@25.

$ brew install emacs-plus@25 [all-your-favourite-options]


$ brew tap d12frosted/emacs-plus
$ brew install emacs-plus [options]

By default (without any addition options) this formula install Cocoa version of Emacs with support of gnutls, imagemagick, librsvg, libxml2, dynamic modules and multicolor fonts and Spacemacs icon. Please see the list of available options to disable any bit of default behaviour or add even more stuff.

In order to install without Spacemacs icon you should use following command.

$ brew install emacs-plus --without-spacemacs-icon


To get list of all available options, call brew info emacs-plus. Here is relevant part from output of that command for your convenience.

==> Options
  Don't remove the ctags executable that Emacs provides
  Build with dbus support
  Using Emacs icon project EmacsIcon1
  Using Emacs icon project EmacsIcon2
  Using Emacs icon project EmacsIcon3
  Using Emacs icon project EmacsIcon4
  Using Emacs icon project EmacsIcon5
  Using Emacs icon project EmacsIcon6
  Using Emacs icon project EmacsIcon7
  Using Emacs icon project EmacsIcon8
  Using Emacs icon project EmacsIcon9
  Using Emacs icon project emacs-card-blue-deep
  Using Emacs icon project emacs-card-british-racing-green
  Using Emacs icon project emacs-card-carmine
  Using Emacs icon project emacs-card-green
  Build with mailutils support
  Using a modern style Emacs icon by @tpanum
  Experimental: build without titlebar
  Experimental: build from pdumper branch and with increased remembered_data size (--HEAD only)
  Experimental: build with x11 support
  Build with xwidgets
  Build a non-Cocoa version of Emacs
  Build without gnutls support
  Build without imagemagick@6 support
  Build without librsvg support
  Build without libxml2 support
  Build without little-cms2 support
  Build without dynamic modules support
  Build without a patch that enables multicolor font support
  Build without Spacemacs icon by Nasser Alshammari
  Install development version 26.1-rc1
  Install HEAD version

Note that by default emacs-plus builds the Cocoa version of Emacs with gnutls, imagemagick, librsvg and dynamic modules support by default. Also it changes default GNU Emacs icon to Spacemacs icon. If you wish to change defaults, just use --without-FEATURE flag.

Note that --HEAD builds are not really supported. They may fail to install, they may crash at run time. Or even worse, they may work as expected. So use this option at your own risk. And feel free to open up issues you face, just remember that I am not close enough to Emacs development process to provide you much help with any arising issues.

Portable dumper

The portable dumper is a feature that may be available with Emacs 27.1, but for now the code is in the dumper branch of the Emacs Git repository.

In order to use that branch, please use --with-pdumper --HEAD options.

Please, take a look at it’s usage in Spacemacs.

Xwidgets (webkit)

The original Emacs xwidgets builds and works on macOS however must be used with x11 and hence not practical option on macOS. This version enables xwidgets on native macOS X Cocoa via embedding a native webkit window.

More details can be seen here Veshboo’s emacs branch.

Emacs configuration

Emacs is a journey. And for some of you these projects might be inspiring.

Known Issues

Please checkout Issues page for a list of all known issues. But here are several you should be aware of.

emacs dependency in other formulas

In some cases (like when installing cask) regular emacs package will be required. In such cases you might want to install all dependencies manually (except for emacs) and then install desired package with --ignore-dependencies option.

$ brew install cask --ignore-dependencies


by @j-martin


Many thanks to all contributors, everyone reporting issues and Sudarshan Wadkar for providing bottles for El Capitan.