Hypr-DarkWindow

Hyprland plugin that adds the possibility to modify the fragment shader of specific windows.

Important

The main branch is always™ up to date with Hyprlands main branch, if you are using a release version of Hyprland check the Readme of the specific tag.

Shaders

Note

You can only have one shader applied at the same time. Applying a shader to a window which already has one applied will override the first one. Shaders that were applied using a dispatcher take priority over windowrule shaders.

There are few shaders already included in this plugin. All of them get loaded with the plugin, if you want to only load specific ones you can limit the shaders that are loaded.

plugin:darkwindow:load_shaders = invert,tint # defaults to 'all'
plugin:darkwindow:load_shaders = # dont load any default shaders

Name	Description
invert	No uniforms Applies smart color inversion
tint	tintStrength = float (0-1) tintColor = vec3 Tints the Window
chromakey	bkg = vec3 The background color of the Window similarity = float How many similar colors should be affected amount = float How much similar colors should be changed targetOpacity = float Target opacity for similar colors Applies opacity changes to pixels similar to one color

If you want to use your own Shaders, check this out.

Configuration

Important

BREAKING:

• WindowRules invertwindow and shadewindow were removed, use darkwindow:shade [invert] instead
• Shader definition was moved from darkwindow:shader to plugin:darkwindow:shader

Deprecated:

• Dispatchers invert[active]window and shade[active]window will be removed soon, use darkwindow:shade[active] [invert] instead

# hyprland.conf

plugin:darkwindow {
  # To modify the uniforms of an already existing shader, create a new shader and set the uniforms you want
  shader[tintRed] {
      from = tint
      args = tintColor=[1 0 0] tintStrength=0.1
  }

  # Use a custom shader from a file
  shader[cool] {
      path = /path/to/shader.glsl # see the section below (#custom-shaders) for the content of this file
      args = wow=[1.0 0 0]
      introduces_transparency = true # if you modify the alpha value make sure to set this value to true so hyprland knows it should enable blur
  }
}

# Then to apply the shader to a window you can use window rules
windowrule = darkwindow:shade invert, match:class (pb170.exe)
# Uniforms can also be passed on the fly, but make sure to not use commas inside the arrays
windowrule = darkwindow:shade tint tintColor=[0 1 0], match:fullscreen true

# Or use a dispatcher
bind = $mainMod, T, darkwindow:shadeactive, tint tintColor=[0 0.5 1] tintStrength=0.3
# There is also a `darkwindow:shade WINDOW_REGEX SHADER_NAME` available (see window in https://wiki.hypr.land/Configuring/Dispatchers/#parameter-explanation)

Custom Shaders

To add custom shaders use the plugin:darkwindow:shader config category (see example above). The file at .path is a glsl file that should contain a void windowShader(inout vec4 color) function and uniform declarations for your .args. It can also contain more functions but be careful to not clash with names that are already used by hyprland.

The custom shader code will then be injected into the fragment shader used by hyprland. You can see examples of shaders by looking at the predefined shaders. Feel free to make a pull request to add your own shaders!

Special Variables

You can use these variables anywhere in your shader code. Do not add the uniform declarations. This plugin will automatically detect the used variables and set them at each render.

Name	Type	Description
x_Time	float	Current time in seconds using this will cause the entire window to rerender every frame
x_PixelPos	vec2	Position of the current pixel in window space (top left of the window is [0,0], monitor scaling already applied)
x_CursorPos	vec2	Position of the cursor, same coordinate space as x_PixelPos using this will cause the entire window to rerender every time the mouse is moved
x_WindowSize	vec2	Size of the current window, same scaling as x_PixelPos
x_MonitorScale	float	Scaling of the monitor as seen in hyprctl monitors
x_Texture	fn (vec2 texCoord) -> vec4	Gets the color of a pixel (the difference of using this vs. using texture(x_Tex, texCoord) is that this function handles opaque windows)
x_TextureOffset	fn (vec2 pixelOffset) -> vec4	Gets the color at a pixel offset to the currently drawn pixel
x_Tex	sampler2D	The texture that gets sampled from
x_TexCoord	vec2	The coordinate that was used to get the current pixel color

Installation

hyprpm

hyprpm add https://github.com/micha4w/Hypr-DarkWindow
hyprpm enable Hypr-DarkWindow
hyprpm reload

NixOS (home-manager)

You should already have a fully working home-manager setup before adding this plugin.

#flake.nix
inputs = {
    home-manager = { ... };
    hyprland = { ... };
    ...
    hypr-darkwindow = {
      url = "github:micha4w/Hypr-DarkWindow/tags/v0.36.0"; # Make sure to change the tag to match your hyprland version
      inputs.hyprland.follows = "hyprland";
    };
};

outputs = {
  home-manager,
  hypr-darkwindow,
  ...
}: {
  ... = {
    home-manager.users.micha4w = {
      wayland.windowManager.hyprland.plugins = [
        hypr-darkwindow.packages.${pkgs.system}.Hypr-DarkWindow
      ];
    };
  };
}