Make application transparency opt-in (#14253)

* Make application transparency opt-in

* Use the transparency helper for Kanagawa

* Address transparency review findings

* Toggle transparency for opaque windows too

default/hypr/apps/browser.lua

@@ -1,12 +1,10 @@
 -- Browser tags and styling.
 o.window("((google-)?[cC]hrom(e|ium)|[bB]rave-browser|[mM]icrosoft-edge|Vivaldi-stable|helium)", { tag = "+chromium-based-browser" })
 o.window("([fF]irefox|zen|librewolf)", { tag = "+firefox-based-browser" })
-o.window({ tag = "chromium-based-browser" }, { tag = "-default-opacity", tile = true, opacity = "1.0 0.985" })
-o.window({ tag = "firefox-based-browser" }, { tag = "-default-opacity", opacity = "1.0 0.985" })
+o.window({ tag = "chromium-based-browser" }, { tile = true })
 
--- Video apps: remove chromium browser tag so they don't get opacity applied.
+-- Video apps: remove the chromium browser tag so they can float.
 o.window("(^.+-youtube\\.com__.*$|^.+-app\\.zoom\\.us__wc_home.*$)", { tag = "-chromium-based-browser" })
-o.window("(^.+-youtube\\.com__.*$|^.+-app\\.zoom\\.us__wc_home.*$)", { tag = "-default-opacity" })
 
 -- Hide screen sharing notification windows.
 o.window({ title = ".*is sharing.*" }, { workspace = "special silent" })

default/hypr/apps/davinci-resolve.lua

@@ -1,12 +1,9 @@
--- DaVinci Resolve window focus handling. Kept fully opaque: the default
--- translucency distorts colour-critical grading work.
+-- DaVinci Resolve window focus handling.
 o.window(".*[Rr]esolve.*", {
   float = true,
   stay_focused = true,
   -- Prevent modal dialog pointer warps when focus follows the mouse.
   no_follow_mouse = true,
-  tag = "-default-opacity",
-  opacity = "1 1",
 })
 
 o.window({ class = ".*[Rr]esolve.*", title = "^DaVinci Resolve( Studio)? - .+$" }, { fullscreen = true })

default/hypr/apps/hermes.lua

@@ -1,7 +1,5 @@
 -- Hermes Desktop's frameless HUD manages its own geometry.
 o.window({ class = "^Hermes$", title = "^Hermes HUD$" }, {
-  tag = "-default-opacity",
   float = true,
   border_size = 0,
-  opacity = "1 1",
 })

default/hypr/apps/localsend.lua

@@ -1,3 +1,5 @@
 -- Float LocalSend and fzf file picker.
-o.window("(Share|localsend)", { float = true, center = true })
-o.window("localsend", { size = { 1100, 700 } })
+local localsend = "(org\\.localsend\\.)?localsend(_app)?"
+o.window("Share", { float = true, center = true })
+o.window(localsend, { float = true, center = true, size = { 1100, 700 } })
+o.transparent_window(localsend)

default/hypr/apps/pip.lua

@@ -1,24 +1,20 @@
 -- Picture-in-picture overlays.
 o.window({ title = "(Picture.?in.?[Pp]icture)" }, { tag = "+pip" })
 o.window({ tag = "pip" }, {
-  tag = "-default-opacity",
   float = true,
   pin = true,
   size = { 600, 338 },
   keep_aspect_ratio = true,
   border_size = 0,
-  opacity = "1 1",
   move = { "(monitor_w-window_w-40)", "(monitor_h*0.04)" },
 })
 
 -- Google Meet PiP uses the meeting title instead of "Picture-in-Picture".
 o.window({ tag = "chromium-based-browser", title = "^Meet - .+" }, {
-  tag = "-default-opacity",
   float = true,
   pin = true,
   size = { 600, 338 },
   keep_aspect_ratio = true,
   border_size = 0,
-  opacity = "1 1",
   move = { "(monitor_w-window_w-40)", "(monitor_h-window_h-40)" },
 })

default/hypr/apps/qemu.lua

@@ -1 +0,0 @@
-o.window("qemu", { tag = "-default-opacity", opacity = "1 1" })

default/hypr/apps/retroarch.lua

@@ -1,6 +1,4 @@
 o.window("com.libretro.RetroArch", {
   fullscreen = true,
-  tag = "-default-opacity",
-  opacity = "1 1",
   idle_inhibit = "fullscreen",
 })

default/hypr/apps/steam.lua

@@ -1,4 +1,3 @@
 o.window("steam", { float = true, idle_inhibit = "fullscreen" })
 o.window({ class = "steam", title = "Steam" }, { center = true, size = { 1100, 700 } })
-o.window("steam.*", { tag = "-default-opacity", opacity = "1 1" })
 o.window({ class = "steam", title = "Friends List" }, { size = { 460, 800 } })

default/hypr/apps/system.lua

@@ -37,20 +37,6 @@ o.window("org.omarchy.screensaver", { animation = "slide" })
 -- where its fullscreen rule cannot take fullscreen from a window.
 o.window("org.omarchy.screensaver", { workspace = "special:screensaver silent" })
 
--- No transparency on media windows.
-o.window(
-  "^(zoom|vlc|mpv|org.kde.kdenlive|com.obsproject.Studio|com.github.PintaProject.Pinta|imv|org.gnome.NautilusPreviewer)$",
-  {
-    tag = "-default-opacity",
-  }
-)
-o.window(
-  "^(zoom|vlc|mpv|org.kde.kdenlive|com.obsproject.Studio|com.github.PintaProject.Pinta|imv|org.gnome.NautilusPreviewer)$",
-  {
-    opacity = "1 1",
-  }
-)
-
 -- Popped window rounding.
 o.window({ tag = "pop" }, { rounding = 8 })
 

default/hypr/apps/webcam-overlay.lua

@@ -16,10 +16,8 @@ o.window("^WebcamOverlay-large$", {
 -- The dedicated app id keeps this out of mpv's generic centered floating rules,
 -- so the camera appears at its final corner position.
 o.window({ class = "^WebcamOverlay-(small|medium|large)$", title = "^WebcamOverlay$" }, {
-  tag = "-default-opacity",
   float = true,
   pin = true,
   no_initial_focus = true,
   no_dim = true,
-  opacity = "1 1",
 })

default/hypr/apps/windows-vm.lua

@@ -1,5 +0,0 @@
--- Keep the Windows VM display opaque instead of applying the default window opacity.
-o.window({ class = "^xfreerdp$", title = "^Windows VM - Omarchy$" }, {
-  tag = "-default-opacity",
-  opacity = "1 1",
-})

default/hypr/bindings/utilities.lua

@@ -16,7 +16,7 @@ o.bind("XF86Calculator", "Calculator", "omacalc")
 o.bind_toggle("SUPER + SHIFT + SPACE", "Toggle top bar", "bar")
 o.bind("SUPER + CTRL + SPACE", "Background switcher", { menu = "background" })
 o.bind("SUPER + SHIFT + CTRL + SPACE", "Theme menu", { menu = "theme" })
-o.bind("SUPER + BACKSPACE", "Toggle window transparency", "omarchy-hyprland-window-transparency-toggle")
+o.bind("SUPER + BACKSPACE", "Toggle transparency on a window", "omarchy-hyprland-window-transparency-toggle")
 o.bind("SUPER + SHIFT + BACKSPACE", "Toggle window gaps", "omarchy-hyprland-window-gaps-toggle")
 o.bind("SUPER + CTRL + BACKSPACE", "Toggle single-window square aspect", "omarchy-hyprland-window-single-square-aspect-toggle")
 o.bind_toggle("SUPER + CTRL + ALT + F", "Toggle full screen desktop", "fullscreen-desktop")

default/hypr/helpers.lua

@@ -223,3 +223,8 @@ function o.window(match, rules)
 
   hl.window_rule(rules)
 end
+
+-- Opt a window in to Omarchy's standard active/inactive transparency.
+function o.transparent_window(match, opacity)
+  o.window(match, { opacity = opacity or "0.985 0.96" })
+end

default/hypr/windows.lua

@@ -2,9 +2,6 @@
 
 o.window(".*", { suppress_event = "maximize" })
 
--- Tag all windows for default opacity (apps can override with -default-opacity tag).
-o.window(".*", { tag = "+default-opacity" })
-
 -- Fix some dragging issues with XWayland.
 o.window(
   {
@@ -18,8 +15,12 @@ o.window(
   { no_focus = true }
 )
 
--- App-specific tweaks (may remove default-opacity tag).
+-- App-specific tweaks and terminal tags.
 require("default.hypr.apps")
 
--- Apply default opacity after apps have had a chance to opt out.
-o.window({ tag = "default-opacity" }, { opacity = "0.985 0.96" })
+-- Terminals (including TUIs) and these desktop apps opt in to transparency.
+o.transparent_window({ tag = "terminal" })
+o.transparent_window("(omawrite|1[pP]assword|com\\.onepassword\\.OnePassword|org\\.gnome\\.Nautilus)")
+
+-- The transparency hotkey opts otherwise opaque windows in with this tag.
+o.transparent_window({ tag = "transparent" })