Skip to content

DigitalBastion/hyprland-scroll-overview

 
 

Repository files navigation

ScrollOverview

ScrollOverview is an overview plugin like niri.

2026-04-19.02-11-57.mp4

Installation

Using Hyprpm (recommended)

  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

A great start to configure this plugin would be adding this code to the plugin section of your hyprland configuration file:

# .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)
        }
    }
}

Properties

property type description default
gesture_distance number how far is the max for the gesture 300
scale float overview scale, [0.1 - 0.9] 0.5
workspace_gap number gap between visible workspaces in the overview, in pixels 0
wallpaper int wallpaper mode: 0 global only, 1 per-workspace only, 2 both 0
blur bool blur the main overview wallpaper without blurring workspace wallpapers false

Subcategory shadow

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

property type description default
enabled bool draw a shadow around each workspace card false
range int shadow range in layout px decoration:shadow:range
render_power int shadow falloff power decoration:shadow:render_power
ignore_window bool draw only around the workspace card, not behind its rectangle decoration:shadow:ignore_window
color color shadow color decoration:shadow:color

Keywords

name description arguments
scrolloverview-gesture same as gesture, but for ScrollOverview gestures. Supports: overview. Same as gesture

Binding

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

Example:

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

Here are a list of options you can use:

option description
toggle displays if hidden, hide if displayed
select selects the hovered desktop
off hides the overview
disable same as off
on displays the overview
enable same as on

Supported plugins

  • hyprbars

About

Scroll overview plugin, just like niri. Based on scroll-overview branch of hyprexpo.

Resources

License

Stars

1 star

Watchers

0 watching

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages

  • C++ 98.9%
  • Other 1.1%