From e11c35c3879ddf5002f17ea836456f01d5d3c4b1 Mon Sep 17 00:00:00 2001 From: Ivan Molodetskikh Date: Wed, 27 Aug 2025 14:20:22 +0300 Subject: wiki/Accessibility: Expand info from feedback --- docs/wiki/Accessibility.md | 11 ++++++++++- 1 file changed, 10 insertions(+), 1 deletion(-) (limited to 'docs/wiki') diff --git a/docs/wiki/Accessibility.md b/docs/wiki/Accessibility.md index 4e6eb7c7..9da301e2 100644 --- a/docs/wiki/Accessibility.md +++ b/docs/wiki/Accessibility.md @@ -2,12 +2,21 @@ Since: next release -Niri has basic support for screen readers (specifically, [Orca](https://orca.gnome.org)). +Niri has basic support for screen readers (specifically, [Orca](https://orca.gnome.org)) when running as a full desktop session, i.e. not as a nested window. We implement the `org.freedesktop.a11y.KeyboardMonitor` D-Bus interface for Orca to listen and grab keyboard keys, and we expose the main niri UI elements via [AccessKit](https://accesskit.dev). +Specifically, niri will announce: + +- workspace switching, for example it'll say "Workspace 2"; +- the exit confirmation dialog (appears on SuperShiftE by default); +- entering the screenshot UI and the overview (niri will say when these are focused, nothing else for now); +- whenever a config parse error occurs; +- the important hotkeys list (for now, as one big announcement without tab navigation; appears on SuperShift/ by default). Make sure [Xwayland](./Xwayland.md) works, then run `orca`. The default config binds SuperAltS to toggle Orca, which is the standard key binding. +Note that we don't have an Alt-Tab window switcher yet (it's in the works), and we also don't have a bind to move focus to layer-shell panels. + If you're shipping niri and would like to make it work better for screen readers out of the box, consider the following changes to the default niri config: - Change the default terminal from Alacritty to one that supports screen readers. For example, [GNOME Console](https://gitlab.gnome.org/GNOME/console) or [GNOME Terminal](https://gitlab.gnome.org/GNOME/gnome-terminal) should work well. -- cgit