# Documentation

> Install Capslock, learn the default layout, customize it, and fix problems.

---

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

---

Capslock turns Caps Lock into a second keyboard layer on macOS. Three ideas
explain everything else:

- **Tap and hold.** Tapping Caps Lock sends Escape. Holding it turns the keys
  under your hands into actions: `⇪ H J K L` move the cursor, `⇪ N` deletes a
  word, `⇪ E` opens Safari.
- **Planes.** The modifiers you hold with Caps Lock choose one of sixteen
  planes. `⇪ H` moves left, `⇪ ⌘ H` selects left, `⇪ ⌥ H` moves the mouse
  left.
- **Mappings.** Each key on each plane maps to one action, optionally with a
  different action in particular apps. Capslock ships the complete Capslock
  Classic layout and lets you change any of it.

New to Capslock? Start with [Install and first run](/docs/start/install/),
then keep [Default layout](/docs/layout/) open while you learn.

---

Section pages:

- [Get started](/docs/start/): Install Capslock, grant the one permission it needs, and learn the layout.
- [Default layout](/docs/layout/): The Capslock Classic layout that ships with the app, plane by plane.
- [Customize](/docs/guide/): Change keys, add your own actions, scope a key to one app, and choose how Hyper behaves.
- [Reference](/docs/reference/): Configuration file, diagnostics and recovery, privacy, uninstalling, and common questions.
- [Karabiner Edition](/docs/karabiner/): 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.

---

Backlinks:

- [Capslock goes native](/blog/post/capslock-goes-native/)