Bug fixes and package updates.

This commit is contained in:
ak47 committed 2026-11-07 13:14:22 -05:00
1 parent 19b789ef5c
commit d0c977281d
11 files changed
+176 -27

No files matched your search

+12 -4
View File
@@ -23,9 +23,10 @@ AI-assisted contributions are welcome. Contributors remain responsible for human
## Building
Run `./build-cthulhu.sh` to build `cthulhu` and `cthulhu-braille` in the
checkout root. The script works from any directory. It uses Go's automatic
toolchain selection with Go 1.21 or newer. If Go is missing or older, it
Run `./build-cthulhu.sh` to build `cthulhu`, `cthulhu-braille`, and
`cthulhu-input-helper` in the checkout root. The script works from any
directory. It uses Go's automatic toolchain selection with Go 1.21 or newer.
If Go is missing or older, it
downloads the version required by `go.mod`, verifies the archive's SHA-256,
and caches it under `${XDG_CACHE_HOME:-$HOME/.cache}/cthulhu/toolchains`.
It does not replace system Go or require root.
@@ -38,7 +39,7 @@ Bootstrapping Go additionally needs `curl`, `tar`, and `sha256sum`.
See [Contributing](CONTRIBUTING.md#development-and-architecture) and the
Arch package recipes under `distro-packages/Arch-Linux/` for dependencies.
For packaging, put both binaries in a separate directory and pass build flags
For packaging, put all three binaries in a separate directory and pass build flags
after `--`:
```sh
@@ -58,6 +59,7 @@ that must use an installed toolchain:
GOTOOLCHAIN=local GOPROXY=off ./build-cthulhu.sh --output-dir build -- -mod=readonly
install -Dm755 build/cthulhu "$pkgdir/usr/bin/cthulhu"
install -Dm755 build/cthulhu-braille "$pkgdir/usr/bin/cthulhu-braille"
install -Dm755 build/cthulhu-input-helper "$pkgdir/usr/bin/cthulhu-input-helper"
```
For offline builds, provision a suitable Go version and module cache in
@@ -65,6 +67,12 @@ advance. Build inside the target distribution to link against its native
libraries; downloading Go does not supply those libraries. `--help` lists
the script's options without checking dependencies or accessing the network.
Keep all three executables together when installing or using a custom launch
script. `cthulhu-input-helper` receives remote keyboard input on Xorg. Without
it, Cthulhu can control another computer, but cannot accept its keyboard input.
The October 2026 release predates this helper and incoming Remote keyboard
support; packaging that release cannot enable the newer feature.
## Start with the laptop keyboard layout
Run `cthulhu -l` to use the laptop layout with Caps Lock as the Cthulhu