170 lines
7.7 KiB
Markdown
170 lines
7.7 KiB
Markdown
# Fedora tools
|
||
|
||
Small utilities for Fedora Linux, distributed as RPM packages through a Gitea
|
||
package registry. Installed tools receive updates through DNF and compatible
|
||
graphical software managers.
|
||
|
||
These tools are developed with the help of AI.
|
||
|
||
## Repository
|
||
|
||
```bash
|
||
sudo dnf config-manager addrepo \
|
||
--from-repofile=https://git.ajpanton.se/ajp_anton/fedora-tools/raw/branch/main/fedora-tools.repo
|
||
```
|
||
|
||
```bash
|
||
sudo dnf install touchpad-hold-tap
|
||
sudo dnf install plasma-always-show-unlock
|
||
sudo dnf install plasma-task-group-shortcuts
|
||
sudo dnf install plasma-fingerprint-workaround
|
||
sudo dnf install fingerprint-resume-recovery
|
||
sudo dnf install fedora-tools-settings
|
||
sudo dnf install plasma-panel-actions
|
||
```
|
||
|
||
## Compatibility
|
||
|
||
Packages are built and tested on Fedora 44 and 45.
|
||
|
||
The primary test environment is a Framework Laptop 13 Pro running Fedora Linux
|
||
44 on x86_64, with KDE Plasma 6.7–6.8 and a Wayland session using KWin.
|
||
Compatibility with other Fedora releases, desktop environments, display
|
||
systems, architectures, or distributions may be limited.
|
||
|
||
## Tools
|
||
|
||
### Fedora Tools settings
|
||
|
||
The optional `fedora-tools-settings` package adds a **Fedora Tools** page to
|
||
Plasma System Settings. It discovers tools from this RPM repository, shows
|
||
which are installed, and can install available tools after administrator
|
||
authorisation. Installed tools can also be removed, and supported tools expose
|
||
their settings there. Individual tools do not require the settings module.
|
||
|
||
### Touchpad hold-tap
|
||
|
||
Experimental. Recognizes a one-finger hold followed by a quick tap from a
|
||
second finger and emits a middle click. The held finger may move between taps.
|
||
Repeating the tap while holding the first finger produces repeated clicks,
|
||
including double middle clicks.
|
||
|
||
The minimum anchor age, required stationary time, tap durations, and emitted
|
||
mouse button or keyboard event can be changed through Fedora Tools settings or
|
||
with `touchpad-hold-tap-config`. A stationary time of zero allows recognition
|
||
while the anchor is moving. Custom plugin settings are stored under `/etc` and
|
||
survive package updates. Log out and back in after changing them.
|
||
|
||
The `touchpad-hold-tap` package requires libinput 1.30 or newer and a compositor
|
||
that enables libinput plugins. Log out and back in after installation or an
|
||
update so the compositor reloads the plugin.
|
||
|
||
### Fingerprint resume recovery
|
||
|
||
The `fingerprint-resume-recovery` package restores fingerprint unlocking after
|
||
sleep by restarting the reader service before the desktop resumes. It requires
|
||
Plasma 6.8 or newer and leaves Fedora's KScreenLocker package unchanged.
|
||
Installing enables it; removing disables it.
|
||
|
||
### Always-visible Plasma unlock prompt
|
||
|
||
The `plasma-always-show-unlock` package keeps Plasma's password and fingerprint
|
||
prompt visible from the moment the lock screen appears, including after the
|
||
display is turned off or the system resumes from sleep.
|
||
|
||
On Plasma 6.8 and newer, a small QML policy keeps the prompt visible while
|
||
leaving authentication to Plasma. It tolerates unrelated layout changes and
|
||
reapplies automatically after updates replace the lock-screen file. Unsupported
|
||
interfaces are left unchanged. Removing the package restores Plasma's original
|
||
behaviour.
|
||
|
||
Plasma 6.7 uses the earlier patch, including retries after resume and idle
|
||
fingerprint timeouts. Neither version changes `kscreenlocker` authentication
|
||
code or restarts `fprintd`. Fingerprint availability depends on the installed
|
||
KScreenLocker and fingerprint driver.
|
||
|
||
### Plasma task-group shortcuts
|
||
|
||
The `plasma-task-group-shortcuts` package makes Meta+1 through Meta+9 address
|
||
application groups instead of individual taskbar buttons. It follows the
|
||
launchers, ordering, filters, and grouping exceptions of the Task Manager on
|
||
the primary screen. Pressing a launcher opens the application; pressing an
|
||
application group starts with its first window, then advances through its
|
||
windows while Meta remains held. Holding Shift after starting a cycle moves
|
||
backward instead. Shift on the first press launches a new instance. Releasing
|
||
Meta—or pressing a different number—ends the current cycle. The shortcuts
|
||
follow the physical number-row keys for every keyboard layout configured in
|
||
KWin, including layouts where those keys do not produce digits without Shift.
|
||
|
||
A small thumbnail above the selected taskbar button shows the selection while
|
||
Meta is held, even for single-window groups. Only releasing Meta activates the
|
||
selected window, so Alt+Tab can return to the application used before the cycle.
|
||
Esc cancels the selection; another number press starts a fresh cycle without
|
||
releasing Meta. Launcher and new-instance actions still run immediately.
|
||
|
||
With **Keep launchers separate** disabled, a pinned launcher and its running
|
||
application share one shortcut position. When enabled, the launcher is its own
|
||
position and the application's windows form another. **Hide launcher when
|
||
application starts** determines whether that separate launcher remains while
|
||
the application is running. Other groups retain the Task Manager's sort order.
|
||
|
||
The first-window behaviour and both Shift behaviours can be changed through
|
||
Fedora Tools settings. Changes take effect with the next shortcut press.
|
||
|
||
If application grouping is disabled—or an application is excluded from
|
||
grouping—each of its windows remains a separate shortcut position. **Only group
|
||
when the Task Manager is full** does not alter shortcut groups; that would make
|
||
the numbers change merely because the panel changed size.
|
||
|
||
The utility starts with Plasma and records the shortcuts it replaces. Before
|
||
removing it, restore them with:
|
||
|
||
```bash
|
||
plasma-task-group-shortcuts --restore-shortcuts
|
||
```
|
||
|
||
### Plasma fingerprint workaround
|
||
|
||
For Plasma 6.8 and newer, use fingerprint resume recovery above for this issue.
|
||
|
||
Experimental and unaudited. The `plasma-fingerprint-workaround` package is an
|
||
inert controller for installing a patched Fedora KScreenLocker build that
|
||
recovers fingerprint authentication after suspend. It makes no lock-screen
|
||
changes when installed and must be enabled explicitly:
|
||
|
||
```bash
|
||
sudo plasma-fingerprint-workaround enable
|
||
```
|
||
|
||
The patched build is not present in the DNF repository and therefore cannot be
|
||
selected by a normal system update. The controller can also install a locally
|
||
built RPM and restore Fedora's original package. See the tool's
|
||
[`README`](plasma-fingerprint-workaround/README.md) for the security warning,
|
||
build instructions, version checks, and force-downgrade option.
|
||
|
||
### Plasma panel actions
|
||
|
||
The `plasma-panel-actions` package enables panel scroll actions at login,
|
||
without requiring a visible widget. Scrolling defaults to volume
|
||
control across the panel; each area can instead control screen brightness,
|
||
keyboard backlight, virtual desktops, or retain its normal behaviour.
|
||
|
||
Optional left- and middle-click/double-click actions apply only to empty space
|
||
and can also launch applications or custom commands. Add
|
||
**Panel Actions Spacer** to reserve flexible space with a configurable minimum
|
||
width. Open **Panel Actions** from the application menu or Fedora Tools settings,
|
||
with or without a spacer. See its [README](plasma-panel-actions/README.md).
|
||
|
||
### Framework Laptop Tools
|
||
|
||
Experimental `framework-laptop-tools` provides a desktop window and tray icon
|
||
for Framework Laptop 13 Pro (Intel Core Ultra Series 3). Monitor selectable
|
||
frequency and temperature graphs, fan speed, and battery charge and power.
|
||
Controls cover lighting, fan modes, battery charging, and CPU frequency limits.
|
||
Installing or opening it does not change hardware settings. See its
|
||
[README](framework-laptop-tools/README.md) for supported interfaces and limits,
|
||
including the need to use Fn+Space to switch keyboard Auto mode.
|
||
|
||
Fedora Tools settings hides this download on other hardware. If manually
|
||
installed, it remains listed as incompatible and can still be removed.
|