2.4 KiB
Fedora Tools settings
This optional KDE Configuration Module lists tools published in the configured
fedora-tools RPM repository. It appears as Fedora Tools in Plasma System
Settings and can also be opened directly:
kcmshell6 kcm_fedora_tools
Packages advertise themselves with the RPM capability fedora-tools-tool.
The module uses DNF's repository metadata for discovery and delegates package
installation to a narrowly scoped KAuth helper. The helper accepts only valid
package names that independently resolve to that capability in the
fedora-tools repository.
Update detection compares repository and installed versions using RPM's version ordering, without requiring access to DNF's privileged transaction state. DNF still checks dependencies when installing an update. The repository file sets a five-minute metadata expiry so Discover's PackageKit backend checks it regularly.
Installed tools can also be configured or removed from the module. Package operations run one at a time; other actions remain disabled until DNF finishes. The module currently configures task-group shortcut behaviour, touchpad hold-tap timing and output, and the experimental fingerprint workaround.
Installed packages are discovered independently of repository metadata, so
locally installed tools appear even before they are published. Tools with their
own settings window can register it by installing
/usr/share/fedora-tools/settings/PACKAGE-NAME.json:
{"command": ["/usr/bin/example-tool", "--settings"]}
The Configure button launches this command as the current user, without a
shell or administrator privileges. This registration needs no tool-specific
change to the settings module. The package must provide fedora-tools-tool;
arbitrary installed applications are not included in this list.
Hardware-specific compatibility checks hide Framework Laptop Tools from the available list on unvalidated models. A manually installed copy remains visible as incompatible, with removal available but configuration and updates disabled. Its own privileged helper also checks the model before any change.
Installing this module does not install or activate any other tool. Tools remain usable without the module.
The fingerprint-workaround page can enable the tested build, select a locally built RPM, allow an intentional version change, and restore Fedora's official KScreenLocker package. These operations require administrator authentication.