57 lines
3.4 KiB
Markdown
57 lines
3.4 KiB
Markdown
# Panel Actions
|
|
|
|
Configurable scroll actions across Plasma panels, with optional empty-space
|
|
click actions. Starts automatically at login, without adding a visible widget.
|
|
Open **Panel Actions** from the application menu, Fedora Tools settings, or run
|
|
`plasma-panel-actions --settings`. Settings apply to all panels and are stored
|
|
in `~/.config/plasma-panel-actionsrc`; saved changes apply immediately.
|
|
|
|
Log out and back in after installing or updating. This starts the session
|
|
helper and ensures Plasma loads the installed version of the native plugin.
|
|
|
|
Scroll areas are empty space, task buttons and pinned apps, the application
|
|
launcher, clock, system tray, and other widgets. All default to volume control.
|
|
Other choices are screen brightness, keyboard backlight, virtual desktops, and
|
|
normal widget behaviour. Actions use Plasma's existing shortcuts, including its
|
|
usual volume/brightness steps and on-screen indicators.
|
|
|
|
Clicks and scrolling use Plasma's panel content boundaries and live theme
|
|
padding. Outer-margin input belongs to the same widget as a normal panel click,
|
|
including the launcher at a screen corner. Interior gaps, explicit spacers and
|
|
unused Task Manager space remain empty. Widget clicks pass through to Plasma;
|
|
no synthetic clicks or fixed area-expansion offsets are used.
|
|
|
|
Left and middle clicks, and double clicks, on empty space can toggle mute, show
|
|
the desktop, open Overview, play/pause media, launch an installed application,
|
|
or run a custom shell command as the current user. All default to normal
|
|
behaviour. Commands are user-authored shell code: only enter commands you trust.
|
|
For a task-manager shortcut, set left double click to **Launch application →
|
|
System Monitor** (if installed). Other widgets'
|
|
clicks, right-click menus, and popup scrolling remain unchanged. Dragging does
|
|
not trigger a click action, and overrides pause in Panel Edit Mode.
|
|
|
|
Double clicks use the desktop's timing and movement tolerance. Assigning a
|
|
double-click action delays the corresponding single action until the interval
|
|
expires; a double click runs only the double action. With single click set to
|
|
Normal behaviour and a double action assigned, a single click does nothing.
|
|
|
|
Optionally add **Panel Actions Spacer** from the widget chooser to reserve
|
|
empty space. It expands into remaining space while giving other widgets their
|
|
preferred width, down to a configurable minimum (48 logical pixels by default).
|
|
Move it in Panel Edit Mode like any other widget. It is transparent outside
|
|
Edit Mode, with no icon or popup. Standard spacers and unused Task Manager
|
|
space also count as empty space; the optional spacer is not required for them.
|
|
|
|
The session helper attaches an invisible controller to each panel and restores
|
|
it after Plasma restarts or panels are added. It watches for changes, rather
|
|
than polling. The controller handles panel input inside Plasma, leaving popup
|
|
and application windows alone. No system files are patched.
|
|
|
|
Requires Plasma 6.7 and Qt 6.8 or newer. Area detection follows Plasma's panel
|
|
layout and Task Manager delegates; changes to those internals may require an
|
|
update. Brightness actions depend on hardware support. Firmware-controlled
|
|
keyboard-backlight Auto modes can override manual adjustments; select a fixed
|
|
level with the keyboard first. Virtual desktop actions
|
|
need more than one desktop. Horizontal scrolling is consumed without an action
|
|
in areas with an override. Smooth scrolling is accumulated into discrete steps.
|