Skip to content
master
Switch branches/tags
Code

Latest commit

 

Git stats

Files

Permalink
Failed to load latest commit information.
Type
Name
Latest commit message
Commit time
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Banner

Emacs Head

GNU General Public License Version 3.0

Emacs 26 CI Status Badge Emacs 27 CI Status Badge Emacs 28 CI Status Badge

Emacs Head is an Homebrew Formula based on the original Homebrew Emacs one.

This formula currently supports:

  • GNU Emacs 26.3
  • GNU Emacs 27.2 (or HEAD)
  • GNU Emacs HEAD (currently 28.0.50)

Installation

You can install this formula using:

GNU Emacs 26

brew tap daviderestivo/emacs-head
brew install emacs-head@26 --with-cocoa

GNU Emacs 27

brew tap daviderestivo/emacs-head
brew install emacs-head --with-cocoa

If you wish to install the HEAD version of GNU Emacs 27 please do:

brew tap daviderestivo/emacs-head
brew install --HEAD emacs-head --with-cocoa

GNU Emacs 28 (HEAD)

brew tap daviderestivo/emacs-head
brew install emacs-head@28 --with-cocoa

Screenshots

GNU Emacs running in terminal mode (28.x)

/images/emacs-head-terminal.png

GNU Emacs running in GUI mode (28.x)

GUI Theme: atom-one-dark-theme

Modeline Theme: smart-mode-line-atom-one-dark-theme

/images/emacs-head-cocoa.png

Compilation options

The following compilation options are available:

OptionDescription
--with-crash-debugAppend `-g3` to CFLAGS to enable crash debugging
--with-cocoaBuild a Cocoa version of GNU Emacs
--with-ctagsDon’t remove the ctags executable that GNU Emacs provides
--with-dbusBuild with dbus support
--without-gnutlsDisable gnutls support
--with-imagemagickBuild with imagemagick support
--without-librsvgDisable librsvg support
--with-mailutilsBuild with mailutils support
--with-multicolor-fontsEnable multicolor fonts support on macOS (only on emacs-head@26)
--without-modulesDisable dynamic modules support
--with-no-frame-refocusDisables frame re-focus (ie. closing one frame does not refocus another one)
--without-libxml2Disable libxml2 support
--with-pdumperEnable pdumper support (only on emacs-head and emacs-head@28)
--with-xwidgetsEnable xwidgets support (only on emacs-head and emacs-head@28)
--with-native-compEnable Elisp native compilation support (only on emacs-head@28)
--with-native-full-aotEnable Elisp Ahead-of-Time native compilation support (only on emacs-head@28)

For the terminal version only of GNU Emacs please omit --with-cocoa.

By default:

  • gnutls
  • librsvg
  • libxml2
  • dynamic modules

are enabled. If you want to disable them please use the above --without-* options.

System appearance change support

This patch is enabled by default and can’t be disabled. It adds a hook, ns-system-appearance-change-functions, that is called once the system appearance is changed. Functions added to this hook will be called with one argument, a symbol that is either light or dark. This mainly allows loading a different theme to better match the system appearance.

(defun my/apply-theme (appearance)
  "Load theme, taking current system APPEARANCE into consideration."
  (mapc #'disable-theme custom-enabled-themes)
  (pcase appearance
    ('light (load-theme 'tango t))
    ('dark (load-theme 'tango-dark t))))

(add-hook 'ns-system-appearance-change-functions #'my/apply-theme)

Note that this hook is also run once when Emacs is initialized, so simply adding the above to your init.el will allow matching the system appearance upon startup. You can also determine what the current system appearance is by inspecting the value of the ns-system-appearance variable.

The hook is NOT run in TTY Emacs sessions.

Pdumper support

Portable dumper is supported by emacs-head and emacs-head@28. To enable this feature please use --with-pdumper.

For a pdumper configuration example, you could take inspiration from Galactic Emacs: pdumper-init.el and pdumper-config.el configuration files.

Xwidgets support

This formula support native macOS X Cocoa Xwidgets via embedding a native webkit window. To enable this feature please use --with-xwidgets (only on emacs-head and emacs-head@28).

Native-comp support

This formula support native Elisp code compilation. In order to enable it please follow the below instructions:

brew install emacs-head@28 --with-cocoa --with-native-comp

NATIVE_FULL_AOT is disabled by default to improve build time. Only few lisp source files will be compiled during the build, all of the remaining ones will be dynamically compiled in the background once the Emacs application is launched for the first time. If you wish to enable native full AoT, please use --with-native-full-aot option together with --with-native-comp.

More details about native Elisp code compilation can be found in the below links:

Additional useful links:

Available icons

OptionDescriptionImageURL
--with-modern-icon-sjrmanningUse a modern style icon by Sjrmannings/icons/modern-icon-sjrmanning.pngLink
--with-modern-icon-asingh4242Use a modern style icon by Asingh4242/icons/modern-icon-asingh4242.pngLink
--with-modern-icon-paper-iconsUse a modern style icon by Sam Hewitt/icons/modern-icon-paper-icons.pngLink
--with-modern-icon-azhilinUse a modern style icon by Andrew Zhilin/icons/modern-icon-azhilin.pngLink
--with-modern-icon-mzaplotnikUse a modern style icon by Matjaz Zaplotnik/icons/modern-icon-mzaplotnik.pngLink
--with-modern-icon-bananxanUse a modern style icon by BananXan/icons/modern-icon-bananxan.pngLink
--with-modern-icon-vscodeUse a modern style icon by Valentin Degenne/icons/modern-icon-vscode.pngLink
--with-modern-icon-sexy-v1Use a modern style icon by Emacs is Sexy/icons/modern-icon-sexy-v1.pngLink
--with-modern-icon-sexy-v2Use a modern style icon by Emacs is Sexy/icons/modern-icon-sexy-v2.pngLink
--with-modern-icon-cg433nUse a modern style icon by Cg433n/icons/modern-icon-cg433n.pngLink
--with-modern-icon-purpleUse a modern style icon by Nicolas Petton/icons/modern-icon-purple.pngLink
--with-modern-icon-yellowUse a modern style icon by Unknown/icons/modern-icon-yellow.pngLink
--with-modern-icon-orangeUse a modern style icon by Omar Jair Purata Funes/icons/modern-icon-orange.pngLink
--with-modern-icon-papirusUse a modern style icon by Papirus Development Team/icons/modern-icon-papirus.pngLink
--with-modern-icon-penUse a modern style icon by Kentaro Ohkouchi/icons/modern-icon-pen.pngLink
--with-modern-icon-pen-3dUse a modern style icon by Unknown/icons/modern-icon-pen-3d.pngLink
--with-modern-icon-pen-lds56Use a modern style icon by lds56/icons/modern-icon-pen-lds56.pngLink
--with-modern-icon-pen-blackUse a modern style icon by Cayetano Santos/icons/modern-icon-pen-black.pngLink
--with-modern-icon-black-variantUse a modern style icon by BlackVariant (Patrick)/icons/modern-icon-black-variant.pngLink
--with-modern-icon-purple-flatUse a modern style icon by Jeremiah Foster/icons/modern-icon-purple-flat.pngLink
--with-modern-icon-spacemacsUse a modern style icon by Nasser Alshammari/icons/modern-icon-spacemacs.pngLink
--with-modern-icon-alecive-flatwokenUse a modern style icon by Alessandro Roncone/icons/modern-icon-alecive-flatwoken.pngLink
--with-modern-icon-elrumo1Use a modern style icon by Elias Ruiz Monserrat/icons/modern-icon-elrumo1.pngLink
--with-modern-icon-elrumo2Use a modern style icon by Elias Ruiz Monserrat/icons/modern-icon-elrumo2.pngLink
--with-modern-icon-bokehlicia-captivaUse a modern style icon by Bokehlicia/icons/modern-icon-bokehlicia-captiva.pngLink
--with-modern-icon-nuvolaUse a modern style icon by David Vignoni/icons/modern-icon-nuvola.pngLink
--with-modern-icon-black-gnu-headUse a modern style icon by Aha-Soft/icons/modern-icon-black-gnu-head.pngLink
--with-modern-icon-black-dragonUse a modern style icon by XYang and kongds/icons/modern-icon-black-dragon.pngLink
--with-modern-icon-emacs-icon1Use a modern style icon by Jasonm23/icons/modern-icon-EmacsIcon1.pngLink
--with-modern-icon-emacs-icon2Use a modern style icon by Jasonm23/icons/modern-icon-EmacsIcon2.pngLink
--with-modern-icon-emacs-icon3Use a modern style icon by Jasonm23/icons/modern-icon-EmacsIcon3.pngLink
--with-modern-icon-emacs-icon4Use a modern style icon by Jasonm23/icons/modern-icon-EmacsIcon4.pngLink
--with-modern-icon-emacs-icon5Use a modern style icon by Jasonm23/icons/modern-icon-EmacsIcon5.pngLink
--with-modern-icon-emacs-icon6Use a modern style icon by Jasonm23/icons/modern-icon-EmacsIcon6.pngLink
--with-modern-icon-emacs-icon7Use a modern style icon by Jasonm23/icons/modern-icon-EmacsIcon7.pngLink
--with-modern-icon-emacs-icon8Use a modern style icon by Jasonm23/icons/modern-icon-EmacsIcon8.pngLink
--with-modern-icon-emacs-icon9Use a modern style icon by Jasonm23/icons/modern-icon-EmacsIcon9.pngLink
--with-modern-icon-emacs-card-blue-deepUse a modern style icon by Jasonm23/icons/modern-icon-emacs-card-blue-deep.pngLink
--with-modern-icon-emacs-card-british-racing-greenUse a modern style icon by Jasonm23/icons/modern-icon-emacs-card-british-racing-green.pngLink
--with-modern-icon-emacs-card-carmineUse a modern style icon by Jasonm23/icons/modern-icon-emacs-card-carmine.pngLink
--with-modern-icon-emacs-card-greenUse a modern style icon by Jasonm23/icons/modern-icon-emacs-card-green.pngLink
--with-modern-icon-doomUse a modern style icon by Eccentric J/icons/modern-icon-doom.pngLink
--with-modern-icon-doom3Use a modern style icon by Eccentric J/icons/modern-icon-doom3.pngLink
--with-modern-icon-doom-cacodemonUse a modern style icon by Christian Westrom/icons/modern-icon-doom-cacodemon.pngLink
--with-retro-icon-emacs-logoUse a retro style icon by Luis Fernandes/icons/retro-icon-emacs-logo.pngLink
--with-retro-icon-gnu-headUse a retro style icon by Aurélio A. Heckert/icons/retro-icon-gnu-head.pngLink
--with-retro-icon-gnu-meditate-levitateUse a retro style icon by Nevrax Design Team/icons/retro-icon-gnu-meditate-levitate.pngLink
--with-retro-icon-sink-bwUse a retro style icon by Unknown/icons/retro-icon-sink-bw.pngLink
--with-retro-icon-sinkUse a retro style icon by Erik Mugele/icons/retro-icon-sink.pngLink

Why yet another Homebrew GNU Emacs formula?

Since the option --with-cocoa is not available anymore in the latest GNU Emacs homebrew-core formula (see pull request), I decided to build my own formula.

About the logo

‘Kitchen Sink’ OS Announced

Coding has begun on a new operating system code named ‘Kitchen Sink’. The new OS will be based entirely on GNU Emacs. One programmer explained, “Since many hackers spend a vast amount of their time in Emacs, why not just make it the operating system?” When asked about the name, he responded, “Well, it has been often said that Emacs has everything except a kitchen sink. Now it will.” — James Baughn (http://humorix.org/10016)

Collaborating

If you are interested in collaborating please open a Pull Request.

About

GNU Emacs formula for the Homebrew package manager

Topics

Resources

License

Languages