Files
fedora-tools/fedora-tools-settings/README.md
T

1.8 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.

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 behavior, 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.

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.