Skip to content

Mac V1

Capslock Mac V1, the 2015–2017 private.xml that used Seil and the original Karabiner to turn Caps Lock into Hyper on OS X 10.10 and 10.11.
Archived, not maintained

Mac V1 ran on the original Karabiner together with Seil, on OS X 10.10 Yosemite and 10.11 El Capitan. The original Karabiner does not run on macOS 10.12 Sierra or later, so V1 cannot run on any current Mac. It was replaced by Mac V2, and the maintained edition today is Mac V3.

Mac V1 was the first Capslock edition for the Mac. It needed two tools. Seil changed the key code that Caps Lock sends to 80, the code of F19. Karabiner then read V1's private.xml, which turned that key into Hyper (✱) while held and defined each group of shortcuts as a separate item to switch on in Karabiner's preferences.

The Mac V1 layout drawn on a full keyboard; key labels in English, colour legend in Chinese
The layout diagram from the V1 README. Its colour legend is in Chinese, and some app keys in it differ from the lists on this page.

Caps Lock

KeyResult
Hold Caps LockHyper (✱)
Tap Caps LockEscape, or ⌃Space to switch input source. These are two separate items that conflict, so turn on only one
✱ EscapeCaps Lock
✱ SpaceEscape

Hold Hyper to move the cursor; add the left ⌘ to select as you move.

Key✱ move✱ ⌘ select
H←⇧←
J↓⇧↓
K↑⇧↑
L→⇧→
UPage Up⇧Page Up
IHome⇧Home
OEnd⇧End
PPage Down⇧Page Down

Deleting

KeySendsDeletes
✱ N⌥⌫The word before the cursor
✱ M⌫The character before the cursor
✱ ,⌦The character after the cursor
✱ .⌥⌦The word after the cursor

Windows and tabs

KeySendsResult
✱ A⌃⌥⇧⌘ALeft free for the window manager Moom
✱ ⌘ AF11Show the desktop
✱ Q⌘QQuit the app
✱ Tab⌘TabNext app
✱ ⌘ Tab⇧⌘TabPrevious app
✱ S⌃TabNext tab
✱ ⌘ S⌃⇧TabPrevious tab
✱ W⌘WClose the tab

Terminal keys

KeySendsUsed for
✱ Z⌃ZSuspend the job (SIGTSTP)
✱ X⌃BThe default tmux prefix
✱ C⌃CInterrupt (SIGINT)
✱ D⌃DEnd of input (EOF)

Apps

The README suggested replacing these with your own favourite apps.

Key✱✱ ⌘
EGoogle Chrome, or Safari through a separate itemFinder
RiTerm⌃R, Run in IDEs
TTyporaMWeb
FDashDictionary
GIntelliJ IDEA—
VVisual Studio Code—

Function keys

Key✱Key✱
F1Brightness downF7Previous track
F2Brightness upF8Play or pause
F3Mission ControlF9Next track
F4LaunchpadF10Mute
F5Keyboard backlight downF11Volume down
F6Keyboard backlight upF12Volume up

Keys found on full-size keyboards:

Key✱
Insert, DeleteBrightness up, down, in fine steps
Home, EndKeyboard backlight in fine steps
Page Up, Page DownVolume up, down, in fine steps
Scroll LockMute
PausePlay

Shifted symbols

Key✱ types
1 2 3 4 5 6 7 8 9 0! @ # $ % ^ & * ( )
- =_ +
[ ]( )
;_
'=

Mouse

KeyResult
✱ ← ↓ ↑ →Move the pointer
✱ ReturnLeft click
✱ \Right click

Other keys

KeySendsResult
✱ /⌘/Comment or uncomment, in many editors
✱ `⌃⇧⌘4Screenshot of an area, to the clipboard
✱ ⌘ `⇧⌘4Screenshot of an area, to a file

How it was installed

These are the steps from the V1 README, kept for the record.

  1. Download and install Seil.
  2. Download and install Karabiner.
  3. In Seil, turn on Change the caps lock key and set its key code to 80.
  4. In Karabiner, open the Misc & Uninstall tab and click Open private.xml. Replace that file with V1's private.xml. The setup script in the mac_v1 folder copies it to ~/Library/Application Support/Karabiner/private.xml for you.
  5. Return to the Change Key tab, click Reload XML, and enable the items you want.
Seil's Setting tab with Change the caps lock key turned on and key code 80 entered
Step 3: Caps Lock set to key code 80 in Seil.
Karabiner's Misc & Uninstall tab, with an arrow pointing at the Open private.xml button and the file shown in Finder
Step 4: Open private.xml in Karabiner reveals the file to replace.

Files

All of V1 is in mac_v1/ in the repository.

FileWhat it is
private.xmlThe V1 configuration for the original Karabiner
setupA shell script that copies private.xml into Karabiner's folder
README.mdThe original V1 documentation

Differences from V3

  • Tools. V1 needed Seil and the original Karabiner, configured in XML. Karabiner-Elements replaced the original Karabiner for macOS Sierra and later; V2 and V3 are JSON rules for it and do not need Seil.
  • Tapping Caps Lock. V1 let you choose between Escape and switching input source. V3 sends Escape on a tap.