ScrollOverview

ScrollOverview is an overview plugin like niri.

2026-07-31.17-08-43.mp4

Installation

Using Hyprpm (recommended)

1. Add the plugin repository:

   hyprpm add https://github.com/yayuuu/hyprland-scroll-overview.git

   If you use a Git build of Hyprland, add the plugin from the new-release branch instead:

   hyprpm add https://github.com/yayuuu/hyprland-scroll-overview origin/new-release

2. Build and fetch dependencies:

   hyprpm update

3. Enable the plugin:

   hyprpm enable scrolloverview

4. Configure and Enjoy.

For more installation methods, including building from source and loading the plugin automatically, see the Installation guide.

Configuration

Hyprlang

# .config/hypr/hyprland.conf
plugin {
    scrolloverview {
        gesture_distance = 300 # how far is the "max" for the gesture
        scale = 0.5 # preferred overview scale
        workspace_gap = 100
        layout = vertical # vertical, horizontal, or auto (per-monitor orientation)
        wallpaper = 2 # 0: global only, 1: per-workspace only, 2: both
        blur = true # blur only the main overview wallpaper

        shadow {
            enabled = true
            range = 50
        }
    }
}

# Toggle ScrollOverview with SUPER+g
bind = SUPER, g, scrolloverview:overview, "toggle all"

Lua

-- .config/hypr/hyprland.lua
hl.config({
    plugin = {
        scrolloverview = {
            gesture_distance = 300, -- how far is the "max" for the gesture
            scale = 0.5, -- preferred overview scale
            workspace_gap = 100,
            layout = "vertical", -- vertical, horizontal, or auto (per-monitor orientation)
            wallpaper = 2, -- 0: global only, 1: per-workspace only, 2: both
            blur = true, -- blur only the main overview wallpaper

            shadow = {
                enabled = true,
                range = 50,
            },
        },
    },
})

-- Toggle ScrollOverview with SUPER+g
hl.bind("SUPER + g", function()
    hl.plugin.scrolloverview.overview("toggle all")
end)

Set cross_monitor_drag = true to drag windows between monitors through ScrollOverview and adopt Hyprland move drags when another overview is open. It defaults to false. Native adoption uses Hyprland internals; if unavailable, overview-origin cross-monitor dragging still works.

This setting does not affect overview-origin drags with toggle all because every overview is already open. Existing multi-monitor commands remain available when it is disabled.

Documentation

The complete documentation is available in the ScrollOverview wiki. It covers all configuration options, keybinds, submaps, gestures, dispatchers, and advanced Lua examples.

Supported plugins

• hyprbars

Star History