Capslock

Capslock goes native

Fri, 06 Nov 2026 00:00:00 +0000

For years Capslock was a configuration file. You installed Karabiner-Elements, imported a set of rules, and Caps Lock became Escape on a tap and a Hyper key on a hold. With Command, Option, Control and Shift it reached sixteen planes of shortcuts for the cursor, editing, windows, apps and the mouse.

That worked, and it kept two costs. Karabiner-Elements had to be installed, with its driver and its permissions, just to change one key. And the layout was a JSON file: to change a binding you edited that file, and to learn the layout you kept a picture of the keyboard open.

Configuration file

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

You never have to edit these files: everything here can be changed in the app. They are plain YAML so that you can read them, keep them in version control, or move them to another Mac with Export and Import.

Where files are kept

- action_mappings.yml # mappings, actions, profile
- app_config.yml # settings
- backups/ # automatic snapshots
- Logs/
 - Capslock.log # diagnostic log
- ClipboardSlots/ # encrypted clipboard slots
- usage_stats.json # Statistics counts
- hidutil-transaction.json # recovery record

Settings › Recovery › Show Config Folder opens it in Finder. Your language choice is kept in the app's preferences, and the clipboard key in your Keychain.

Install and Hyper basics

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

Capslock Enhancement V3 current targets macOS and Karabiner-Elements. There is nothing else to install: the configuration is a set of complex-modification rules that Karabiner interprets, so nothing new runs in the background and nothing is compiled on your machine.

Note

This guide was verified with Karabiner-Elements 16.1.0 in August 2026, whose support matrix covers macOS 13 Ventura through macOS 27 on Intel and Apple silicon. Check the official site for the current release.

Install and first run

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

Release status

There is no public download yet; see Download. This page describes the signed release.

Requirements

macOS 14 Sonoma or later, on Apple silicon or Intel.
The Accessibility permission. Capslock never asks for Input Monitoring.
Caps Lock not already remapped by another tool. If you use Karabiner-Elements, read Coexisting with Karabiner-Elements first.

Install

Open Capslock.dmg and drag Capslock into Applications. Then open it from Applications or Spotlight.

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:

Mac V2

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

Archived, not maintained

Mac V2 was written for Karabiner-Elements on macOS 10.11 El Capitan, 10.12 Sierra and 10.13 High Sierra, the systems its README listed. It was replaced by Mac V3 in 2021 and has not been checked against current macOS or Karabiner-Elements.

Mac V2 was the first Capslock edition for Karabiner-Elements, the rewrite of Karabiner that macOS Sierra required. It is a set of ten complex-modification rules. A tap on Caps Lock sends Escape. Holding it turns it into Hyper (✱): Karabiner-Elements holds the four right-hand modifiers, ⌃ ⌥ ⇧ ⌘, together, so Hyper still combines with the left-hand ones and most apps accept it.

Navigation and selection

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

The eight keys under your right hand, H J K L and U I O P, carry most of the layout. On the base plane they move the cursor; other planes turn them into selection, tab and app switching, Spaces, the mouse, and scrolling. The mouse and scroll planes are on Mouse and scrolling.

Move and select

Key	`⇪` move	`⇪ ⌘` select	`⇪ ⌥ ⌘` extended selection
H	←	⇧←	⌥⇧←, select a word left
J	↓	⇧↓	⇧↓ three times
K	↑	⇧↑	⇧↑ three times
L	→	⇧→	⌥⇧→, select a word right
U	Page Up	⇧Page Up	⇧Page Up
I	Home	⇧Home	End, then ⇧Home twice: select to the start of the line
O	End	⇧End	Home, then ⇧End: select the whole line
P	Page Down	⇧Page Down	⇧Page Down

⇪ I and ⇪ O send the Home and End keys, not ⌘← and ⌘→. Some Mac text views scroll on Home and End instead of moving the cursor; where you want the start or end of the line, rebind them in the editor.

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.

Diagnostics and recovery

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

The Diagnostics page runs a set of checks and explains, in numbered steps, how to fix any that fail. Most fixes are a button on the same row. Refresh runs the checks again.

The checks

Check	Healthy	If it fails
Caps Lock mapping	Caps Lock is ready	Not set up, used by another tool, or unreadable. Try Again, or Restore Caps Lock.
F18	F18 is free	Another tool uses F18. Remove that remap, then Try Again.
Karabiner-Elements	Not detected, or no conflicts	A rule uses Caps Lock or F18; see Karabiner.
Crash recovery	Nothing to recover	The last session did not quit cleanly and was tidied up at launch, or another copy of Capslock is running.
Accessibility	Granted	Open Accessibility Settings, Check Again, or Reset & Ask Again.
Keystroke sending	Allowed	Comes with Accessibility. Request Access, Check Again, or Reset & Ask Again.
Keyboard reading	Reading the keyboard	macOS stopped the event tap. Try Again, or Release All.
Secure input	Off	A password field or Terminal's Secure Keyboard Entry hides keys from every app. Capslock never turns it off; close the field or the option.
Caps Lock press	Received	Press Caps Lock once, then Refresh.
Configuration	Valid	The file cannot be read. Show Config Folder and repair or replace it.
Signature	Valid	A development build.
Updates	Enabled	This build does not update itself; download new versions from the website.

Reset & Ask Again clears Capslock's Accessibility and keystroke-sending entries and asks again. Use it when System Settings shows Capslock as allowed but the check still fails, which can happen after replacing the app with a different build.

Learn the layout

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

Nobody memorizes 357 bindings up front. Capslock teaches the layout in three ways: it shows the current plane when you pause, it can show each action as it runs, and the Playground has short lessons that follow your own mappings.

Hold-to-Reveal

Hold Caps Lock without pressing another key. After a short delay the current plane appears on screen as a full keyboard with every action written on its key. Press ⌘, ⌥, ⌃ or ⇧ to switch planes while it is open; release Caps Lock to close it.

Mac V1

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

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.

Mouse and scrolling

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

Capslock can drive the pointer from three places: the letter keys under your right hand, the arrow keys, and the numeric keypad. Movement and scrolling run smoothly for as long as you hold the chord. Mouse buttons are held while you hold the chord, so holding a click chord and moving drags.

On the letter keys

Key	`⇪ ⌥` mouse	`⇪ ⌥ ⇧` fast mouse	`⇪ ⌃ ⇧` scroll	`⇪ ⇧ ⌘` fast scroll
H	Move left	Move left, fast	Scroll left	Scroll left, fast
J	Move down	Move down, fast	Scroll down	Scroll down, fast
K	Move up	Move up, fast	Scroll up	Scroll up, fast
L	Move right	Move right, fast	Scroll right	Scroll right, fast
U	Left click	Left click	Scroll right	Scroll right, fast
I	Right click	Right click	Scroll up	Scroll up, fast
O	Back button (4)	Back button (4)	Scroll down	Scroll down, fast
P	Forward button (5)	Forward button (5)	Scroll left	Scroll left, fast

On the two scroll planes, U I O P scroll in the opposite direction to H J K L. Fast movement is twice the normal speed; fast scrolling is twice the normal scroll.

Navigation, deletion, and mouse

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

The pink and brown areas around the home row carry the layout's most frequent operations. The navigation and deletion families together carry 114 of the 282 mappings in V3.1, so this is the part of the layout worth learning first.

Important

Unless stated otherwise, every chord on this page assumes ✱ Hyper is held. "+ ⌘" therefore means ✱ with ⌘ plus the listed key.

H J K L move left, down, up, and right, exactly as in Vim. Directly above them, U I O P extend the same idea to whole pages and lines: Page Up, Home, End, Page Down.

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.

Coexisting with Karabiner-Elements

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

Capslock needs Caps Lock and the F18 key to itself. It never edits, disables, or uninstalls Karabiner-Elements or any other tool. When something else already uses those keys, Capslock refuses to start and tells you what to change.

What counts as a conflict

A system key remap of Caps Lock. If another tool has remapped Caps Lock, Diagnostics shows "Caps Lock is used by another tool".
Another use of F18. If anything remaps a key to or from F18, Diagnostics shows "F18 is already in use".
A Karabiner-Elements rule. When Karabiner-Elements is running, Capslock reads the selected profile and looks for rules that start from Caps Lock or F18, or that produce F18. It reports only how many it found, never their names or contents.

Karabiner-Elements can keep running for everything else. Only rules on Caps Lock and F18 conflict.

Windows and developer workflows

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

The layout dedicates several colour-coded zones to the actions that interrupt a developer's flow most often: switching windows, launching tools, sending terminal signals, parking text somewhere, and typing punctuation.

Important

Every chord on this page assumes ✱ Hyper is held.

Window control

⇥ Q W A S form the azure block on the left of the keyboard. They close and cycle things, from a single tab up to the whole login session.

Editing, symbols and clipboard

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

Delete

N M , . sit below the navigation keys and delete in both directions.

Key	`⇪`	`⇪ ⌘`	`⇪ ⌥`
N	Delete the previous word (⌥⌫)	Delete to the start of the line (⇧⌘←, then ⌫)	Delete to the start of the line (⌘⌫)
M	Delete the previous character (⌫)	Delete the previous word (⌥⌫)	Move the line down (⌥⇧↓)
,	Delete the next character (⌦)	Delete the next word (⌥⌦)	Move the line up (⌥⇧↑)
.	Delete the next word (⌥⌦)	Delete to the end of the line (⇧⌘→, then ⌫)	Delete to the start of the line (⌘⌫)

⌥⇧↑ and ⌥⇧↓ move a line in editors that use those shortcuts, such as Visual Studio Code. Elsewhere they extend a selection.

Uninstall

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

Capslock has no installer and leaves nothing outside your user account except the Accessibility entry.

Quit Capslock from the menu-bar icon or with ⌘Q, so it can give Caps Lock back. If it was force-quit and Caps Lock still does not work as usual, run the restore command before you delete the app.
If you turned on Open at login, turn it off in Settings › General.
Move /Applications/Capslock.app to the Trash.
To remove your data as well, delete these:
- ~/Library/Application Support/com.vonng.capslock
- ~/Library/Preferences/com.vonng.capslock.plist
- ~/Library/Caches/com.vonng.capslock
In System Settings › Privacy & Security › Accessibility, select Capslock and click −.
If you used clipboard slots, delete the Keychain item named com.vonng.capslock.clipboard-slots in Keychain Access.

A Mac restart also clears the Caps Lock mapping, which macOS does not keep across restarts.

Windows

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

Archived, not maintained

The Windows version is an AutoHotkey script from 2013–2015. The Mac V2 README listed Windows XP, Vista, 7, 8 and 10 as its systems. Neither the script nor the prebuilt executable is tested on current Windows.

Capslock began on Windows in 2013, two years before the first Mac version. The script turns Caps Lock, which it calls the "useless key", into a function key like Ctrl and Alt by combining it with almost every other key on the keyboard. Caps Lock itself is kept off, and its old job moves to Caps Lock + `.

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.

Privacy

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

Capslock processes keyboard and pointer events on your Mac to apply the mappings you chose. It contains no behaviour analytics or advertising SDK. It sends no mapping, key, clipboard, Shell, app-history, or usage telemetry.

What is stored locally

Everything Capslock keeps lives in your user account, under ~/Library/Application Support/com.vonng.capslock/:

your configuration;
clipboard slots, encrypted with a random key that is kept in your Keychain;
a private diagnostic log, readable only by your user;
recovery records used to give the Caps Lock mapping back after a crash;
per-day action counters for the Statistics page.

A diagnostics export leaves out produced text, clipboard contents, Shell commands and output, secrets, raw key history, and full app history.

System functions and reference

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

This page collects the mappings and project details you look up rather than learn in sequence.

Function and system keys

F1–F12 behave as standard function keys by default; hold Hyper to send their media or system functions instead. The cyan block covers the whole top row plus the screenshot keys.

Karabiner-Elements 15.1 and later follow System Settings › Keyboard › Keyboard Shortcuts… › Function Keys
Key	Hyper action	+ `⌘`
`	Area screenshot to clipboard	Area screenshot to file
`F1` / `F2`	Brightness down / up	Desktop 1 / 2
`F3`	Mission Control	Desktop 3
`F4`	Spotlight	—
`F5` / `F6`	Keyboard light down / up	—
`F7` / `F8` / `F9`	Previous / play-pause / next	—
`F10` / `F11` / `F12`	Mute / volume down / volume up	—
`F13`	Full screenshot to clipboard	Full screenshot to file
`F14`	Screenshot menu	Legacy Touch Bar screenshot
`F15`	Play / pause	—

The screenshot keys follow one convention: the plain Hyper chord puts the capture on the clipboard, and adding ⌘ writes it to a file on the desktop.

Windows and apps

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

Window control

Tab, Q, W, A and S sit under the left hand, so you can switch and close while the right hand stays on the mouse or the navigation keys.

Key	`⇪`	`⇪ ⌘`	`⇪ ⌥`	`⇪ ⌃`	`⇪ ⇧`
Tab	Next app (⌘Tab)	Previous app (⇧⌘Tab)	Space to the right (⌃→)		Next tab (⌃Tab)
Q	Quit the app (⌘Q)	Quit the app (⌘Q)		Lock the screen (⌃⌘Q)	Log out (⇧⌘Q)
W	Close the window or tab (⌘W)	Close (⌘W)	Sleep the display		Sleep the Mac
A		Mission Control (⌃↑)	Show the desktop (F11)	Open Apps (Launchpad)
S	Next tab (⌃Tab)	Previous tab (⌃⇧Tab)	Next window of the app (⌘`)	Previous window of the app (⇧⌘`)

⇪ A on its own has no binding. Sleep the display and Sleep the Mac are built-in actions that run immediately; in the Playground's Safe Practice mode they are only previewed.

Configurator

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

Pick a control plane from the table or by clicking the left-side modifiers, then click any key to see the Karabiner rule behind it. Keys that launch an application can be renamed. Your edits stay in this page until you copy or download the JSON; nothing is sent anywhere.

The interactive configurator runs only on the web page: it shows all sixteen control planes, lets you rename the application shortcuts, and exports a JSON file for Karabiner-Elements. Current configuration (3.1.0): capslock.json

FAQ

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

Do I need Karabiner-Elements?

No. Capslock is a standalone app and builds the whole layout in. If you also run Karabiner-Elements for other keys, that is fine as long as no Karabiner rule uses Caps Lock or F18. See Coexisting with Karabiner-Elements.

Why does it need Accessibility?

To change key events, not just observe them, macOS requires an active event tap, and that requires Accessibility. Capslock does not ask for Input Monitoring, does not install a kernel extension or driver, and runs no privileged helper.

Function and media keys

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

The function row

Key	`⇪`	`⇪ ⌘`
F1	Brightness down	⌃1, switch to desktop 1
F2	Brightness up	⌃2, switch to desktop 2
F3	Mission Control (⌃↑)	⌃3, switch to desktop 3
F4	Open Apps (Launchpad)
F5	Keyboard light down
F6	Keyboard light up
F7	Previous track
F8	Play or pause
F9	Next track
F10	Mute
F11	Volume down
F12	Volume up
F13	Screenshot of the screen to the clipboard (⌃⇧⌘3)	Screenshot of the screen to a file (⇧⌘3)
F14	Screenshot and recording toolbar (⇧⌘5)	⇧⌘6
F15	Play or pause
`	Screenshot of an area to the clipboard (⌃⇧⌘4)	Screenshot of an area to a file (⇧⌘4)

These chords need the key to arrive as a real F-key. If the top row of your keyboard controls brightness and volume by default, hold fn as well, or turn on "Use F1, F2, etc. keys as standard function keys" in System Settings. ⌃1 to ⌃3 switch desktops only when those shortcuts are enabled in System Settings.

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.

How Capslock works: F18, an event tap, and a mapping it gives back

Fri, 06 Nov 2026 00:00:00 +0000

Caps Lock sits in the best spot on the keyboard and does the least useful job. Capslock gives it a new one: tap it for Escape, hold it for Hyper, and combine it with the four modifiers to reach sixteen control planes. This post explains how a native app does that on macOS without a kernel extension, a driver, or a privileged helper.

Caps Lock is not a modifier

macOS does not report Caps Lock as a key that goes down and comes back up. It reports a lock state that flips, and it adds a short delay so that brushing the key does not toggle it. That is fine for typing capitals and useless for a modifier that must be held.

Capslock 0.4.0

Sat, 26 Sep 2026 00:00:00 +0000

Release candidate

0.4.0 is in candidate acceptance. It has not been signed, notarized, or published for download yet. See Download for the current status.

What's new

A clearer first run. Onboarding ends on the complete keyboard. You can browse it before granting keyboard access, and the app says plainly whether it is running your keyboard or only showing a preview.
Lessons follow your configuration. The first Playground chapter now includes Hyper+Space. If you changed or disabled a key a lesson uses, the lesson says so. Safe Practice previews are marked differently from actions that really ran.
Profile behaviour travels with your mappings. Choose what unmapped keys do and which modifier sides select a plane. An explicit pass-through is kept apart from a removed binding, and both survive Undo and export.
Recovery reports what it verified. Restoring Caps Lock reports success only after the system mapping has been read back. When the mapping cannot be read, ownership is shown as unknown instead of guessed.
Clear local-data and trust boundaries. Statistics explain what a trigger count is and how long it is kept. Shell approval explains that a command runs with your user privileges, may use the network, and is not undone by Pause or Undo.

Since the candidate was cut

Work on 0.4.0 continued after the candidate was cut, and the following fixes are part of the same version:

Capslock 0.3.0

Tue, 08 Sep 2026 00:00:00 +0000

Internal build

0.3.0 was a development build and was not distributed publicly.

Safer keyboard recovery. Reconnecting a keyboard checks for remapper conflicts again. Differing per-device mappings are preserved instead of merged, and an explicit Pause cancels pending wake-up retries.
Stronger configuration handling. Malformed numbers, duplicate document sections, and invalid fallback actions are rejected safely. An empty profile can be exported and restored, and a failed statistics write is retried.
More reliable pointer controls. Continuous movement follows the real cursor position, and releasing a chord cancels pending movement and scrolling.
Editor and diagnostics. Menus follow language changes, and a diagnostics export can replace an existing archive.
Compatibility. Mappings that reference a retired built-in action still load, and preview mode cannot change permissions or login items.

Capslock 0.2.0

Tue, 11 Aug 2026 00:00:00 +0000

Internal build

0.2.0 was a development build and was not distributed publicly.

The complete Classic layout is the default. A fresh start loads every binding of the Capslock Classic profile instead of a minimal starter map.
A keyboard-first editor. The default view shows the sixteen named planes, the full main keyboard, and the numeric keypad together, with each mapped action written on its key.
Explicit Caps semantics. Tapping Caps sends Escape. Hyper+Space sends the real Control-Space input-source shortcut. Hyper+Escape toggles the real Caps Lock.
English and Chinese. The app follows the system language, ships complete English and Simplified Chinese text, and falls back to English for other languages.
Auditable safety. Imported executable actions lose their trust until you review them, and diagnostics and recovery never change Karabiner-Elements.

Capslock 0.1.0

Mon, 10 Aug 2026 00:00:00 +0000

Internal build

0.1.0 was a development build and was not distributed publicly.

Capslock Classic built in. Every behaviour of the Classic profile has an explicit native counterpart, resolved exactly across sixteen planes.
Two Hyper modes. Classic Compatibility holds the right-side modifiers for Alfred, Moom, and existing shortcuts; Native Clean keeps the control layer private to Capslock.
Native editor and app overrides. Inspect, rebind, disable, restore, validate, and undo or redo a key, and scope an action to one app by its exact bundle ID, without editing JSON by hand.
Hold-to-Reveal and Playground. See the current named plane while you hold Caps, learn tap, hold, Hyper+Escape and H/J/K/L, then explore in Free Play.
Safe Practice and recovery. Lessons block dangerous effects, and losing focus returns to live mode. Diagnostics can release synthetic input, restore Caps Lock, and export a redacted report.
Coexistence by default. Existing non-Caps hidutil mappings are kept, a Caps or F18 conflict stops activation, and Karabiner-Elements is never installed or reconfigured.

Download

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

No public download yet

Capslock 0.4.0 is a release candidate in final acceptance. A download link will appear here only after the release is Developer ID signed, notarized, installed on a clean account, smoke-tested on Intel and macOS 14, and its update feed is verified. Until then there is no official build to download.

Release status

Current version: 0.4.0, release candidate
Public download: not yet available
Licence: proprietary software; the terms are published with the release
Release notes: Capslock 0.4.0

System requirements

macOS 14 Sonoma or later.
A Mac with Apple silicon or an Intel processor. The app is a single Universal build.
The Accessibility permission. Capslock does not ask for Input Monitoring.
Nothing else is installed: no kernel extension, DriverKit driver, root daemon, or privileged helper.

If Karabiner-Elements or another remapper already maps Caps Lock, Capslock reports the conflict and does not start until you resolve it. See Coexisting with Karabiner-Elements.

Capslock

Capslock goes native

Configuration file

Where files are kept

Install and Hyper basics

Install and first run

Requirements

Install

Keyboard editor

Change one key

Mac V2

Navigation and selection

Move and select

App rules

How rules are matched

Diagnostics and recovery

The checks

Learn the layout

Hold-to-Reveal

Mac V1

Mouse and scrolling

On the letter keys

Navigation, deletion, and mouse

The navigator block

Actions

Built-in actions

Coexisting with Karabiner-Elements

What counts as a conflict

Windows and developer workflows

Window control

Editing, symbols and clipboard

Delete

Uninstall

Windows

Hyper mode and profile behaviour

Hyper mode

Privacy

What is stored locally

System functions and reference

Function and system keys

Windows and apps

Window control

Configurator

FAQ

Do I need Karabiner-Elements?

Why does it need Accessibility?

Function and media keys

The function row

Settings, menu bar and statistics

Settings

How Capslock works: F18, an event tap, and a mapping it gives back

Caps Lock is not a modifier

Capslock 0.4.0

What's new

Since the candidate was cut

Capslock 0.3.0

Capslock 0.2.0

Capslock 0.1.0

Download

Release status

System requirements