PlasmaZones 3.1.0

56 changes, released June 23, 2026.

Added

  • Window Rules: a new unified settings page replaces the old Snapping Assignments, Tiling Assignments, Animations App Rules, and per-mode “disabled apps” lists. Rules are browsed, added, edited, drag-reordered, duplicated, and disabled from one place. Matching composes class, title, role, app-id, virtual desktop, activity, and screen predicates with AND/OR/NOT. A rule’s actions cover snapping/tiling assignment, animation-curve and shader overrides, and exclusion from snapping, autotile, and effects. Those four surfaces previously each had their own editor. (#477, #531, #547)
  • org.plasmazones.WindowRules D-Bus interface: dbus/org.plasmazones.WindowRules.xml provides getAllRules, setAllRules, addRule, removeRule, and related lifecycle methods for programmatic rule management. (#477)
  • phosphor-window-rules library: a new LGPL-2.1+ library holds the rule model, parser, and RuleEvaluator, so third parties can link the matcher without inheriting GPL. (#477, #635)
  • Snapping focus behavior: two new opt-in toggles on Settings → Placement → Snapping → Window → Behavior (both default off). focus new windows auto-activates a window when it is auto-placed into a zone on open, and focus follows mouse activates the snapped window under the cursor. This brings snapping to parity with the existing autotile focus options. (#598)
  • Zone span toggle mode: an opt-in switch in the Zone Span card so the span modifier can be tapped to start/stop spanning instead of held down for the whole drag (default off, motivated by accessibility). (#595, #563)
  • Restore floated window positions on login: floated windows are now restored to the monitor and position they closed on after a KWin session restore (previously only snapped windows were restored cross-screen). Parallel per-engine toggles (both default on), restore unsnapped windows under Settings → Placement → Snapping → Window → Behavior and restore untiled windows under Settings → Placement → Tiling → Window → Behavior, plus an engine-neutral per-window RestorePosition rule action let specific windows opt in or out for either mode. (#606)
  • Per-window appearance for snapping: snapping gains its own border, corner-radius, hide-title-bar, and accent-color settings on the Settings → Placement → Snapping → Window → Appearance page, mirroring tiling. (#551)
  • New window-rule actions for window chrome: per-window border, title-bar, corner-radius, accent-color, gap/padding, and opacity overrides, applied to snapped or floating windows (e.g., “floating windows on monitor 2 → no title bar + red border”, “activity Gaming → zero gaps”). (#562, #571)
  • New window-rule match conditions: IsTransient, IsNotification, Width, Height, and IsFocused, plus a built-in “Don’t animate small windows” template. IsFocused lets any action be focus-scoped (e.g., “WHEN NOT focused → dim”). (#574, #602)
  • Collapsible settings sidebar categories: the active page’s category expands on its own and the chevrons animate, cutting clicks to reach deep pages. (#526)
  • Per-monitor scope map: per-monitor settings cards carry a scope chip that opens a spatial map of the real monitor arrangement to switch outputs, replacing the tall repeated monitor-selector block. The scope choice persists across pages. (#590)
  • Shader-driven window-move/resize morph: with the new window-morph pack, window move, resize, snap, and layout-switch transitions animate as a smooth shader cross-fade geometry morph instead of a plain C++ paint transform, the default for window-move and overridable per event. Overlay show/hide (OSD, zone selector, layout picker, snap assist) now defaults to the shader-based fade effect. (#572, #573)
  • In-app live shader preview: the Settings → Placement → Snapping → Configuration → Shaders browser gains an animated, interactive preview with mouse and audio input, shader presets (load/save, shared with the editor), and an in-app compile-error banner. (#591)
  • Shader authoring API: authors write only the effect body and read parameters by name (p_<id>) instead of decoding UBO slots, with a generated preamble and entry-point conventions, plus a plasmazones-shader-validate CLI (with --animation and --overlay modes and did-you-mean diagnostics) wired into CI to catch broken packs offline. (#581, #589)
  • dma-buf zero-copy window-preview transport: snap-assist thumbnails can travel as zero-copy dma-buf buffers (opt-in via the PLASMAZONES_DMABUF_THUMBNAILS env var, with default builds unchanged), which lays the foundation for live window previews. (#564)
  • Phosphor SDK groundwork: the reusable LGPL Phosphor library line gains a Phase 1 foundation tier (phosphor-theme, phosphor-popout, phosphor-registry, and phosphor-ipc with the phosphorctl driver, plus a per-screen helper added to the existing phosphor-shell library) and a Phase 2 system-service tier (phosphor-service-{pipewire,network,bluetooth,brightness,notifications,polkit,idle,clipboard,lock,session,upower,mpris,icontheme,sni}). All of it is gated behind BUILD_PHOSPHOR_SHELL (default off) and drivable only from standalone examples and CLIs. It is groundwork for the standalone Phosphor shell direction and is not part of the shipping PlasmaZones tiler. (#561, #682)
  • Resize-aware tiling: six split-ratio algorithms (master-stack, wide, focus-sidebar, zen, deck, and horizontal-deck) now reflow on interactive resize. Dragging the master or boundary edge updates the split ratio for that desktop the same way a master-ratio keystroke does, without bleeding into other screens or the global default. The Layouts page shows a per-algorithm Reflows badge and can group algorithms by it. (#666)
  • Aligned Grid tiling algorithm: a resize-aware grid that remembers the width of each column and the height of each row, so dragging the edge of one window moves that whole column or row across the grid. The plain Grid algorithm is unchanged. (#666, #652)
  • Suppress default layout assignment: a new setting, with a matching DefaultLayoutAssignment window-rule action, stops a context from falling back to the synthesized default layout. A suppressed context shows no snapping overlay or zone selector, reports no layout, and shows a “No layout assigned” OSD. Switching it into autotile sets the mode without applying the global default algorithm until a concrete one is assigned. (#676)
  • Layouts page rebuilt: the page is now a searchable, card-based catalog with collapsible capability groups, per-layout deep links, and global-search reveal, matching the shader browser and Window Rules. Tiling algorithms expose a Script State capability (filter, group-by, and a card badge) alongside the reflow and persistent-memory badges, layout and algorithm cards show their description on hover, and bundled snapping layouts open in a text editor. (#660, #670)
  • Grid-deformed window-move animations: four new window-move shaders, Flow, Fold, Ripple Snap, and Stretch, bend the window on a grid as it travels into its zone. (#680)
  • Premade Steam window rule: new installs and upgrades get a built-in rule that excludes Steam’s Friends List, Settings, chat, and notification windows, so they stop breaking the tiling. The main Steam window still tiles. (#604)
  • Lock layout rule action: a rule can lock the active layout of a screen, desktop, or activity, the same lock the layout lock shortcut sets. (#614)
  • Snap to zone rule action: a rule can snap a matched window into one or more zones when it opens, and several zones snap it to their combined area. (#647, #646)
  • Focus, move, and swap across monitors and desktops: directional focus, move, and swap now pick the window that is actually in that direction. At the edge of a layout they continue onto the neighboring monitor, or onto the neighboring virtual desktop when there is no monitor that way, in both snapping and tiling. (#618)

Changed

  • Single rule format: window assignments, per-mode disable lists, animation App Rules, and effect exclusion lists are unified into one rule list stored in ~/.config/plasmazones/windowrules.json. The KWin effect now consults the same RuleEvaluator as the daemon for animation App-Rule resolution and exclusion checks, so the two cannot drift. (#477, #531)
  • org.plasmazones.WindowTracking.setWindowMetadata widened: the method grows from 4 to 10 arguments to carry the additional fields the evaluator needs (role, process id, virtual desktop, activity, window type, and a map of extended properties). The KWin effect and daemon must be installed and running as a matched pair. MinPeerApiVersion bumped 3 → 4, and either side refuses to register a mismatched peer rather than silently degrading. Packagers must rebuild and ship both binaries together. (#477)
  • org.plasmazones.LayoutRegistry.assignmentChangesApplied signal changed: it dropped its second argument (the per-key field tag). Subscribers that depended on that field must update or they will receive the wrong arity. (#477)
  • Scripted autotiling moved from QJSEngine (JavaScript) to an embedded, sandboxed Luau VM: the VM lives in the new phosphor-scripting library. The 25 bundled algorithms were ported *.js → *.luau, written against a new frozen pluau standard library, with a per-engine CPU-time watchdog and a 64 MiB heap cap. The TilingAlgorithm contract, daemon, editor, and settings are unchanged. Breaking for custom algorithms: the loader now discovers only *.luau files, so user scripts in ~/.local/share/plasmazones/algorithms/ written in the old JavaScript form are no longer loaded and must be rewritten in Luau (see the Luau algorithm authoring guide). (#553)
  • Snapping and Tiling settings aligned for parity: Tiling gains a dedicated Focus card. Section and label naming is unified across both modes (“Inner gap” and “Outer gap”, “Window Handling”, parallel quick-shortcut labels), and the placement settings are reorganized into a consistent Overlay, Window, and Configuration shape with gaps moved into Window → Appearance and per-monitor gap selectors. User settings are preserved. (#560, #601)
  • Performance: daemon peak heap is down ~58% (149 → 63 MB) and idle CPU drops from ~25% to ~0. The overlay and snap-assist release their full-screen image buffers when dismissed (≈33 MB per shader-enabled 4K screen, ≈6 MB of thumbnail cache), and a content-addressed on-disk shader cache speeds warm launches. Settings pages that were slow on first visit now open fast via a page-instance cache, background compile-warming, and viewport virtualization of the animation-event card lists. (#559, #594, #605)
  • Settings app rebuilt on the reusable phosphor-control library: the library is extracted from the settings app’s own chrome, and the app now runs on it with no visible change. (#533, #607)
  • Nix flake restructured around a single package definition: LTO is now opt-in (enableLTO, default off) instead of forced, because every module and overlay consumer rebuilds against its host’s packages with no cache reuse. The NixOS module now declares the plasmazones systemd user service, with autostart opt-in (default off) so enabling it stays a per-user choice. (#530)
  • Autotiling is on by default: tiling now works out of the box so PlasmaZones behaves like a dynamic tiler with no setup. The companion behaviors (focus new windows, smart gaps, respect minimum size, exclude transient windows, and insert at the stack end) were already on by default, and the default algorithm (bsp) and gaps are unchanged. Only fresh installs are affected, and existing saved configs keep their current value. (#671)
  • Settings UI polish across the Layouts and listing pages: a curated default picker shows a starter set of layouts and algorithms with the rest one eye-toggle away, a shared filter menu now drives the Layouts, Window Rules, and Shaders lists, and the sidebar, global search field, About credits, and virtual-screen preview labels got alignment and spacing fixes. (#669, #671, #675)
  • Migration to config schema v4: on first launch after upgrade, ~/.config/plasmazones/assignments.json is automatically converted into ~/.config/plasmazones/windowrules.json, and the legacy Display.SnappingDisabled* and Display.AutotileDisabled* keys in config.json are folded into the same rule set. The migration is lossless and runs without user interaction. (#477)
  • Migration backout: the source file is renamed assignments.json.migrated (not deleted), so a downgrade can restore the previous schema by manually renaming it back and starting an older daemon. (#477)
  • Migration recovery: if migration aborts because the source is malformed, the original file is renamed to ~/.config/plasmazones/assignments.json.corrupt.bak, the schema version stays at v3, and windowrules.json is not created. The daemon does not silently flush the old assignments to an empty rule set. You can inspect or repair the quarantined file and rename it back to assignments.json, and the next launch then retries the v3→v4 conversion. (#477)
  • Per-layout settings move into a sidecar file: the v3→v4 conversion moves per-layout settings such as hiddenFromSelector out of the layout files into layout-settings.json. Autotile per-algorithm overrides also fold into layout-settings.json, and the standalone autotile-overrides.json is retired by a one-time self-deleting migration on load. (#667)

Removed

  • Legacy disable-list config keys: Display.SnappingDisabled* and Display.AutotileDisabled* are gone, and the migration folds their values into window rules. (#477)
  • QJSEngine-based scripted-tiling path: the ScriptedAlgorithm runtime, its JS builtins, and the bundled *.js algorithms are gone, along with the Qt6::Qml dependency in phosphor-tiles. The Luau path above replaces it. (#553)
  • Per-field assignment setters: setSnappingLayoutEntry, setTilingAlgorithmEntry, and related per-field Settings-side Q_INVOKABLEs that the legacy KCM Assignments pages used are removed. There is no QML replacement. Use the Window Rules page. (#477)
  • Legacy assignment and App Rules pages: the Snapping Assignments, Tiling Assignments, and Animations App Rules settings pages are replaced by Window Rules. (#477, #531)
  • Per-release plasmazones.nix asset and its generate-release-nix.sh generator: the asset was a source-pinned build recipe (not a binary), so it saved no build time and only served non-flake Nix users, who can instead build any tag against their host’s pkgs with pkgs.callPackage "${builtins.fetchTarball "https://github.com/phosphor-works/PlasmaZones/archive/v<VERSION>.tar.gz"}/packaging/nix/package.nix" { version = "<VERSION>"; }. The release notes’ standalone-install section now shows that form, and the build-nix release job is reduced to a nix build smoke gate. Flake users are unaffected. (#530)
  • Stray develop.nix: an unrelated development flake for another project that had no connection to PlasmaZones. The dev environment lives in the flake’s devShells.default. (#530)

Fixed

  • Layouts rendered stretched or ultrawide when editing on a 16:9 or 4K screen: the editor canvas used a fixed-zone bounding box as its aspect reference, so editing an existing layout could distort it while creating a new one rendered correctly. The canvas now references the live screen unless fixed zones genuinely overflow it. (#596, #593)
  • A zone-spanning window blew up to fullscreen when switching layouts: switching to a layout where the previously-spanned zones are non-contiguous (e.g., Grid 2×2 left column → Master+Stack) unioned them into a screen-sized bounding box. Non-contiguous mapped spans now collapse to the primary zone instead. (#575)
  • KWin effect plugin silently never installed under Nix: packaging/nix/package.nix set KDE_INSTALL_QTPLUGINDIR to an absolute path inside the read-only qtbase store output (${qt6.qtbase}/lib/qt6/plugins). A derivation may only write under its own $out, so the effect dropped out of the package closure entirely. The daemon ran but zone overlays never appeared on Nix installs. The plugin now installs into the package’s own $out/${qt6.qtbase.qtPluginPrefix} (the canonical NixOS lib/qt-6/plugins layout), where the running KWin discovers it via the system profile’s aggregated QT_PLUGIN_PATH. (#530)
  • Toggling from autotile back to snapping left windows stuck in their tiled positions: windows did not return to where they were before tiling, because the transition fell through to a stale resnap that re-pinned the tiled geometry. Windows now float back to their pre-tile positions. (#530)
  • Master-ratio and master-count adjustments bled into the global default: the increase/decrease ratio and master-count shortcuts wrote the new value into the global config whenever a screen had no per-screen override, so the tweak propagated to sibling screens and new states on the next algorithm switch or settings refresh. The adjustment now stays local to the active screen, desktop, and activity, and resets only on an algorithm switch or an explicit ratio/count change in settings. (#666)
  • Per-screen virtual desktops on Plasma 6.7: with Plasma 6.7’s option to switch desktops independently on each screen, moving the cursor between monitors on different desktops showed the desktop switch OSD on every screen and reloaded each screen’s layout and tiling state. PlasmaZones now follows each screen’s own desktop, so moving the cursor no longer triggers anything, and a real desktop switch updates only the screen that switched. (#651, #648)
  • Switching desktops scrambled windows on other desktops: with one desktop snapping and another tiling on the same screen, switching to the tiling desktop pulled the other desktop’s snapped windows into the tiling and overwrote their positions. Desktop switches now leave windows on other desktops alone. (#632)
  • Dialogs and popups skipped their open animation: transient windows played their close animation but never their open one, even with the exclude-transient-windows animation option off. They now animate on open as that option says. (#653)
  • Windows lost their snap state when the KWin effect restarted: an app that renamed its window class while the effect was restarting, as Electron and CEF apps do, lost its floating, zone, and sticky state until a mode toggle. That state now follows the window. (#650, #628)
  • Settings and editor crashed with some third-party Qt styles: with styles such as Darkly, the settings app and the layout editor crashed as soon as they opened. They now start normally. (#610, #262)
  • Focus follows mouse stole focus from the layout editor: moving the cursor over the full-screen editor activated the window underneath it. The editor now keeps focus. (#612)