From 48c47ccbb5ff351191ac9b9fe863fb955acb8fb1 Mon Sep 17 00:00:00 2001 From: nfortunato8-bit Date: Fri, 11 Sep 2026 10:40:13 +0200 Subject: [PATCH] Document accented letters on the CapsLock compose key MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit The manual lists the emoji and name/email compose sequences but never says the system compose table is loaded too, so CapsLock ' E -> é and CapsLock ~ N -> ñ already work on the plain us layout. Users on Spanish, Italian, and other Latin-script languages keep concluding Caps Lock is simply broken (#9560) and go looking for a kb_variant or an XCompose override they don't need. Add an accents table to the hotkeys chapter, link it from the keyboard chapter and the troubleshooting entry, and note there that both Shifts together is where Caps Lock itself lives. Co-Authored-By: Claude Fable 5.1 Claude-Session: https://claude.ai/code/session_018WkCkwpv7MXMNxKTryEZVG --- manual/07-hotkeys.md | 18 ++++++++++++++++++ manual/34-keyboard-mouse-trackpad.md | 2 +- manual/45-troubleshooting.md | 2 +- 3 files changed, 20 insertions(+), 2 deletions(-) diff --git a/manual/07-hotkeys.md b/manual/07-hotkeys.md index 72acdc8a27c..65465befc1a 100644 --- a/manual/07-hotkeys.md +++ b/manual/07-hotkeys.md @@ -372,3 +372,21 @@ You can use `Super + Ctrl + E` to show a complete emoji picker that'll put the s | `CapsLock Space E` | Your email (as entered on setup) | You can add more of your own by editing `~/.XCompose`, then running `omarchy-restart-xcompose` in the terminal to get the changes picked up. + +## Accents and Special Characters + +CapsLock is a standard [compose key](https://en.wikipedia.org/wiki/Compose_key), so the full system compose table works on the plain `us` layout too. Press the keys one after another rather than holding them: CapsLock, then the accent, then the letter. Capital letters work the same way with Shift. + +| Hotkey | Result | +| ------------ | ---------- | +| `CapsLock ' E` | é (also á í ó ú) | +| ``CapsLock ` E`` | è (also à ì ò ù) | +| `CapsLock ~ N` | ñ | +| `CapsLock " U` | ü (also ä ë ï ö) | +| `CapsLock ^ E` | ê | +| `CapsLock , C` | ç | +| `CapsLock S S` | ß | +| `CapsLock ? ?` | ¿ | +| `CapsLock ! !` | ¡ | +| `CapsLock = E` | € | +| `CapsLock O O` | ° | diff --git a/manual/34-keyboard-mouse-trackpad.md b/manual/34-keyboard-mouse-trackpad.md index 648e7713d8d..8bef275fec5 100644 --- a/manual/34-keyboard-mouse-trackpad.md +++ b/manual/34-keyboard-mouse-trackpad.md @@ -37,7 +37,7 @@ o.window("(Alacritty|kitty|foot)", { scroll_touchpad = 1.5 }) You can [see all the input options](https://wiki.hypr.land/Configuring/Basics/Variables/#input) on the Hyprland wiki for inputs. -By default, Omarchy uses CapsLock as the compose key for [quick emojis](07-hotkeys.md#quick-emojis) and [other completions](07-hotkeys.md#quick-completions). If you'd rather use CapsLock as Caps Lock, move the compose key elsewhere by changing `compose:caps` in `kb_options`. For example, this moves the compose key to Right Alt: +By default, Omarchy uses CapsLock as the compose key for [quick emojis](07-hotkeys.md#quick-emojis), [accents](07-hotkeys.md#accents-and-special-characters), and [other completions](07-hotkeys.md#quick-completions). If you'd rather use CapsLock as Caps Lock, move the compose key elsewhere by changing `compose:caps` in `kb_options`. For example, this moves the compose key to Right Alt: ```lua hl.config({ diff --git a/manual/45-troubleshooting.md b/manual/45-troubleshooting.md index b308e69ff0d..4b067d254d9 100644 --- a/manual/45-troubleshooting.md +++ b/manual/45-troubleshooting.md @@ -12,7 +12,7 @@ For Spotify, you can use `Ctrl + Minus` to shrink the UI (and `Ctrl + Plus` to m ### Why isn't Caps Lock working? -In Omarchy, Caps Lock has been designated to be the xcompose key. That's how you get [quick emojis](07-hotkeys.md#quick-emojis) and [other autocompletions](07-hotkeys.md#quick-completions) done. If you really miss using Caps Lock, you can remap the xcompose key to something else by editing `~/.config/hypr/input.lua`, like setting it to the right alt key: +In Omarchy, Caps Lock has been designated to be the xcompose key. That's how you get [quick emojis](07-hotkeys.md#quick-emojis), [accented letters](07-hotkeys.md#accents-and-special-characters), and [other autocompletions](07-hotkeys.md#quick-completions) done. If you need actual caps, press both Shift keys together to turn Caps Lock on, and any single Shift press to turn it back off. If you really miss using Caps Lock, you can remap the xcompose key to something else by editing `~/.config/hypr/input.lua`, like setting it to the right alt key: ``` hl.config({