157 lines
7.3 KiB
Markdown
157 lines
7.3 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 fedora-tools-settings
|
|
sudo dnf install plasma-panel-actions
|
|
```
|
|
|
|
## Compatibility
|
|
|
|
The primary test environment is a Framework Laptop 13 Pro running Fedora Linux
|
|
44 on x86_64, with KDE Plasma 6.7 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.
|
|
|
|
### 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.
|
|
|
|
The package applies a narrow patch to Plasma 6.7's lock-screen QML and reapplies
|
|
it after `plasma-desktop` updates. An unknown future layout is left unchanged
|
|
instead of being modified speculatively. Removing the package restores Plasma's
|
|
original behaviour. It retries lock-screen authentication after resume, the
|
|
automatic-lock grace period and idle fingerprint timeouts. Failed scans do not
|
|
trigger automatic retries. It does not modify `kscreenlocker` authentication
|
|
code or restart `fprintd`; retry support depends on the installed KScreenLocker.
|
|
An intermittent missing fingerprint prompt can still occur; pressing a key may
|
|
restore it. The idle retry is a workaround, not a complete fix for that issue.
|
|
|
|
### 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
|
|
|
|
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.
|