• v0.2.2 e4f66fe630

    v0.2.2 Stable

    cosmo released this 2026-10-31 07:30:46 +01:00 | 0 commits to main since this release

    Floating popups stay floating

    • Windows that open fixed-size (can't be resized or maximized) or always on top no longer get a stage. They show over whatever stage is up, don't switch or hide anything, and stay put when you switch stages. That fixes 1Password Quick Access sending your current stage to the strip; it's a plain normal window whose only tell is its fixed size. Picture-in-picture windows and similar prompts are covered too.
    • If such a window sits over the strip, the strip slides out of its way.
    • New setting Keep fixed-size and always-on-top windows floating (on by default). Turn it off if an app whose main window is fixed-size should get its own stage.

    Upgrade

    • Arch: makepkg -si with the updated PKGBUILD, then log out and back in.
    • Otherwise: kpackagetool6 --type=KWin/Script -u kwin-stage-manager-0.2.2.tar.gz, then log out and back in.

    Tested on KWin 6.8.2.

    Downloads
  • v0.2.1 8ec34826e7

    v0.2.1 Stable

    cosmo released this 2026-10-31 07:15:41 +01:00 | 1 commits to main since this release

    Menus and popups now go on top of the strip

    • When the KDE menu, a context menu, a tooltip, a notification or an on-screen display opens over the strip, the strip slides away within about 90 ms and returns once it closes.
    • Hovering the screen edge doesn't peek the strip in while a menu is open.
    • A dialog from the current stage that sits over the strip now counts as covering it.

    KWin keeps windows created by scripts in its top layer: the "stay on bottom" flag and keepBelow are both ignored. So the strip moves out of the way instead of sitting under the menu.

    Upgrade

    • Arch: makepkg -si with the updated PKGBUILD, then log out and back in.
    • Otherwise: kpackagetool6 --type=KWin/Script -u kwin-stage-manager-0.2.1.tar.gz, then log out and back in.

    Tested on KWin 6.8.2.

    Downloads
  • v0.2.0 92e54e63a8

    v0.2.0 Stable

    cosmo released this 2026-10-31 06:39:40 +01:00 | 2 commits to main since this release

    Fixes

    • The strip no longer takes focus or disappears when you click back into a window. It had been created as a tool window, which KWin treats as a popup.

    New

    • The strip only slides away while a window covers it. It leaves a thin handle at the screen edge; hover there to peek it back in. Windows you move over the strip yourself stay where you put them.
    • Animations: the strip slides in and out, a stage you pick flies out toward the screen, and the stage you leave flies into the strip.
    • Drag to group: the thumbnail follows the pointer anywhere on screen. Release it over the highlighted drop zone to add its windows to the current stage, or over the strip to cancel.
    • Clicking the desktop sends the current stage to the strip.

    Upgrade

    • Arch: makepkg -si with the updated PKGBUILD, then log out and back in. KWin keeps the old QML in memory, so turning the script off and on isn't enough.
    • Otherwise: kpackagetool6 --type=KWin/Script -u kwin-stage-manager-0.2.0.tar.gz, then log out and back in.

    Tested on KWin 6.8.2.

    Downloads
  • v0.1.1 4de94fd3d1

    v0.1.1 Stable

    cosmo released this 2026-10-31 06:08:52 +01:00 | 3 commits to main since this release

    Fixes the script not loading on KWin 6.8. Nothing happened after enabling it.

    KWin 6.8 added its own Window type to org.kde.kwin. It hid QtQuick's Window in the strip component, so the whole script failed to load with StripWindow.qml: Type cannot be created in QML. QtQuick's Window is now imported under a qualifier.

    Tested on KWin 6.7.5 and 6.8.2.

    Upgrade

    • Arch: makepkg -si with the updated PKGBUILD, then turn the script off and on again (or log out and back in).
    • Otherwise: kpackagetool6 --type=KWin/Script -u kwin-stage-manager-0.1.1.tar.gz
    Downloads
  • v0.1.0 2a95599484

    v0.1.0 Stable

    cosmo released this 2026-10-31 05:44:28 +01:00 | 4 commits to main since this release

    First release of Stage Manager for KWin 6 on Plasma Wayland. Only one stage (a group of windows) is on screen at a time. The other stages appear as live thumbnails in a strip on the left edge.

    Install

    • Arch: build with the included PKGBUILD (makepkg -si).
    • Any distro: kpackagetool6 --type=KWin/Script -i kwin-stage-manager-0.1.0.tar.gz, then turn it on under System Settings → Window Management → KWin Scripts.

    Features

    • Stages per output and virtual desktop, with a live thumbnail strip (stacked thumbnails for stages with several windows).
    • Switches stage automatically when a hidden window gets focus (Alt+Tab, taskbar, notifications).
    • Hides windows by minimizing them or by moving them to a hidden virtual desktop.
    • Grouping shortcuts, plus drag-to-merge from the strip. Grouped apps are remembered by window class.
    • Maximized and tiled windows are shrunk or shifted to leave room for the strip.

    Tested against KWin 6.7.5. See the README for shortcuts, settings, debugging and known limitations.

    Downloads