ScrollOverview is an overview plugin like niri.

1. Add the plugin repository:

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

2. Build and fetch dependencies:

   hyprpm update

3. Enable the plugin:

   hyprpm enable scrolloverview

4. Configure and Enjoy.

# .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
        wallpaper = 0 # 0: global only, 1: per-workspace only, 2: both
        blur = false # blur only the main overview wallpaper

        shadow {
            enabled = false
            range = 50
            render_power = 3
            color = rgba(1a1a1aee)
        }
    }
}

-- .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,
            wallpaper = 0, -- 0: global only, 1: per-workspace only, 2: both
            blur = false, -- blur only the main overview wallpaper

            shadow = {
                enabled = false,
                range = 50,
                render_power = 3,
                color = 0xee1a1a1a,
            },
        },
    },
})

In Lua, shadow.color must be an integer color value. The Hyprlang-only rgba(...) syntax is not accepted there.

Controls the shadow around each workspace card. enabled defaults to false; all other unset values fall back to decoration:shadow:*.

# hyprland.conf
bind = MODIFIER, KEY, scrolloverview:overview, OPTION

Example:

# This will toggle ScrollOverview when SUPER+g is pressed
bind = SUPER, g, scrolloverview:overview, toggle

-- hyprland.lua
hl.bind("SUPER + g", function()
    hl.plugin.scrolloverview.overview("toggle")
end)

hl.plugin.scrolloverview.overview("toggle") returns a dispatcher function accepted by hl.dispatch() and binds. When called from inside a Lua keybind callback, it dispatches immediately.

Here are a list of options you can use:

• hyprbars