Customize on Capslock

Keyboard editor

Mon, 01 Jan 0001 00:00:00 +0000

The Keyboard page is the editor. It draws your keyboard for the selected plane with each mapped action on its key. Keys your keyboard lacks, such as F16 or a numeric keypad on a laptop, appear under Keys not on this keyboard, and tap and double-tap mappings appear under Other triggers. Switch to List in the toolbar for a list grouped by trigger type.

Click a key. A popover shows its chord, the plane, and the current Action:

App rules

Mon, 01 Jan 0001 00:00:00 +0000

An app rule makes a key do something different while a particular app is in front, without changing what it does everywhere else.

How rules are matched

Each mapping has a Default action and, optionally, a list of App rules. When you press the chord, Capslock checks the rules from top to bottom against the app in front. The first rule that names that app wins. If none does, the default action runs.

Actions

Mon, 01 Jan 0001 00:00:00 +0000

A mapping runs an action. Actions are either built in or yours. The Actions page lists both; built-ins cannot be edited, but any of them can be mapped.

Built-in actions

Action	ID
Left, Right, Up, Down	`builtin.move_left`, `builtin.move_right`, `builtin.move_up`, `builtin.move_down`
Word Forward, Word Back	`builtin.word_forward`, `builtin.word_back`
Home, End	`builtin.line_start`, `builtin.line_end`
Up 10 Lines, Down 10 Lines	`builtin.jump_up_10`, `builtin.jump_down_10`
Backspace	`builtin.backspace`
Next Line	`builtin.new_line`
Insert Quotes	`builtin.insert_quotes`
Escape	`builtin.escape`
Toggle Caps Lock	`builtin.toggle_caps_lock`
Do Nothing	`builtin.noop`
Normal Key	`builtin.passthrough`

The IDs are permanent: a mapping that refers to one keeps working across versions.

Hyper mode and profile behaviour

Mon, 01 Jan 0001 00:00:00 +0000

Hyper mode

Settings › Hyper › Hyper mode has two choices. You also pick one during onboarding.

	Classic (default)	Native
What other apps see while Caps Lock is held	Right ⌘, ⌥, ⌃ and ⇧ held down	Nothing
Hyper shortcuts in Alfred, Raycast, Moom and similar apps	Work	Do not see Hyper
Modifiers that choose a plane	Left side only	Either side, unless you choose Left only
A mapped chord's output	Clean: ⇪ H sends a plain ←	Clean

Pick Classic if you have shortcuts in other apps that rely on Hyper (⌃⌥⇧⌘), or if you are coming from the Karabiner-Elements configuration. Pick Native if nothing else listens for Hyper and you want either side's modifiers to choose a plane.

Settings, menu bar and statistics

Mon, 01 Jan 0001 00:00:00 +0000

Settings

Settings are stored in app_config.yml; see Configuration file.

Section	Setting	Default
General	Open at login	Off
	Show window at launch	On; when off, Capslock starts quietly in the menu bar
	Hide Dock icon	Off
	Language	Follow System (English or Simplified Chinese)
	Appearance	System, Light or Dark
Hyper	Hyper mode	Classic
	Double-tap speed	200 ms
	Hold to reveal	On, 550 ms delay, hides when an action runs
	Show actions on screen	Off, 1.35 s
Profile behavior	Unmapped Caps chords	Send the normal key
	Modifier sides	Automatic
Input sources	Fix for CJK input sources	None
Advanced	Key remaps	None
	Show counts on mappings	On

The Status, Permissions and Recovery sections repeat the controls from Home and Diagnostics: Pause and Resume, the permission rows, Release All, Restore Caps Lock, and Show Config Folder.

Customize on Capslock

Keyboard editor

Change one key

App rules

How rules are matched

Actions

Built-in actions

Hyper mode and profile behaviour

Hyper mode

Settings, menu bar and statistics

Settings