Domipoke
43 lines
1.5 KiB
Markdown
43 lines
1.5 KiB
Markdown
# 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
|