# Karabiner Edition

> The free, open-source Capslock layout as a Karabiner-Elements configuration: install it in one click, learn every key, customize it, and find its earlier versions.

---

LLMS index: [llms.txt](/llms.txt)

---

Before Capslock was a native app, it was a configuration for
[Karabiner-Elements](https://karabiner-elements.pqrs.org/), and it still is.
**Capslock Enhancement V3** is a set of Karabiner rules that turns Caps Lock
into Escape on a tap and a Hyper key on a hold, with the same sixteen control
planes and the same layout that the native app ships as Capslock Classic. It is
free and open source under the Apache 2.0 licence, with its source at
[github.com/Vonng/Capslock](https://github.com/Vonng/Capslock).

## Which one should I use? {#choose}

| | Karabiner Edition | Capslock app |
| :--- | :--- | :--- |
| What you install | Karabiner-Elements, then import one rule file | The Capslock app |
| Permissions | Karabiner's driver, background services, Accessibility and Input Monitoring | Accessibility only |
| Changing a key | Edit the JSON, or use the [configurator](/docs/karabiner/configurator/) | Click the key in the [editor](/docs/guide/editor/) |
| Learning the layout | These pages and the configurator | Hold-to-Reveal and the Playground |
| Price and source | Free, Apache 2.0, open source | Proprietary; see [Download](/download/) |
| Status | Maintained | 0.4.0 release candidate |
{.matrix}

Use only one of them for Caps Lock at a time. The Capslock app refuses to
start while a Karabiner rule uses Caps Lock; turn the rules off in
Karabiner-Elements first, as described in
[Coexisting with Karabiner-Elements](/docs/start/karabiner/).

## Start in three steps {#quick-start}

1. Install [Karabiner-Elements](https://karabiner-elements.pqrs.org/) and grant
   the permissions it asks for.
2. Import the rules with the button on [Install](/docs/karabiner/getting-started/#import).
3. In Karabiner-Elements › Complex Modifications, enable every Capslock rule.
{.steps}

Tap Caps Lock: Escape. Hold it and press H J K L: the cursor moves.

## Versions {#versions}

| Version | Years | Runs on | Status |
| --- | --- | --- | --- |
| [Mac V3](/docs/karabiner/getting-started/) | 2021 – today | Karabiner-Elements | Maintained |
| [Mac V2](/docs/karabiner/archive/mac-v2/) | 2017 – 2021 | Karabiner-Elements | Archived |
| [Mac V1](/docs/karabiner/archive/mac-v1/) | 2015 – 2017 | Karabiner and Seil | Archived |
| [Windows](/docs/karabiner/archive/windows/) | 2013 – 2015 | AutoHotkey | Archived |

---

Section pages:

- [Install and Hyper basics](/docs/karabiner/getting-started/): Install Karabiner-Elements, import the Capslock rules in one click, check that they work, and learn tap, hold, Hyper and the sixteen control planes.
- [Navigation, deletion, and mouse](/docs/karabiner/navigation/): Move and select text, delete by character, word or line, and drive the pointer and wheel from the home row, the arrow keys or the keypad.
- [Windows and developer workflows](/docs/karabiner/workflows/): Close and cycle windows, launch applications, send terminal and IDE chords, keep five extra clipboards, and type code punctuation from the home row.
- [System functions and reference](/docs/karabiner/reference/): Function keys, screenshots, the symbols used in this manual, how a rule is written, what changed in V3.1, customization, and troubleshooting.
- [Configurator](/docs/karabiner/configurator/): Browse all sixteen control planes of the Karabiner rules, inspect any key, rename the application shortcuts, and export a JSON file to import.
- [Earlier versions](/docs/karabiner/archive/): The Mac V2, Mac V1 and Windows editions of the Capslock layout, kept for history and no longer maintained.

---

Backlinks:

- [Capslock goes native](/blog/post/capslock-goes-native/)
- [System and reference](/docs/karabiner/reference/)
- [Coexisting with Karabiner-Elements](/docs/start/karabiner/)
- [Download](/download/)