hyprwinwrap

If you use Hyprland, you should check out hyprwinwrap.

hyprwinwrap allows specific application windows to be rendered behind the desktop as pinned background layers. Matching windows are intercepted by the plugin, converted into unmanaged floating surfaces, and rendered during Hyprland’s RENDER_POST_WALLPAPER stage.

What makes it interesting is that the “wallpaper” can now be an actual running application:

• mpv video wallpapers
• cava audio visualizers
• shader demos
• OpenGL scenes
• animated dashboards
• generative art renderers
• live telemetry panels

Installation:

hyprpm update && hyprpm add https://github.com/gen3vra/hyprwinwrap && hyprpm enable hyprwinwrap

Example configuration:

plugin {
    hyprwinwrap {
        class = window-bg
        title = window-bg
        # Position of the window in a percentage
        pos_x = 0
        pos_y = 0
        # Size of the window in a percentage
        size_x = 100
        size_y = 100
    }
}


exec-once = foot --app-id=window-bg sh -c "cmatrix"

The application itself defines the window class or app-id, and hyprwinwrap simply matches against it. The plugin also supports percentage based sizing and positioning, allowing background windows to occupy arbitrary regions of the screen instead of acting only as fullscreen wallpapers.

If a program’s background is transparent, it will appear layered above your wallpaper:

exec-once = foot -o colors-dark.alpha=0.0 --app-id=window-bg sh -c "cmatrix"

https://github.com/gen3vra/hyprwinwrap


It helps me if you share this post
https://rose.dev/blog/2026/05/24/hyprwinwrap/

Published 2026-05-24 09:35:24

Leave a Reply

Your email address will not be published. Required fields are marked *