• Modular Layouts
  • Grid layout
  • Linear layout
  • Minimap layout
• Mouse controls
  • Exit into workspace (hover, click)
  • Drag and drop windows
• Keyboard controls
  • Switch workspaces with direction
  • Switch workspaces with absolute number
• Multi-monitor support (tested)
• Monitor scaling support (tested)
• Animation support
• Configurability
  • Overview exit behavior
  • Number of visible workspaces
  • Custom workspace layouts
  • Toggle behavior
  • Toggle keybind
• Touch and gesture support
• Overview layers

hyprpm add https://github.com/raybbian/hyprtasking
hyprpm enable hyprtasking

Add hyprtasking to your flake inputs

# flake.nix
{
  inputs = {
    hyprland.url = "github:hyprwm/Hyprland/v0.49.0";

    hyprtasking = {
      url = "github:raybbian/hyprtasking";
      inputs.hyprland.follows = "hyprland";
    };
  };
  # ...
}

Include the plugin in the hyprland home manager options

# home.nix
{ inputs, ... }:
{
  wayland.windowManager.hyprland = {
    plugins = [
      inputs.hyprtasking.packages.${pkgs.system}.hyprtasking
    ];
  }
}

To build, have hyprland headers installed on the system and then:

meson setup build
cd build && meson compile

Then use hyprctl plugin load to load the absolute path to the .so file.

• Bind hyprtasking:toggle, all to a keybind to open/close the overlay on all monitors.
• Bind hyprtasking:toggle, cursor to a keybind to open the overlay on one monitor and close on all monitors.
• Swipe up/down on a touchpad device to open/close the overlay on one monitor.
• See below for configuration options.

• Workspace Transitioning:
  • Open the overlay, then use right click to switch to a workspace
  • Use the directional dispatchers hyprtasking:move to switch to a workspace
• Window management:
  • Left click to drag and drop windows around

Example below:

bind = SUPER, tab, hyprtasking:toggle, cursor
bind = SUPER, space, hyprtasking:toggle, all
# NOTE: the lack of a comma after hyprtasking:toggle!
bind = , escape, hyprtasking:if_active, hyprtasking:toggle cursor


bind = SUPER, X, hyprtasking:killhovered

bind = SUPER, H, hyprtasking:move, left
bind = SUPER, J, hyprtasking:move, down
bind = SUPER, K, hyprtasking:move, up
bind = SUPER, L, hyprtasking:move, right

plugin {
    hyprtasking {
        layout = grid

        gap_size = 20
        bg_color = 0xff26233a
        border_size = 4
        exit_on_hovered = false

        gestures {
            enabled = true
            move_fingers = 3
            move_distance = 300
            open_fingers = 4
            open_distance = 300
            open_positive = true
        }

        grid {
            rows = 3
            cols = 3
            loop = false
            gaps_use_aspect_ratio = false
        }

        linear {
            height = 400
            scroll_speed = 1.0
            blur = false
        }
    }
}

• hyprtasking:if_active, ARG takes in a dispatch command (one that would be used after hyprctl dispatch ...) that will be dispatched only if the cursor overview is active.

  • Allows you to use e.g. escape to close the overview when it is active. See the example config for more info.

• hyprtasking:if_not_active, ARG same as above, but if the overview is not active.

• hyprtasking:toggle, ARG takes in 1 argument that is either cursor or all

  • if the argument is all, then
    • if all overviews are hidden, then all overviews will be shown
    • otherwise all overviews will be hidden
  • if the argument is cursor, then
    • if current monitor's overview is hidden, then it will be shown
    • otherwise all overviews will be hidden

• hyprtasking:move, ARG takes in 1 argument that is one of up, down, left, right

  • when dispatched, hyprtasking will switch workspaces with a nice animation

• hyprtasking:movewindow, ARG takes in 1 argument that is one of up, down, left, right

  • when dispatched, hyprtasking will 1. move the hovered window to the workspace in the given direction relative to the window, and 2. switch to that workspace.

• hyprtasking:killhovered behaves similarly to the standard killactive dispatcher with focus on hover

  • when dispatched, hyprtasking will the currently hovered window, useful when the overview is active.
  • this dispatcher is designed to replace killactive, it will work even when the overview is not active.

All options should are prefixed with plugin:hyprtasking:.