# 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:

```bash
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`:

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