osfeed.dev
Projects/gen3vra / hyprwinwrap

hyprwinwrap

A Hyprland plugin that shows any window as your wallpaper

Get it on GitHub
Unclaimed

Written by @iluxav from the project's code and releases, not by its maintainers. Last updated for 0.56v3 (2026-10-15), so it may lag behind newer releases.

Are you @gen3vra?Claim it, and your coding agent keeps it current with each release
0.56v3 · 2 things you can do 36 stars 2 changes to know before upgrading

Pin any app window, such as a terminal running cava or a video, behind your other windows as a desktop background on Hyprland.

What you can do with hyprwinwrap

Show a chosen app window as the desktop background, behind all other windows.

Since 0.55v2
Good to know

Several windows and layers need the Lua config; the hyprlang block handles one window. Class and title are exact matches.

Share
Wrong?

Before you upgrade hyprwinwrap

Newest first
0.56v3

Global and non-override opacity rules and `decoration:inactive_opacity` are ignored. Use Lua `opacity` (highest priority) or an opacity rule with `override`; otherwise backgrounds are fully opaque. The same opacity applies while interactive.

Behavior changedAffects: Background windows, including while toggled interactive.
Read the evidence
Share
Wrong?
hyprwinwrap release history 6
0.56v3

Place a background window on a chosen monitor.

Details

Lua `hl.plugin.hyprwinwrap.window()` accepts `monitor` (a name or selector) and `opacity` (0–1). Reloading config reapplies geometry, layer order and opacity to existing matched background windows; normal opacity rules are ignored in favor of explicit settings or override rules.

Also: Set per-window opacity, keep it while interacting, and apply geometry, layer and opacity edits on config reload.

Tag `0.56v3`, installed through `hyprpm`; its updated plugin build is pinned for Hyprland 0.56.0–0.56.2. The new fields use Lua configuration.

Improved / inferred: Show a chosen app window as the desktop background,…Behavior changed

Seeded by @iluxav with Codex

Read the evidence
0.56v2

Size and place background windows to the exact pixel with fractional percentages or Lua math.

Details

Positions and sizes are no longer rounded, so values such as size_y = 100 * 1050 / 1080 land on an exact pixel. A failed window rule now shows a Hyprland notification. hyprpm.toml pins this build for Hyprland 0.56.0 to 0.56.2.

0.56v2; Hyprland 0.56.0 to 0.56.2.

Improved: Show a chosen app window as the desktop background,…

Seeded by @iluxav with Claude Code

Read the evidence
0.56

Keep a window as your background after upgrading to Hyprland 0.56.

Details

Builds against Hyprland 0.56.0. A background window no longer flashes when it closes.

0.56; for Hyprland 0.56.

Improved: Show a chosen app window as the desktop background,…

Seeded by @iluxav with Claude Code

Read the evidence
0.55v5

Save battery: the background stops drawing while a fullscreen window covers the monitor.

Details

The background window is no longer rendered when the workspace on that monitor has a fullscreen window. Windows that suspend when hidden, such as kitty, keep updating after a workspace change. Groups 0.55v4 and 0.55v5.

0.55v5; this build is pinned for Hyprland 0.55.0 to 0.55.4.

Improved / inferred: Show a chosen app window as the desktop background,…Now works: Show a chosen app window as the desktop background,…

Seeded by @iluxav with Claude Code

Read the evidence
0.55v3

Stack several windows as backgrounds, for example a visualizer over part of the screen on top of a full-screen one.

Correction: Only the hyprlang plugin { hyprwinwrap { ... } } config is deprecated; showing a window as the background is not. It works through hl.plugin.hyprwinwrap.window() in Lua.

Correction: Retyped from deprecated: only the hyprlang plugin config block was deprecated; background windows work through the Lua config.

Details

New Lua config: hl.plugin.hyprwinwrap.window({ class, title, layer, pos_x, pos_y, size_x, size_y }) can be called several times, and layer sets which one draws on top. The focus toggle is now hl.plugin.hyprwinwrap.focus("<title-or-class>").

0.55v3; the Lua config needs a Hyprland version with Lua configuration. The hyprlang plugin block still works but is marked deprecated.

Improved: Show a chosen app window as the desktop background,…Improved: Bring the background window forward to use it, then…Behavior changed: Show a chosen app window as the desktop background,…

Seeded by @iluxav with Claude Code

Read the evidence
0.55v2
First release

Show any window, such as a terminal running cava, as the desktop background on Hyprland.

Details

First releases (0.54, 0.55, 0.55v2). A plugin { hyprwinwrap { class, title, pos_x, pos_y, size_x, size_y } } block picks the window by exact class or title and places it behind everything, with position and size as percentages of the screen. The hyprwinwrap_interactivity dispatcher lets you focus and use that window.

Install with hyprpm add https://github.com/gen3vra/hyprwinwrap and hyprpm enable hyprwinwrap; needs Hyprland 0.54 or newer, with 0.55 supported from tag 0.55.

Added: Show a chosen app window as the desktop background,…Added: Bring the background window forward to use it, then…

Seeded by @iluxav with Claude Code

Read the evidence

Share

LinkedIn takes the link and its card only; write your text there.

X LinkedIn Reddit Hacker News Bluesky