# 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:**
```bash
qs -c noctalia-shell ipc call plugin:workspace-overview toggle
```

#### Hyprland Keybind Example
Add the following to your `hyprland.conf`:
```bash
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