aboutsummaryrefslogtreecommitdiffstats
path: root/docs
diff options
context:
space:
mode:
authorMichelle Tilley <michelle@michelletilley.net>2026-02-05 20:20:19 -0800
committerGitHub <noreply@github.com>2026-02-05 20:20:19 -0800
commit12de1bc44e9056636191ff6d8a1b94c6069b11e4 (patch)
tree24ec42da85aed9f2d349e3997aedb91eedbaacdc /docs
parentchore: update changelog (diff)
downloadatuin-12de1bc44e9056636191ff6d8a1b94c6069b11e4.zip
fix(tui): space and F1-F24 keys not handled properly by new keybind system (#3138)
Fixes two keymap issues introduced in #3127: 1. Space key does nothing - Pressing space in the search input didn't insert a space character 2. F12 not recognized - Function keys (F1-F24) couldn't be used in `[keymap]` config
Diffstat (limited to 'docs')
-rw-r--r--docs/docs/configuration/advanced-key-binding.md3
1 files changed, 2 insertions, 1 deletions
diff --git a/docs/docs/configuration/advanced-key-binding.md b/docs/docs/configuration/advanced-key-binding.md
index ecd7bf8c..c8ad3347 100644
--- a/docs/docs/configuration/advanced-key-binding.md
+++ b/docs/docs/configuration/advanced-key-binding.md
@@ -5,7 +5,7 @@ Atuin includes a powerful keybinding system that can be used to fully customize
The `[keymap]` section in your config replaces the older `[keys]` section. If any `[keymap]` settings are present, the `[keys]` section is ignored entirely.
!!! warning
- Modifier keys and some special characters work best with a terminal that implements the kitty keyboard protocol. Notably, the default macOS Terminal app does _not_ include this feature. For more information and a list of terminals that are known to support this protocol, see https://sw.kovidgoyal.net/kitty/keyboard-protocol/
+ Modifier keys, F1-F24 keys, and some special characters work best - or _only_ work - with a terminal that implements the kitty keyboard protocol. Notably, the default macOS Terminal app does _not_ include this feature. For more information and a list of terminals that are known to support this protocol, see [https://sw.kovidgoyal.net/kitty/keyboard-protocol/](https://sw.kovidgoyal.net/kitty/keyboard-protocol/).
## Keymaps
@@ -39,6 +39,7 @@ Lowercase letters, digits, and named keys:
"enter", "esc", "tab", "space", "backspace", "delete"
"up", "down", "left", "right"
"home", "end", "pageup", "pagedown"
+"f1", "f2", ... "f12", ... "f24"
```
`return` is an alias for `enter`. `escape` is an alias for `esc`. `del` is an alias for `delete`.