Initial low vision features added. xzoom needs to be installed for magnification. This first implementation is probably terrible, feedback welcome for improvement. Screen lock can now happen when I38 starts. As a reminder, it's not as secure as one of the system lockers, but it is screen reader accessible and should keep casual snoopers thwarted.
This commit is contained in:
1 parent
7ef49290ea
commit
1a2252d8de
5 files changed
+158
-22
No files matched your search
@@ -1,10 +1,10 @@
|
||||
# Welcome to I38 - Accessible i3 Window Manager
|
||||
|
||||
> **Note:** This help guide has been tailored to your specific configuration. You've chosen **@WEBBROWSER@** as your web browser, **@MODKEY@** as your mod key, and you're using the **@SCREENREADER@** screen reader.
|
||||
> **Note:** This help guide has been tailored to your specific configuration. You've chosen **@WEBBROWSER@** as your web browser, **@MODKEY@** as your mod key, and your screen reader setting is **@SCREENREADER@**.
|
||||
|
||||
## Introduction to I38
|
||||
|
||||
I38 is a configuration for the i3 window manager that makes it more accessible for blind people. It features audio feedback, screen reader integration, and keyboard shortcuts designed for non-visual navigation.
|
||||
I38 is a configuration for the i3 window manager that makes it more accessible for blind and low-vision people. It features audio feedback, optional screen reader integration, low-vision-friendly visual settings, and keyboard shortcuts designed for efficient navigation.
|
||||
|
||||
Unlike traditional desktop environments like GNOME or MATE, i3 is a tiling window manager, which means windows are arranged in a non-overlapping layout. This can be more efficient to navigate by keyboard, as windows are organized in a predictable structure.
|
||||
|
||||
@@ -67,9 +67,9 @@ Common Ratpoison mode commands:
|
||||
| `k` | Kill (close) the current window |
|
||||
| `F1` | Show ratpoison mode keybindings |
|
||||
| `Escape` or `Control` + `g` | Exit Ratpoison mode without taking action |
|
||||
| `Shift` + `c` | Restart Cthulhu screen reader |
|
||||
| `Shift` + `o` | Restart Orca screen reader |
|
||||
| `Shift` + `t` | Toggle screen reader |
|
||||
| `Shift` + `c` | Restart Cthulhu screen reader, if installed |
|
||||
| `Shift` + `o` | Restart Orca screen reader, if installed |
|
||||
| `Shift` + `t` | Toggle screen reader, if one was configured |
|
||||
| `Control` + `;` | Reload I38 configuration |
|
||||
| `Control` + `q` | Exit i3 (log out) |
|
||||
| `!` | Open run dialog |
|
||||
@@ -200,10 +200,10 @@ waytray is an optional dependency. If installed, I38 will automatically configur
|
||||
|
||||
### Screen Reader
|
||||
|
||||
I38 is configured to work with your screen reader (@SCREENREADER@). The screen reader will provide spoken feedback about what's happening on screen so long as there is a window. If you don't have a window open and need to change something @SCREENREADER@ related, press Control+Alt+d to bring up the desktop, then screen reader keys should work.
|
||||
If you configured a screen reader, I38 uses @SCREENREADER@. The screen reader will provide spoken feedback about what's happening on screen so long as there is a window. If you don't have a window open and need to change something screen-reader related, press Control+Alt+d to bring up the desktop, then screen reader keys should work.
|
||||
|
||||
- Toggle screen reader: `@RATPOISONKEY@` then `Shift` + `t`
|
||||
- Restart screen reader: `@RATPOISONKEY@` then `Shift` + `o` (for Orca) or `Shift` + `c` (for Cthulhu)
|
||||
- Restart screen reader: `@RATPOISONKEY@` then `Shift` + `o` (for Orca, if installed) or `Shift` + `c` (for Cthulhu, if installed)
|
||||
- Interrupt speech: `@MODKEY@` + `Shift` + `F5`
|
||||
|
||||
*GNOME/MATE comparison:* GNOME uses Orca by default with its own keyboard shortcuts. I38 integrates screen readers more deeply with the window manager.
|
||||
@@ -212,6 +212,17 @@ I38 is configured to work with your screen reader (@SCREENREADER@). The screen r
|
||||
|
||||
If you've enabled braille display support during setup, I38 will start XBrlAPI automatically to provide braille output from your screen reader.
|
||||
|
||||
### Low-Vision Support
|
||||
|
||||
During setup, I38 asks for the window title font size used by i3. The default is larger than standard i3 so window titles and tab labels are easier to see.
|
||||
|
||||
- I38 applies a larger mouse cursor size at startup when xrdb is available.
|
||||
- Find the mouse pointer: `@MODKEY@` + `Control` + `m`
|
||||
- Start xzoom magnifier, if installed when your i3 config was generated: `@MODKEY@` + `Control` + `z`
|
||||
- Adjust screen brightness or enable the screen curtain, if xrandr is available: In Ratpoison mode, `Alt` + `s`
|
||||
|
||||
I38 keeps windows in a tabbed layout by default. This gives the focused app most of the screen and reduces visual clutter, but it also means switching windows is usually done with `Alt` + `Tab`, the window list, or workspace keys rather than by clicking overlapping windows.
|
||||
|
||||
### OCR (Optical Character Recognition)
|
||||
|
||||
If required dependencies are installed, you can use OCR to read text from images or inaccessible applications:
|
||||
@@ -227,6 +238,8 @@ If you enabled the I38 privacy screen lock during setup, press `Control` + `Alt`
|
||||
|
||||
When a screen lock PIN is configured, I38 can also autolock after an idle timeout. The default is never. Autolock is X11/i3-only and requires `xprintidle`; if `playerctl` is installed, I38 will avoid autolocking during likely video playback.
|
||||
|
||||
If you chose to lock the screen when I38 starts, I38 launches the privacy screen shortly after i3 startup. Startup lock is meant to prevent casual snooping, not to secure the system against a determined user.
|
||||
|
||||
### Sound Effects
|
||||
|
||||
I38 provides audio feedback for many actions:
|
||||
@@ -316,6 +329,8 @@ In Ratpoison mode, these are also available with Alt+Shift combinations:
|
||||
- Check battery status: In Ratpoison mode, `Alt` + `b`
|
||||
- Check game controller status: In Ratpoison mode, `g`
|
||||
- Adjust screen brightness (if xrandr is available): In Ratpoison mode, `Alt` + `s`
|
||||
- Find the mouse pointer: `@MODKEY@` + `Control` + `m`
|
||||
- Start xzoom magnifier, if installed: `@MODKEY@` + `Control` + `z`
|
||||
|
||||
*GNOME/MATE comparison:* These functions are typically available through system menus or indicators in GNOME/MATE.
|
||||
|
||||
|
||||
Reference in new issue
Block a user