# Cthulhu

Cthulhu is a Linux screen reader written in Go.

- [Repository Guidelines](AGENTS.md): layout, commands, and working safeguards.
- [Contributing](CONTRIBUTING.md): development, accessibility verification, licensing, and the AI-assisted contribution policy.
- [LibreOffice support](LIBREOFFICE_SUPPORT.md): integration boundaries, initial Calc behavior, remaining work, and verification.

AI-assisted contributions are welcome. Contributors remain responsible for human review and testing before submission; see the [full policy](CONTRIBUTING.md#ai-assisted-contributions).

## Wine Access

Install the separate `wine-access` helper for Wine application accessibility.
Cthulhu checks `CTHULHU_WINE_ACCESS_HELPER`, then
`~/.local/libexec/wine-access/wine-access.exe`,
`/usr/local/libexec/wine-access/wine-access.exe`,
`/usr/libexec/wine-access/wine-access.exe`, and `wine-access.exe` on `PATH`.
The existing `cthulhu-wine-access.exe` lookup remains supported: the old user
location follows the new user location, the old `/usr` location follows the new
system locations, and the old name on `PATH` follows the new name.
Restart Cthulhu after changing the selected helper. Keep the launcher, its
`.exe.so` sidecar, and the native hooks together in the installed directory.

Wine typing feedback in standard Edit controls follows the current key echo
settings, including the master switch, character echo, and alphabetic, numeric,
punctuation, space and diacritical categories. Tabs and line breaks follow
key echo's action-key setting. Applying preferences takes effect without
restarting the helper. Navigation, selection and deletion feedback remain
available when typing echo is disabled. Word and sentence typing echo are not
currently supplied by the Wine helper.

For a live check, type repeated letters, numbers, punctuation and spaces in
Wine Notepad, change the corresponding echo settings and apply them, then
continue typing. Disable key echo and verify that typing stays quiet while
arrows, selection and Backspace still report editing feedback. Re-enable it
and check capital/lowercase voices and password exclusion. Automated tests
cover queued speech and Braille; audible speech and a physical Braille display
still require live verification.