Omaglass

Glass terminals on every Omarchy theme. A terminal becomes a frosted pane that shows the wallpaper through it and never the windows beneath; an unfocused pane lying over another window gets a slight contact shadow; and every window has a few looks you can cycle from the bar or a key.

Companion to Omachill: chill is about layout, glass is about material. Each works without the other.

Install

Two steps. The material is drawn by the hyprglass Hyprland plugin, which has to be compiled against your Hyprland — hyprpm does that. Until the two features this plugin relies on are merged upstream, use the fork:

hyprpm add https://github.com/nocstah/hyprglass && hyprpm enable hyprglass
omarchy plugin add https://github.com/nocstah/omaglass --enable

Without hyprglass the plugin still applies its window rules; there is just no glass, and the bar tells you once.

To remove it:

omarchy plugin remove io.github.nocstah.omaglass
hyprpm remove hyprglass   # optional: the compositor plugin itself

That deletes the loader; the marked include line left in hyprland.lua is inert and safe to delete, the per-theme look memory lives under ~/.local/state/omaglass/, and foot's alpha lines keep the last value the plugin wrote, so set them to taste afterwards.

On enable the plugin writes a small loader, ~/.config/hypr/omaglass.lua, and appends one guarded, marked line to ~/.config/hypr/hyprland.lua that runs it. Hyprland rebuilds its Lua state from the config on every reload, so that is what keeps the engine alive across reloads and theme switches. Disabling the plugin removes the loader again.

What it does

• Terminals are glass: foot, ghostty, alacritty and kitty windows get the frost, held compositor-opaque so the glass shows through the terminal's own background alpha. The plugin sets that alpha (per light/dark theme) in foot's config and repaints open windows; a theme shipping its own alpha wins.

• Hyprland's own blur, tuned to match: popups, the pads and translucent windows that are not glass still use Hyprland's blur; the plugin sets it to sit with the frost (size 8, two passes, xray, blur behind special workspaces). Themes that ship their own blur keep it.

• Wallpaper only (hyprglass x-ray): the glass is sampled from a snapshot of the desktop taken before any window is drawn, so windows underneath never show through.

• Shadows, three modes. Contact (default): one soft shadow system on every theme — the focused window gets a plain shadow, an unfocused window that lies over another window casts a lighter one there, cut at the underlying window's outline, so the part resting on the desktop casts nothing, and a lone inactive window casts none. Theme: Hyprland's shadows exactly as the theme sets them, no contact shadow. Flat: no shadows at all.

• Chilled windows (Omachill) are glass too; fullscreen windows never are.

• The bar and menus get the same frost.

• Looks per window, or for all: click the bar widget for a dropdown that lists every look with a one-line description and marks the current one. "All" (the default) applies to every glass window and makes it the default for windows opened from then on; "Window" applies to the focused window only. The All choice is remembered per theme and comes back with the theme. The same looks are on two keys:

  key	cycle
  SUPER + CTRL + G	glass → milky → solid
  SUPER + CTRL + ALT + G	glass → clear → pure → sheer → native → contrast → block

  milky and solid trade transparency for readability; clear is the wallpaper sharp through the pane, with the terminal's background laid over it at clearAlpha; pure is super clear: the wallpaper exactly as it is behind the text, no frost, no tint and no terminal background at all; sheer the lightest frost; native Hyprland's own blur; contrast and block are hyprglass's built-in presets.

Every option — which windows, the frost, the shadows, the alphas, the keys — is a widget setting stored in ~/.config/omarchy/shell.json. All of them are in the dropdown: click the bar icon, then the cog (tabs Glass / Shadows / Alpha / Widget); a change applies on the spot. The same keys work from the command line, for example:

omarchy bar set io.github.nocstah.omaglass shadows flat      # contact | theme | flat
omarchy bar set io.github.nocstah.omaglass frost 12          # lighter default frost
omarchy bar set io.github.nocstah.omaglass alphaLight 60     # terminal alpha on light themes
omarchy bar set io.github.nocstah.omaglass background false  # sample the live frame again
omarchy bar set io.github.nocstah.omaglass nativeBlur false  # leave Hyprland's own blur to your looknfeel

key	default	what
terminals	true	foot, ghostty, alacritty and kitty windows are glass
background	true	glass samples the wallpaper only (hyprglass x-ray)
chilled	true	windows chilled by Omachill are glass
layers	true	the bar, menus, OSD and notifications get the frost
nativeBlur	true	tune Hyprland's own blur to sit with the frost
frost	30	blur strength of the default glass
shadows	contact	contact, theme or flat
shadowRange, shadowStrength, shadowClip	28, 28, true	the contact shadow's reach, opacity, and whether it is cut at the underlying window
alphaLight, alphaDark	72, 62	the terminal's own background alpha per theme mode
milkyAlpha, clearAlpha	65, 45	the milky and clear looks' terminal alpha
keyReadability, keyLooks	SUPER + CTRL + G, SUPER + CTRL + ALT + G	the two cycle keys
notify	true	a toast when a look changes
hideWhenIdle	false	show the widget only while a look other than glass is active

Themes

Nothing per theme is needed: light or dark is read from the active theme, and Omarchy's reload after a theme switch re-applies everything. A theme that tunes its own glass sets _G.glass_theme_owned = true in its hyprland.lua and the plugin leaves the material to it, applying only the rules.

Scripting

hyprctl eval 'omaglass.cycle_looks()'            # focused window
hyprctl eval 'omaglass.set("clear", "0x...")'    # a window by address
hyprctl eval 'omaglass.look()'                   # current look
hyprctl eval 'omaglass.set_all("sheer")'         # every glass window, and the default for new ones

Every change emits custom>>omaglass <address> <look> on the event socket.

License

MIT