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

History

Eberhard Beilharz ec2373acd5 fix(linux): start system service when switching keyboards This change fixes #13171 where we failed to output after the first keypress because the keyman system service had to be started. This change introduces a new method `Ping` that we call to force keyman-system-service to be started. Fixes: #13171		2025-02-10 16:30:20 +01:00
..
man	chore(linux): Fix lintian warnings	2023-06-05 17:18:55 +02:00
resources	chore(linux): improve compatibility with Gentoo Linux 🍒	2025-01-29 09:18:22 +01:00
src	fix(linux): start system service when switching keyboards	2025-02-10 16:30:20 +01:00
tests	refactor(linux): Implement ordered output sentinel in keyman-system-service	2025-02-05 11:42:04 +01:00
.gitignore	chore(linux): use shared meson config	2024-06-24 19:08:12 +02:00
build.sh	chore(linux): use shared meson config	2024-06-24 19:08:12 +02:00
meson.build	chore(linux): improve compatibility with Gentoo Linux 🍒	2025-01-29 09:18:22 +01: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