[FEATURE] Add Window Opacity Toggle

[trivndev]

Is your feature request related to a problem? Please describe.

i use window opacity when I want a more transparent window, but when I no longer need the transparency, I currently have no way to turn it off and restore the window to its default opacity.

Describe the solution you'd like

Add a keybind to toggle the active window's opacity, similar to the opacity toggle feature in JaKooLit dotfiles.

Describe alternatives you've considered

No response

Additional context

No response

Support or Contribution

• I am willing to contribute or support this feature

[mylinuxforwork]

Hi. Thanks for this feature request. I like it. I will check.

[dwilliam62]

FYI:
This is the script I use for changing opacity per window

#!/usr/bin/env bash
# ==================================================
#  KoolDots (2026)
#  Project URL: https://github.com/LinuxBeginnings
#  License: GNU GPLv3
#  SPDX-License-Identifier: GPL-3.0-or-later
# ==================================================
# Toggle active_opacity using Lua hl.config (or legacy keyword in conf mode).
# Uses flock to prevent double-execution from dual-config (.conf + .lua) loading.

TRANSPARENCY=0.85
NORMAL=1.0
LOCK="/tmp/.hypr_toggle_opacity_${HYPRLAND_INSTANCE_SIGNATURE:-default}.lock"

config_home="${XDG_CONFIG_HOME:-$HOME/.config}"
hypr_dir="$config_home/hypr"
lua_entry="$hypr_dir/hyprland.lua"
legacy_lua_entry="$config_home/hyprland.lua"

if [[ -f "$lua_entry" || -f "$legacy_lua_entry" ]]; then
    hypr_config_mode="lua"
else
    hypr_config_mode="conf"
fi

(
  flock -n 200 || exit 0

  CURRENT=$(hyprctl -j getoption decoration:active_opacity 2>/dev/null | jq -r '.float // empty')
  if [[ -z "$CURRENT" || "$CURRENT" == "null" ]]; then
    CURRENT=$(hyprctl getoption decoration:active_opacity 2>/dev/null | awk 'NR==1{print $2}')
  fi

  IS_FULL=$(awk -v c="${CURRENT:-1.0}" 'BEGIN {print (c >= 0.999) ? "1" : "0"}')

  if [ "$IS_FULL" = "1" ]; then
    TARGET="$TRANSPARENCY"
  else
    TARGET="$NORMAL"
  fi

  if [[ "$hypr_config_mode" == "lua" ]]; then
    hyprctl eval "hl.config({ decoration = { active_opacity = ${TARGET} } })"
  else
    hyprctl keyword decoration:active_opacity "$TARGET"
  fi
) 200>"$LOCK"

[dwilliam62]

I also have one to change the BLUR per window

#!/usr/bin/env bash
# ==================================================
#  KoolDots (2026)
#  Project URL: https://github.com/LinuxBeginnings
#  License: GNU GPLv3
#  SPDX-License-Identifier: GPL-3.0-or-later
# ==================================================
# Script for changing blurs on the fly

notif="${XDG_CONFIG_HOME:-$HOME/.config}/swaync/images"

config_home="${XDG_CONFIG_HOME:-$HOME/.config}"
hypr_dir="$config_home/hypr"
lua_entry="$hypr_dir/hyprland.lua"
legacy_lua_entry="$config_home/hyprland.lua"

if [[ -f "$lua_entry" || -f "$legacy_lua_entry" ]]; then
    hypr_config_mode="lua"
else
    hypr_config_mode="conf"
fi

STATE=$(hyprctl -j getoption decoration:blur:passes 2>/dev/null | jq -r ".int // empty")
if [[ -z "$STATE" || "$STATE" == "null" ]]; then
    STATE=$(hyprctl getoption decoration:blur:passes 2>/dev/null | awk 'NR==1{print $2}')
fi

if [ "${STATE}" == "2" ]; then
    if [[ "$hypr_config_mode" == "lua" ]]; then
        hyprctl eval "hl.config({ decoration = { blur = { size = 2, passes = 1 } } })"
    else
        hyprctl keyword decoration:blur:size 2
        hyprctl keyword decoration:blur:passes 1
    fi
    notify-send -e -u low -i "$notif/note.png" " Less Blur"
else
    if [[ "$hypr_config_mode" == "lua" ]]; then
        hyprctl eval "hl.config({ decoration = { blur = { size = 5, passes = 2 } } })"
    else
        hyprctl keyword decoration:blur:size 5
        hyprctl keyword decoration:blur:passes 2
    fi
    notify-send -e -u low -i "$notif/ja.png" " Normal Blur"
fi