PlasmaZones 2.5.0

35 changes, released March 30, 2026.

Added

  • Scripted tiling algorithms: All 24 tiling algorithms are now JavaScript, running in a sandboxed QJSEngine with hot-reload. The 14 former C++ algorithms have been converted to JS with identical behavior. Nine new algorithms added: Corner Master, Deck, Floating Center, Focus Sidebar, Horizontal Deck, Paper, Quadrant Priority, Tatami, and Zen, alongside Dwindle (Memory) below. Custom user algorithms are loaded from ~/.local/share/plasmazones/algorithms/. (#256, #259)
  • Dwindle (Memory) algorithm: Dwindle variant with a persistent split tree, where resizing one tile does not affect others. Split positions survive window close/reopen.
  • Multi-compositor support: Custom pz-layer-shell QPA plugin replaces the LayerShellQt dependency, so the overlays need only the zwlr_layer_shell_v1 protocol, which compositors such as Hyprland, Sway, Wayfire, niri, COSMIC, river, and labwc also provide. Window placement still runs through the KWin effect, so PlasmaZones itself still needs KWin. (#261)
  • Vulkan rendering backend: Optional Vulkan backend for zone overlay rendering with automatic fallback to OpenGL on unsupported hardware or driver crash. User-selectable in Settings → General. (#264)
  • New Layout / New Algorithm wizards: Guided dialogs for creating zone layouts from templates and tiling algorithms from a starter script, accessible from the settings app. (#263)
  • Layout filter bar: Replace hardcoded layout groups with configurable group-by, sort-by, and filter controls in the layout list. (#265)
  • Disable per virtual desktop / activity: Disable PlasmaZones on specific virtual desktops or activities per screen. Overlay hides automatically on disabled contexts. (#260)
  • Settings UX polish: Two-line description rows, collapsible card sections, consolidated footer bar with Apply/Reset/Defaults, sidebar page badges, inline toggle switches replacing disable checkboxes. (#269)
  • Single-instance settings app: plasmazones-settings is now single-instance via D-Bus. Launching it again raises the existing window and navigates to the requested page (--page <name> / -p <name>). (#270)
  • Unsaved changes confirmation: Settings app prompts before closing with unsaved changes. Reset and Defaults buttons require confirmation.
  • Master indicator dots: Algorithm grid cards show dots indicating which zones are master positions.
  • Memory indicator icon: Stateful algorithms (Dwindle Memory) show a persistence icon in the algorithm selector.
  • Per-algorithm settings storage: Split ratio, master count, and other parameters are saved per-algorithm rather than globally.
  • Algorithm import and open folder: Import .js algorithm files and open the user algorithm directory from the tiling settings page.
  • Algorithm capability grouping: Tiling algorithms grouped by capability (Built-in / Extras / Custom) in the settings UI.
  • D-Bus zoneIds array: Window state responses now include the full list of zone IDs a window occupies.

Changed

  • Config keys centralized: All config group names and key strings extracted to ConfigDefaults accessors. No more inline string literals in settings code. (#266)
  • Settings page IDs renamed: snap-* / tile-* page IDs renamed to snapping-* / tiling-* for consistency.
  • Algorithm registry: Hardcoded algorithm ID constants replaced with a data-driven registry. Algorithm metadata (name, capabilities, flags) comes from JS @tag annotations.
  • Aspect ratio menu: Replace flat menu items with nested submenu for aspect ratio presets.
  • Build dependencies for packagers: Drop layer-shell-qt / liblayershellqtinterface-dev, add qt6-wayland / qt6-wayland-dev, add wayland-scanner (usually in wayland-devel), and add vulkan-headers and vulkan-loader (optional, for the Vulkan backend).

Removed

  • C++ tiling algorithm implementations: All algorithms are now JavaScript. The C++ implementations have been removed.
  • Legacy migration code: Removed all config key migration and backward-compatibility shims from settings save/load paths.
  • kcfg/kcfgc schema files: Unused KConfig schema files removed.

Fixed

  • Window restore on daemon restart: Bypass QSettings cache in loadState so window-to-zone mappings are read fresh from disk after daemon restart. (#268)
  • Multipass shader rendering: Fix ping-pong buffer handling in overlay renderer for multi-pass shaders.
  • Editor shader menu crash: Rewrite shader submenu to prevent Qt 6 finalizeExitTransition use-after-free when selecting a shader while the menu is animating closed.
  • NVIDIA Vulkan crash: Suppress spurious shutdown crash on NVIDIA drivers and auto-fallback to OpenGL.
  • NVIDIA EGL crash in editor: Guard shader preview reload against EGL context loss on NVIDIA.
  • Layout picker dimmed backdrop: Remove unintended dimmed background overlay from the fullscreen layout picker.
  • CAVA crash suppression: Suppress misleading “CAVA Crashed” error message caused by process-group SIGTERM during daemon shutdown.
  • Shader preview bindings: Restore reactive label and wallpaper texture bindings in the editor shader preview.
  • Settings dirty flag on navigation: Prevent spurious unsaved-changes prompts when switching between settings pages.
  • Slider snap-back bug: Fix master count control snapping back to previous value, replacing SpinBox with SettingsSlider.
  • Layer-shell window recovery: Recover shader preview when the Wayland LayerSurface is unexpectedly destroyed.