Default laptop key set to capslock. Keys that can be set to fenrir key or script key selectable via checkbox.

This commit is contained in:
Storm Dragon committed 2026-10-29 18:01:42 -04:00
1 parent 47f18fdd28
commit 15e04aa8f8
47 files changed
+1560 -351

No files matched your search

+15 -2
View File
@@ -164,7 +164,10 @@ Use `--keyboard-layout laptop` with either mode to select the laptop layout.
## Basic controls
The Fenrir key is Insert, Super/Windows, or keypad 0 with NumLock off.
The Fenrir key is Insert, Super/Windows, or keypad 0 with NumLock off in the
desktop layout. The laptop layout uses Caps Lock instead of Super/Windows;
Insert and NumLock-off keypad 0 also work. Press Shift+Caps Lock on its own
to toggle capitalization in the laptop layout.
Hold it while pressing the other keys in a shortcut. Bare keypad review keys
also require NumLock off.
@@ -213,6 +216,11 @@ Space toggles checkboxes; arrows change selections and numeric values. Activate
The menu includes speech, sound, reading, keyboard, clipboard, and other
settings. Speech rate, pitch, and volume use a scale from -100 to 100.
For speech rate, Up and Down change the value by 10; Left and Right change it by 1.
The keyboard layout combo box offers Desktop and Laptop. The Keyboard tab also
has separate Fenrir-key and script-key checkboxes for keypad Insert, Insert,
Caps Lock, and Super, plus Compose for scripts. Uncheck a key in one group
before selecting it in the other. At least one Fenrir key must remain selected.
Key assignments take effect on the next launch.
Backend, device, keyboard layout, sound theme, and other launch-only changes
take effect the next time Fenrir starts.
@@ -269,7 +277,12 @@ Keyboard layouts are separate TOML files. Named layouts are searched in the
user's `keyboard/` directory beside `settings/`, then
`/etc/fenrirscreenreader/keyboard/`, then the checkout's bundled layouts.
Root uses the system and bundled locations. `--keyboard-layout PATH.toml`
selects a file directly.
selects a file directly. Layout files can set `fenrir_keys` before their bindings;
the available names are `INSERT`, `SUPER`, `CAPSLOCK`, and `KP0`. The bundled
laptop layout uses `["CAPSLOCK", "INSERT", "KP0"]`. An explicit
`keyboard.fenrir_keys` setting overrides those defaults; its names use the
`KEY_` form shown in [settings.toml](config/settings/settings.toml). Existing
script-key assignments are excluded from implicit Fenrir-key defaults.
Speech drivers are `speech-dispatcher`, `dectalk`, `dectalk-usb`, `litetalk`,
`doubletalk`, and `tripletalk`. Serial drivers need a device path. The Speech