Back to plugins
Workspace Overview for Hyprland

Workspace Overview for Hyprland

Workspace overview with live window previews and wallpaper backgrounds for Hyprland.

v1.0.2 doughbran MIT Mar 29, 2026

About

Workspace Overview Plugin for Noctalia

A visually stunning workspace overview with real-time window previews and wallpaper integration, designed perfectly for Hyprland and Noctalia Shell.

✨ Features

  • Panoramic View: A balanced 3-column grid that fills your panel with a professional, symmetrical layout.
  • Live Previews: Real-time rendering of all your open windows using ScreencopyView.
  • Dynamic Sizing: The panel height automatically adjusts to the number of active workspaces.
  • Wallpaper Backgrounds: Automatically pulls your desktop wallpaper to show "life" in every workspace preview.
  • Drag & Drop: Effortlessly move windows between workspaces by dragging their previews.
  • Clean Aesthetic: No visible scrollbars—just your windows and your work.

Installation

Ensure you have the plugin files in: ~/.config/noctalia/plugins/workspace-overview/

Usage

Via Bar Widget

Add the "Workspace Overview" widget to your Noctalia bar.

Via IPC (Keybindings)

You can toggle the overview using the Noctalia IPC interface. This is ideal for assigning to a keyboard shortcut.

Command:

qs -c noctalia-shell ipc call plugin:workspace-overview toggle

Hyprland Keybind Example

Add the following to your hyprland.conf:

bind = SUPER, TAB, exec, qs -c noctalia-shell ipc call plugin:workspace-overview toggle

Requirements

  • Noctalia Shell: 3.6.0 or later
  • Hyprland: For workspace and window tracking
  • Quickshell: The framework powering Noctalia