47 lines
2.1 KiB
Markdown
47 lines
2.1 KiB
Markdown
# 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 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`:
|
|
|
|
```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.
|