Add Plasma task group shortcuts

README.md

@@ -16,6 +16,7 @@ sudo dnf config-manager addrepo \
 ```bash
 sudo dnf install touchpad-hold-tap
 sudo dnf install plasma-always-show-unlock
+sudo dnf install plasma-task-group-shortcuts
 ```
 
 ## Compatibility
@@ -48,3 +49,34 @@ 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 behavior.
+
+### 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.
+
+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.
+
+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
+```