mac

CapsLock Mac Version

• CapsLock Enhancement (mac) is based on Project Karabiner-Elements

• Current release of karabiner works on following macOS:

  • macOS High Sierra (10.13)
  • macOS Sierra (10.12)
  • macOS EI Capitan (10.11)

• For older OS X user, refers to old karabiner XML-Format configuration script.

Install (mac)

1. Download Karabiner-Elements and Install
2. Copy URL to your browser to import configuration script.

# This Repo (open in safari)
karabiner://karabiner/assets/complex_modifications/import?url=https://raw.githubusercontent.com/Vonng/Capslock/master/mac/capslock.json

# Karabiner-Elements Offical Script Gallery
karabiner://karabiner/assets/complex_modifications/import?url=https%3A%2F%2Fpqrs.org%2Fosx%2Fkarabiner%2Fcomplex_modifications%2Fjson%2Fcaps_lock_enhancement.json

3. Open Karabiner, Tab "ComplexModification", Button "Add Item", and enable entries you like.
4. Default conf file path is $HOME/.config/karabiner/assets/complex_modifications. Modify it if you like.
5. Enable functions: [App] karabiner-elements -> [Tab] Complex Modification -> Add Item

Notice

• Asset directory: $HOME/.config/karabiner/assets/complex_modifications

• Main conf file path: $HOME/.config/karabiner/karabiner.json

• If you are using RMBP with Bar, consider changing your bar back to function keys with

  Karabiner -> Function Keys -> Use all F1, F2, etc. keys as standard function keys

Usage (mac)

Basic

✱ Hyper actually maps to ⌃⌥⇧⌘ (all right modifiers) , It works well with additional left modifiers. And compatible with most application. Hold CapsLock to enable Hyper funcationality while press it will emit an Escape.

Origin	Maps to	Comment
⇪ Press	⎋ Escape	Single press to escape
⇪ Hold	✱ Hyper	Enable Hyper Functionality

Navigation

• Hold ✱ Hyper to enable navigators
• Hold additional ⌘ Command for selection . (just like holding ⇧shift in normal)
• Hold additional ⌥ with HJKL for mouse movement
• Hold additional ⇧ with HJKL for switching tab/app
• Hold additional ⌃ with HJKL for desktop management . (just like holding ⌃ctrl with arrow key)

Origin	Maps to	Comment
H	← LeftArrow	cursor left
J	↓ DownArrow	cursor down
K	↑ UpArrow	cursor up
L	→ RightArrow	cursor right
U	⇞ PageUp	cursor page up
I	↖ Home	cursor to line(doc) head
O	↘ End	cursor to line(doc) end
P	⇟ PageDn	cursor page down
⌘H	⇧← LeftArrow	cursor left and selection
⌘J	⇧↓ DownArrow	cursor down and selection
⌘K	⇧↑ UpArrow	cursor up and selection
⌘L	⇧→ RightArrow	cursor right and selection
⌥H	← LeftArrow	mouse left
⌥J	↓ DownArrow	mouse down
⌥K	↑ UpArrow	mouse up
⌥L	→ RightArrow	mouse right
⌃H	← LeftArrow	expose all
⌃J	↓ DownArrow	show desktops
⌃K	↑ UpArrow	switch prev desktop
⌃L	→ RightArrow	switch next desktop

Mousekey

• Emulate mouse with keyboard
• Also can be archived by ⌥ with HJKL

Origin	Maps to	Comment
←	MouseLeft	mouse cursor left
↓	MouseDown	mouse cursor down
↑	MouseUp	mouse cursor up
→	MouseRight	mouse cursor right
↩	MouseLeft	mouse left button click
⌘↩	MouseRight	mouse right button click

Deletion

Origin	Maps to	Comment
N	⌥⌫ Option + ForwardDelete	Delete a word ahead
M	⌫ ForwardDelete	Delete a char ahead
,	⌦ Delete	Delete a char after
.	⌥⌦ Option + Delete	Delete a word after
⌘M,⌘N	⌘⌥⌫ Command+Option+ForwardDelete	Delete to line head

Window Control

Origin	Maps to	Comment
⇥ Tab	⌘⇥ Command+Tab	Switch Window
⌘⇥ Command+Tab	⌘⇧⇥ Command+Shift+Tab	Switch Window Reversely
Q	⌘Q	Close Window
W	⌘W	Close Tab
A	⌃⌥⇧⌘A	Leaves to Moom, ※a window resize app
⌘A	⌃↑ Ctrl+UpArrow	OSX Expose All
S	⌃⇥ Ctrl+Tab	Switch Tab
⌘S	⌃⇧⇥ Ctrl+Shift+Tab	Swtich Tab Reversely
⌘D	F11	Show Desktop

Bash Control

• Common bash utils: EOF, SIGINT, SIGTSTP, VIM/Tmux Prefix

Origin	Maps to	Comment
Z	⌃Z Ctrl+Z	SIGTSTP
X	⌃R Ctrl+R	IDE Run
C	⌃CCtrl+Z	SIGINT
V	⌃VCtrl+V	Vim Prefix
B	⌃BCtrl+B	Tmux Default Prefix
D	⌃D Ctrl+D	EOF

Applications

• Maybe you'd like overwrite these with your own favorite apps.

Origin	Maps to	Comment
E	Open Safari	Open Web Browser
⌘E	Open Finder	Open File Browser
R	Open iTerm2	Great terminal for osx (Run)
⌘R	Open Preview	Switch to opened picture, pdf, etc...
T	Open Visual Studio Code	Text Editor: Visual Studio Code
⌘T	Open Typora	Text Editor: Typora , a great WYSIWYG md editor
⌘D	Open Dictionary	Find words
⌘F	Open Dash	Find API Document
F	Open Alfred	Leaves to ⌃⌥⇧⌘F
⌘D	Open Dictionary	Find words
G	Open Intellij IDEA	Open IDE
⌘G	Open Chrome	Google Chrome

Functional

• Use F1,…F12 as standard functional keys, while hold hyper to turn them back.

• If you are using RMBP with Bar, consider changing your bar back to function keys with

  Karabiner -> Function Keys -> Use all F1, F2, etc. keys as standard function keys

Origin	Maps to	Comment
F1	BrightnessDown
F2	BrightnessUp
F3	ExposeAll
F4	LaunchPad
F5	KeyboardLightDown
F6	KeyboardLightUp
F7	MusicPrev
F8	MusicPlay
F9	MusicNext
F10	Mute
F11	VolumeDown
F12	VolumeUp
F13 PrintScreen	MusicPrev
F14 ScrollLock	MusicNext
F15 Pause	MusicPlay	Just as it shows
Insert	⌥BrightnessUp	Fine grained brightness up
Delete	⌥BrightnessDown	Fine grained brightness down
Home	⌥KeyboardLightUp	Fine grained keyboard light up
End	⌥KeyboardLightDown	Fine grained keyboard light down
PgUp	⌥VolumeUp	Fine grained volume up
PgDn	⌥VolumeDown	Fine grained volume down

Shifter

• A more convient shift for most case
• Semicolon; and Quote ' have some special treatment, makes input != and := easier

Origin	Maps to	Comment
1	!	Exclamation
2	@	At
3	#	Sharp
4	$	Dollar
5	%	Percent
6	^	Caret
7	&	Ampersand
8	*	Star
9	(	Left Round Bracket
0	)	Right Round Bracket
- Minus	_	Hyphen
= Equal	+	Plus
[ Left Bracket	(	Left Round Bracket ⇧9
] Right Bracket	)	Right Round Bracket ⇧0
; Semicolon	!	Exclamation
' Single Quote	=	EqualSign
⌘; Semicolon	!	Colon
⌘' Single Quote	=	EqualSign

Misc

Origin	Maps to	Comment
⎋ Escape	⇪ CapsLock	Bug: Difficult to turn capslock off after emit
~ BackQuote	⌃⇧⌘4	macOS Area Screenshot to Clipboard
⌘~ Command+BackQuote	⌃⇧4	macOS Area Screenshot to Desktop File
⌫ Backspace	⌘⌫	macOS Delete File
/ Slash	⌘/ Command+Slash	Comment/Uncomment in many IDE
\ Backslash	⌘/ Command+Slash	Comment/Uncomment in many IDE
␢ Spacebar	⌃␢ Ctrl+Spacebar	Switch Input Source