A KDE Plasma 6 panel widget to scroll the Karousel tiling grid, Pager style.
friimaind-karousel-scroller-demo-small.webm
| Control | Action |
|---|---|
| Left / right arrow click | Scroll left / right (hold to keep scrolling) |
| Center dot click | Center the focused window |
| Mouse wheel down / up | Scroll left / right |
Compact mode (optional): a single icon. The mouse wheel scrolls, a click centers the focused window. The icon can be replaced with any icon from your theme or an image file (PNG, SVG).
Settings: scroll speed multiplier (default 1.0, range 0.1 to 10). It sets how many Karousel
scroll steps are triggered per wheel notch or per click. The size of a single step is Karousel's own
"manual scroll step" setting. The mouse wheel direction can be inverted (arrow buttons are not affected).
The widget length (along the panel, 25% to 400%) and thickness (across the panel, 30% to 100%) are
configurable. The button background can be hidden so the widget looks like the other panel icons.
- KDE Plasma 6
- Karousel installed and enabled as a KWin script
From the KDE Store: right click on the panel > Add Widgets > Get New Widgets, search for "Karousel Scroller".
From a release: download the .plasmoid file from the
releases page, then:
kpackagetool6 -t Plasma/Applet -i karousel-scroller-<version>.plasmoid
From source:
git clone https://github.com/friimaind/karousel-scroller.git
kpackagetool6 -t Plasma/Applet -i karousel-scroller
The widget invokes Karousel's KWin global shortcuts over D-Bus (org.kde.kglobalaccel):
karousel-grid-scroll-leftkarousel-grid-scroll-rightkarousel-grid-scroll-focused
If the widget does nothing, check that Karousel responds to the same call:
dbus-send --session --type=method_call --dest=org.kde.kglobalaccel /component/kwin \
org.kde.kglobalaccel.Component.invokeShortcut string:karousel-grid-scroll-right
Update an installed copy after changing the code:
kpackagetool6 -t Plasma/Applet -u .
systemctl --user restart plasma-plasmashell
Run it in a standalone window to see QML errors:
plasmawindowed friimaind.karouselscroller
- Bump
KPlugin.Versioninmetadata.json. - Build the package:
./scripts/build-plasmoid.sh(output indist/). - Create a GitHub release and attach the
.plasmoidfile. - Upload the same
.plasmoidto the KDE Store product page.