Skip to content
Use all of Emacs modifiers on macOS with various keyboards.
Emacs Lisp
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.gitignore Ignore backups Aug 31, 2019
DurgodTaurusK320TKL.json v0.2.0 Oct 17, 2019
DurgodTaurusK320TKL.png v0.2.0 Oct 17, 2019
DurgodTaurusK320TKL.xml
LICENSE Initial commit Apr 26, 2019
README.org Format Oct 17, 2019
allmodifiers.png v0.2.0 Oct 17, 2019
karabiner.json v0.2.0 Oct 17, 2019
macbook-pro-late-2013.json v0.2.0 Oct 17, 2019
macbook-pro-late-2013.png v0.2.0 Oct 17, 2019
maccadet.el v0.2.0 Oct 17, 2019

README.org

About

Use all of Emacs’s modifiers on macOS with various keyboards.

Purpose

When non-Emacs users observe Emacs users laboring over their key binding configuration their typical range of reactions include finding it to be interesting, surprising, remarkable, strange, weird, incredible, striking, bizarre, deviant, eccentric, freakish, monstrous, incomprehensible, inconceivable, incredible, unimaginable, and unthinkable. With that range reactions in mind it is self-evident that if you are reading this then you already know why you want to use more of the Emacs’s modifier keys you just want to know how. The purpose of this project is to capture one way of using all of Emacs’s modifier keys.

Goal

  • Usable on stock Mac keyboards and Windows (ANSI) keyboard.
  • Mirrored meta keys
  • Minimize invasive changes to
    • the physical keyboard layout
    • the Emacs bindings for which you already have strong muscle memory.
    • the built-in macOS’s keybindings

Requirements And Compatibility

It was tested against:

Use

Download the software for your hardware and use the configuration in this repository.

Mac uses macbook-pro-late-2013.json for Karabiner

Durgod uses DurgodTaurusK320TKL.xml for their Zeus Engine.

Load the maccadet.el file in your init file.

Legend

The pink keys were remapped from their hardware configuration. Their defintion is contained on the cap itself. They are in the form of:

  • Physical key name.
  • The key it is getting mapped to (either a USB spec modifier name or a shortened ANSI name).
  • The Emacs modifier for it.

On the ANSI keyboard they go from top to bottom. mac keyboard they go from bottom to top.

The orange keys are not remapped but they’ve got a modifier configured for them in Emacs.

Here are the characters for specifying the modifier in your key bindings (these are the last character listed on the keycap here):

  • C : Control
  • M : Meta
  • s : Super
  • H : Hyper
  • A : Alt

The setups follow.

Notable about each keyboard is that you can press the keys “Control-Meta-Super-Hyper-Alt-Shift” with one hand. For example

(defun test () (interactive) (message "Yup, it worked."))
(global-set-key (kbd "C-M-s-H-A-F") #'test)

allmodifiers.png

Durgod Taurus K320 TKL

/DurgodTaurusK320TKL.png

MacBook Pro Late 2013

/macbook-pro-late-2013.png

You can’t perform that action at this time.