This repository has been archived on 2024-10-22. You can view files and clone it, but cannot push or open issues or pull requests.
spacemacs/contrib/osx
2015-06-14 22:32:20 -04:00
..
img Move layer images into img directories 2014-12-24 01:03:49 -05:00
config.el osx: allow skipping option to meta key mapping 2015-06-14 22:20:21 -04:00
keybindings.el Correct s-v keybinding with yank 2015-06-14 22:32:20 -04:00
packages.el Refine system and feature detection 2015-06-08 00:13:16 -04:00
README.org osx: allow skipping option to meta key mapping 2015-06-14 22:20:21 -04:00

OSX contribution layer for Spacemacs

/TakeV/spacemacs/media/commit/829e4eb7ee5d9cf9abcac4c139467e981889d713/contrib/osx/img/apple.png

Description

Spacemacs is not just emacs+vim. It can have OSX keybindings too! This layer globally defines common OSX keybindings. is set to super and is set to meta. Aside from that, there's nothing much, really.

While in dired this layer will try to use gls instead of ls.

Philosophy

While this layer enables common OSX bindings, it does not implement OSX navigation keybindings. Spacemacs is meant to be used with evil, and we encourage you to do so :)

Install

Layer

To use this configuration layer, add it to your ~/.spacemacs

  (setq-default dotspacemacs-configuration-layers '(osx))

Use with non-US keyboard layouts

If you need the key to type common characters such as `{[]}~` which is usual for e.g. Finnish and Swedish keyboard layouts, you'll probably want to leave the key unchanged by setting the osx-use-option-as-meta variable to nil:

  (setq-default dotspacemacs-configuration-layers '(
     (osx :variables osx-use-option-as-meta nil)))

Coreutils

To get gls install coreutils homebrew:

  brew install coreutils

Key Bindings

Key Binding Description
⌘ + Scale up text
⌘ - Scale down text
⌘ q Quit
⌘ v Paste
⌘ c Copy
⌘ x Cut
⌘ a Select all
⌘ w Close window
⌘ W Close frame
⌘ n New frame
⌘ z Undo
⌘ Z Redo
⌃ ⌘ f Toggle fullscreen

Future Work

  • Allow user to choose from either hyper or super as . This is an option that is supported cross-platform.
  • Configurable option to keep the OSX and spacemacs clipboards separate