Hyprspace

A plugin for Hyprland that implements a workspace overview feature similar to that of KDE Plasma, GNOME and macOS, aimed to provide a efficient way of workspace and window management.

Supports Hyprland release >= 0.39. All supported release versions will be pinned. New features and fixes will NOT be backported. Please report build issues on any supported release version.

Also checkout hyprexpo from the official plugin repo that provides a grid style overview!

demo.mp4

Jump to installation

Plugin Compatibility

hyprsplit (tested, explicit support)
hyprexpo (tested, minor bugs)
Any layout plugin (except ones that override Hyprland's workspace management)

Roadmap

Installation

Manual

To build, have hyprland headers installed and under the repo directory do:

make all

Then use hyprctl plugin load followed by the absolute path to the .so file to load, you could add this to your exec-once to load the plugin on startup

Hyprpm

hyprpm add https://github.com/KZDKM/Hyprspace
hyprpm enable Hyprspace

Nix

Refer to the Hyprland wiki on plugins, but your flake might look like this:

{
  inputs = {
    # Hyprland is **such** eye candy
    hyprland = {
      type = "git";
      url = "https://github.com/hyprwm/Hyprland";
      submodules = true;
      inputs.nixpkgs.follows = "nixpkgs";
    };
    Hyprspace = {
      url = "github:KZDKM/Hyprspace";

      # Hyprspace uses latest Hyprland. We declare this to keep them in sync.
      inputs.hyprland.follows = "hyprland";
    };
  };

... # your normal setup with hyprland

  wayland.windowManager.hyprland.plugins = [
    # ... whatever
    inputs.Hyprspace.packages.${pkgs.system}.Hyprspace
  ];
}

Usage

Opening Overview

Bind the overview:toggle or perform a workspace swipe vertically would open / close the panel.

Interaction

Window management:
- Click on workspace to change to it
- Click on a window to drag it
- Drag a window into a workspace would move the window to the workspace
Exiting
- Click without dragging the window exits the overview
- Pressing ESC exits the overview
Navigating
- When there are many workspaces open, scroll / swipe on the panel to pan through opened workspaces

Configuration

Dispatchers

Use overview:toggle dispatcher to toggle workspace overview on current monitor
Use overview:close to close the overview on current monitor if opened
Use overview:open to open the overview on current monitor if closed
Adding the all argument to these dispatchers would toggle / open / close overview on all monitors

Styling

Colors

plugin:overview:panelColor
plugin:overview:panelBorderColor
plugin:overview:workspaceActiveBackground
plugin:overview:workspaceInactiveBackground
plugin:overview:workspaceActiveBorder
plugin:overview:workspaceInactiveBorder
plugin:overview:dragAlpha overrides the alpha of window when dragged in overview (0 - 1, 0 = transparent, 1 = opaque)
plugin:overview:disableBlur

Layout

plugin:overview:panelHeight
plugin:overview:panelBorderWidth
plugin:overview:onBottom whether if panel should be on bottom instead of top
plugin:overview:workspaceMargin spacing of workspaces with eachother and the edge of the panel
plugin:overview:reservedArea padding on top of the panel, for Macbook camera notch
plugin:overview:workspaceBorderSize
plugin:overview:centerAligned whether if workspaces should be aligned at the center (KDE / macOS style) or at the left (Windows style)
plugin:overview:hideBackgroundLayers do not draw background and bottom layers in overview
plugin:overview:hideTopLayers do not draw top layers in overview
plugin:overview:hideOverlayLayers do not draw overlay layers in overview
plugin:overview:hideRealLayers whether to hide layers in actual workspace
plugin:overview:drawActiveWorkspace draw the active workspace in overview as-is
plugin:overview:overrideGaps whether if overview should override the layout gaps in the current workspace using the following values
plugin:overview:gapsIn
plugin:overview:gapsOut
plugin:overview:affectStrut whether the panel should push window aside, disabling this option also disables overrideGaps

Animation

The panel uses the windows curve for a slide-in animation
Use plugin:overview:overrideAnimSpeed to override the animation speed

Behaviors

plugin:overview:autoDrag mouse click always drags window when overview is open
plugin:overview:autoScroll mouse scroll on active workspace area always switch workspace
plugin:overview:exitOnClick mouse click without dragging exits overview
plugin:overview:switchOnDrop switch to the workspace when a window is droppped into it
plugin:overview:exitOnSwitch overview exits when overview is switched by clicking on workspace view or by switchOnDrop
plugin:overview:showNewWorkspace add a new empty workspace at the end of workspaces view
plugin:overview:showEmptyWorkspace show empty workspaces that are inbetween non-empty workspaces
plugin:overview:showSpecialWorkspace defaults to false
plugin:overview:disableGestures
plugin:overview:reverseSwipe reverses the direction of swipe gesture, for macOS peeps?
Touchpad gesture behavior follows Hyprland workspace swipe behavior
- gestures:workspace_swipe_fingers
- gestures:workspace_swipe_cancel_ratio
- gestures:workspace_swipe_min_speed_to_force