mirror of https://github.com/keymanapp/keyman.git synced 2026-08-06 00:45:32 +00:00

History

Eberhard Beilharz 4ea6296237 Merge pull request #13980 from keymanapp/fix/linux/13971_installpath This makes the path in `com.keyman.SystemService1.service` configurable when using basu (e.g. Gentoo Linux). Fixes: #13971		2025-05-20 14:59:07 +02:00
..
man	maint(linux): fix lintian warnings	2025-05-13 20:07:32 +02:00
resources	fix(linux): configurable path in `.service` file when using basu	2025-05-19 09:46:41 +02:00
src	fix(linux): use correct header guard define in OrderedOutputDevice.h	2025-05-16 16:16:54 +02:00
tests	chore(linux): add a stub unit test to allow successful coverage reporting	2025-04-23 18:52:10 +02:00
.gitignore	maint(linux): fix lintian warnings	2025-05-13 20:07:32 +02:00
build.sh	maint(linux): add `--no-werror` option to not report warnings as errors	2025-05-20 09:01:22 +02:00
meson.build	maint(linux): fix lintian warnings	2025-05-13 20:07:32 +02:00
README.md	docs(core): Document how to build Core on Linux	2023-07-24 19:54:17 +02:00

README.md

keyman-system-service

A DBus system service that allows to access /dev/input/* devices to toggle capslock and perform other keyboard related actions. This is required when running under Wayland, but also used with X11.

See https://0pointer.net/blog/the-new-sd-bus-api-of-systemd.html, https://stackoverflow.com/a/44281937, https://github.com/chiehmin/gdbus_test/blob/master/server.c, https://aleksander.es/data/GNOMEASIA2014%20-%20Introduction%20to%20DBus.pdf.

Notes

If we need to limit access to the interface to only Keyman, we can use polkit which allows to add a rule with an action that checks for the program.
to see the log file
```
journalctl -f -u systemd-keyman
```

to monitor method calls

sudo busctl monitor com.keyman.SystemService1