Skip to content
Projects

vukkt/iglass has 119 GitHub stars and 5 forks. GitHot measured 0 stars in 24 hours. Last checked 2026-11-17 18:30 UTC. Last push 2026-11-15.

How these counts are measured

Measured star growth

in 24h
0
in 7 days
Collecting history
in 15 days
Collecting history
in 1 month
Collecting history

Net star changes over overlapping periods, not daily totals. Missing measurements are left blank. Stars measure attention, not software quality.

About

A Liquid Glass–inspired theme for iTerm2, Ghostty, kitty and Warp, on macOS and Linux. Real Liquid Glass in Ghostty on macOS 26+; contrast-checked, light/dark, fully reversible.

Developer Tools

README.md

Original

iglass

Liquid Glass for your terminal. A theme for iTerm2, Ghostty, kitty and Warp, on macOS and Linux. Translucent, built from Apple's system colors, and contrast-checked so it stays readable.

CI Platforms: macOS 15+ and Linux Terminals: iTerm2, Ghostty, kitty and Warp License: MIT Sponsor

Website · Install · Usage · kitty · Warp · Linux · FAQ

An iTerm2 window turning glassier and changing accent color live as iglass install commands run

Tweaking iglass live: each iglass install updates the open window instantly.

Quick start

brew install vukkt/tap/iglass   # macOS or Linux; or use the install script below
iglass install                  # sets up the terminal you run it in

iglass uninstall undoes everything. More options: Install and Usage.

Why iglass

macOS's Liquid Glass makes apps feel light and layered. iglass brings that look to your terminal, carefully:

  • Real Liquid Glass in Ghostty (macOS 26+): Apple's own glass material, not an imitation.
  • The closest iTerm2 allows: transparency, blur and a palette designed to sit on top of them.
  • kitty too: kitty's own blur on macOS (and on Linux desktops that support it), with a title bar that's part of the glass.
  • Warp too: iglass's colors as Warp themes that follow light and dark mode, and the glass through Warp's own window opacity and blur. Warp applies it the moment you install.
  • Linux too: the same palettes in Ghostty, kitty and Warp on Linux, with transparency, and blur where your desktop provides it.
  • Four glass levels, mirroring Apple's own options: Clear, Frosted, Tinted and Solid.
  • Follows light and dark mode automatically, with a separate palette for each.
  • Apple's system colors and macOS accent colors, adjusted only where contrast requires it.
  • Contrast-checked. Every color is verified against the window as it looks over your desktop, not just against a flat background. See the report.
  • High-contrast option and hints for macOS Reduce Transparency / Increase Contrast (and GNOME's high contrast on Linux).
  • Keeps your setup. Only the look changes: your font, keyboard shortcuts, shell and directories stay as they are.
  • Safe and reversible. Everything iglass changes is backed up and undone exactly on uninstall.

Ghostty: real Liquid Glass

Dark Light
Clear iglass Clear in Ghostty, dark iglass Clear in Ghostty, light
Frosted iglass Frosted in Ghostty, dark iglass Frosted in Ghostty, light
Tinted iglass Tinted in Ghostty, dark iglass Tinted in Ghostty, light
Solid iglass Solid in Ghostty, dark iglass Solid in Ghostty, light

kitty

kitty blurs behind its own windows on macOS, and on Linux where the desktop supports it (KDE Plasma, Hyprland, niri 26.04+, GNOME 51+). iglass gives it the same palettes, glass levels and accents, a title bar that's part of the glass, and colors that switch with light and dark mode (kitty 0.38+).

Dark Light
Clear iglass Clear in kitty, dark iglass Clear in kitty, light
Frosted iglass Frosted in kitty, dark iglass Frosted in kitty, light
Tinted iglass Tinted in kitty, dark iglass Tinted in kitty, light
Solid iglass Solid in kitty, dark iglass Solid in kitty, light

kitty 0.49 on macOS.

Warp

Warp has its own theme format and a settings file it watches, so iglass installs two Warp themes (iglass Dark and iglass Light, switched with light and dark mode by Warp itself) and sets Warp's window opacity and blur to the variant you pick. Warp applies it right away, no restart. Everything else in your Warp settings stays as it is, and iglass uninstall puts back what was there before.

iglass install --terminal warp                    # Frosted: 66% opaque, blur 24
iglass install --terminal warp --variant clear    # the most see-through: 50% opaque

On macOS Warp blurs behind its windows. On Linux Warp has no blur setting, so the glass is transparency, and blur where the desktop adds it (Hyprland, or niri with a window rule). Warp reads settings.toml from its April 2026 releases on; iglass doctor tells you if yours is older.

Dark Light
Clear iglass Clear in Warp, dark iglass Clear in Warp, light
Frosted iglass Frosted in Warp, dark iglass Frosted in Warp, light
Tinted iglass Tinted in Warp, dark iglass Tinted in Warp, light
Solid iglass Solid in Warp, dark iglass Solid in Warp, light

Warp's November 2026 release on macOS.

iTerm2 gallery (all four variants, light and dark)
Dark Light
Clear iglass Clear in iTerm2, dark iglass Clear in iTerm2, light
Frosted iglass Frosted in iTerm2, dark iglass Frosted in iTerm2, light
Tinted iglass Tinted in iTerm2, dark iglass Tinted in iTerm2, light
Solid iglass Solid in iTerm2, dark iglass Solid in iTerm2, light
Variant Feels like Transparency Ghostty glass Warp opacity · blur Readable over
Clear Liquid Glass Clear 50% macos-glass-clear 50 · 12 Mid-tone wallpapers (aesthetic choice)
Frosted · default¹ Liquid Glass Regular 34% macos-glass-regular 66 · 24 Typical wallpapers
Tinted macOS Tinted mode 18% macos-glass-regular 82 · 26 Any wallpaper
Solid Reduce Transparency 0% none 100 · none Any wallpaper

¹ On Linux desktops without blur the default is Tinted; see Linux.

Accents: blue, purple, pink, red, orange, yellow, green, graphite (the macOS accent colors).

Linux

iglass works with Ghostty, kitty and Warp on Linux. You get the same contrast-checked palettes, the four variants, accents and light/dark switching. Liquid Glass itself is Apple's material, so on Linux the glass is transparency plus blur, and blur depends on your desktop:

Desktop Blur behind kitty Blur behind Ghostty Blur behind Warp Light/dark switching
KDE Plasma 6.7+ ✓ (kitty 0.46.2+) Ghostty 1.4+ — ✓
KDE Plasma before 6.7 ✓ Ghostty before 1.4 — ✓
Hyprland ✓ (Hyprland's own blur) ✓ (with GTK 4.24+: Ghostty 1.4+) ✓ (Hyprland's own blur) If the desktop reports it
niri 26.04+ ✓ (kitty 0.46.2+) Ghostty 1.4+, or now with a niri window rule With a niri window rule If the desktop reports it
GNOME 51+ ✓ (kitty 0.46.2+) Ghostty 1.4+ — ✓
GNOME 50 and earlier, others — — — ✓ on GNOME; elsewhere if the desktop reports it

Desktops and terminals moved to a new, shared way of asking for blur in 2026, which is why the versions matter: KDE Plasma 6.7 and Ghostty 1.4 both switched over. iglass recognizes the desktop, its version and the terminal's version. Where it blurs, the default is Frosted. Clear and Frosted rely on blur to keep text readable, so where it doesn't, iglass installs Tinted, which is checked against pure black and white, and tells you why. On niri it also prints the window rule that adds blur behind a terminal that doesn't ask for it yet. You can still choose any variant with --variant.

iglass also recognizes your distribution: Arch-based ones (Arch, Garuda, CachyOS, Manjaro, EndeavourOS), Debian and Ubuntu, Fedora, and openSUSE get install hints for their own package manager. On Garuda or any Arch-based system:

sudo pacman -S --needed jq kitty     # or ghostty
curl -fsSL https://raw.githubusercontent.com/vukkt/iglass/main/install.sh | bash
iglass install
Dark Light
KDE Plasma · Frosted iglass Frosted in Ghostty on Fedora KDE Plasma, dark iglass Frosted in Ghostty on Fedora KDE Plasma, light
GNOME · Tinted iglass Tinted in Ghostty on Fedora GNOME, dark iglass Tinted in Ghostty on Fedora GNOME, light

Ghostty on Fedora 44. KDE Plasma blurs the wallpaper behind the window; GNOME shows it through.

Install

Requirements

  • macOS: macOS 15 or later, and iTerm2 3.5+, Ghostty 1.0+, kitty 0.38+ or Warp (April 2026 or later). Real Liquid Glass needs macOS 26+ and a recent Ghostty.
  • Linux: Ghostty 1.0+, kitty 0.38+ or Warp with its command on your PATH, plus bash, curl and jq (sudo apt install jq, sudo dnf install jq, sudo pacman -S jq).
  • Earlier kitty versions work too, without switching colors with light and dark mode.

With Homebrew (macOS or Linux):

brew install vukkt/tap/iglass
iglass install

Or with the install script, which downloads the latest release (puts iglass in ~/.local/bin):

curl -fsSL https://raw.githubusercontent.com/vukkt/iglass/main/install.sh | bash
iglass install

Or from source:

git clone https://github.com/vukkt/iglass.git
cd iglass && ./install.sh --local
iglass install

Homebrew and the install script also set up tab completion for bash, zsh and fish. With the install script, zsh needs one line in ~/.zshrc, which the installer prints. With Homebrew, see Homebrew's shell completion guide if zsh doesn't pick it up.

iglass install sets up the terminal you run it in. Use --terminal iterm2, ghostty, kitty, warp or all to choose. In iTerm2, open a window with iglass preview or pick Profiles › iglass Frosted. In Ghostty and kitty, quit and reopen them (they read transparency only at launch). Warp changes right away.

Without the CLI

iTerm2: copy themes/iglass.json into ~/Library/Application Support/iTerm2/DynamicProfiles/. iTerm2 picks it up immediately. Plain color presets are in themes/ too (iTerm2 › Settings › Profiles › Colors › Color Presets › Import), but they carry colors only, not the glass settings.

Ghostty: copy the files in themes/ghostty/themes to ~/.config/ghostty/themes/, then add to your Ghostty config:

theme = light:iglass-frosted-light,dark:iglass-frosted-dark

(or theme = iglass-frosted-dark to stay dark all the time).

These files use macOS's real Liquid Glass. On Linux, use the CLI, or make your own with iglass export --terminal ghostty --glass blur --dir ./iglass-ghostty.

kitty: copy the files in themes/kitty to your kitty config folder (usually ~/.config/kitty), then add include iglass.conf to the end of your kitty.conf. If you made light/dark themes with kitten themes, these replace them, so keep a copy.

Warp: copy iglass-dark.yaml and iglass-light.yaml from themes/warp to ~/.warp/themes/ (Linux: ~/.local/share/warp-terminal/themes/), then add the lines in iglass-settings.toml to Warp's settings.toml, replacing any settings with the same names. Or just pick iglass Dark or iglass Light under Settings › Appearance › Themes, and set the window opacity there.

Usage

iglass install                          # all four variants, blue accent
iglass install --accent purple          # pick an accent
iglass install --contrast high          # stronger colors
iglass install --appearance dark        # always dark, even when macOS or your desktop is light
iglass install --terminal warp          # pick the terminal (default: the one you're in)
iglass install --terminal all           # every supported terminal you have installed
iglass install --app-settings           # iTerm2 (macOS): native title bar + roomier padding (restarts iTerm2)
iglass install --variant tinted --default   # iTerm2 (macOS): make a variant your default profile

iglass preview --variant clear          # open a window to try a variant
iglass list                             # variants and accents
iglass status                           # what's installed
iglass doctor                           # check for problems (changes nothing)
iglass uninstall                        # remove everything, restore settings

Fine-tuning

iglass install --opacity 0.8 --blur 18      # adds an "iglass Custom" profile / theme
iglass install --cursor box                  # bar (default), box, underline, keep
iglass install --window no-titlebar          # native (default), no-titlebar, keep
iglass install --font sf-mono                # keep (default), sf-mono, or "PostScriptName 14"
iglass install --glass blur                  # Ghostty on macOS: classic blur instead of real glass
iglass export --accent green > my.json       # print the iTerm2 profiles file instead

Opacity below the readable minimum (0.66) asks for --force.

What iglass changes

Only the files that decide how your terminal looks: iglass's own theme files, two lines at the end of your Ghostty or kitty config, a few settings in Warp's settings.toml, and an iTerm2 dynamic profile. Your config is backed up first, symlinked dotfiles stay symlinks, and iglass uninstall restores your files byte for byte. The full list, terminal by terminal: What iglass changes.

--app-settings goes one step further in iTerm2: its Automatic theme, which lets macOS draw the title bar and tabs the way it draws them for its own apps, and roomier padding. Those apply to every iTerm2 window, and iTerm2 saves its settings when it quits, so a small helper quits iTerm2 (asking first if programs are running), applies them and reopens it. Uninstall puts the exact previous values back.

How it works

One contrast-checked palette drives every terminal:

  1. design/palettes.json holds Apple's system colors, the variants and the contrast targets.
  2. tools/build_palettes.py blends each window background over black, white and grey desktops at each variant's transparency, checks every color against the worst case, and nudges lightness (in OKLCH, keeping hue) only where a color falls short.
  3. The result ships as data/palette.json, and every decision is listed in the contrast report.

For iTerm2, iglass installs a dynamic profile. A dynamic profile inherits everything it doesn't set from your default profile, so iglass sets every color and every setting iTerm2 keeps separately for light and dark mode (a test enforces this), and nothing about how you work. Files are validated with Apple's parser first, because one unreadable file stops iTerm2 from loading any dynamic profile.

For Ghostty, iglass writes theme files and checks them with Ghostty's own validator before anything touches your config. It asks Ghostty whether it supports macos-glass rather than guessing from version numbers.

For kitty, which has no validator command, iglass loads every generated file with kitty's own config parser (the one kitty runs at startup) before anything touches your config.

For Warp, iglass checks each setting it writes against the settings schema that ships inside Warp, so a renamed setting stops the install instead of breaking your settings. It edits settings.toml line by line, and CI validates the result against the schema of Warp's latest release.

The CLI is plain bash plus the jq, plutil and defaults that ship with macOS, so there is nothing else to install on a Mac. On Linux it needs jq, and uses fontconfig to check fonts. More detail, including what was verified in each terminal's behavior: docs/research-notes.md.

FAQ

Is this real Liquid Glass?

In Ghostty, yes, on macOS 26 and later: iglass uses Ghostty's macos-glass-regular and macos-glass-clear, which are Apple's own glass material.

In iTerm2, no, and no theme can change that. iTerm2 hasn't shipped Liquid Glass for terminal windows: a pull request adding it was closed because glass breaks window resizing in a terminal. iglass gets as close as iTerm2 allows with transparency, blur and a matching palette, and will use real glass if iTerm2 adds it.

Is it Liquid Glass on Linux?

No. Liquid Glass is Apple's material and only exists on macOS. On Linux, iglass uses the same palettes with transparency and blur, so it looks glassy and stays readable. Blur depends on your desktop (see Linux).

Is it Liquid Glass in kitty or Warp?

No: neither has access to Apple's glass material, so iglass uses their own transparency and blur. In kitty, with the matching title bar, it looks and feels like glass. For the real material on macOS, use Ghostty.

Warp didn't change.

Run iglass doctor. Warp reads settings.toml from its April 2026 releases on; doctor says if yours is older, and shows any iglass setting you've since changed on Warp's settings page.

Isn't glass behind text against Apple's own advice?

Partly. Apple reserves glass for controls and navigation and keeps content clear. Terminal text is content, which is why Frosted is the default (Tinted on Linux desktops without blur), Tinted and Solid exist, and every variant is contrast-checked. Choose the level that suits you; Tinted is the most Apple-like for long work.

Can iglass stay dark when my system switches to light?

Yes: iglass install --appearance dark keeps iglass dark (or light keeps it light) while macOS or your Linux desktop keeps switching. --appearance auto, the default, follows it again. Like the other options, run it with the rest of your choices, e.g. iglass install --variant clear --accent pink --appearance dark.

Ghostty or kitty didn't change.

Quit and reopen it: both read transparency only at launch. If it still looks the same, run iglass doctor. In Ghostty, a config file loading after yours can override iglass; in kitty, settings after iglass's include line in kitty.conf can.

My prompt icons disappeared.

iglass keeps your font unless you pass --font. If you did, reinstall without it (iglass install) to go back to your own (e.g. a Nerd Font).

Text is hard to read on my wallpaper.

Use a lower glass level (iglass preview --variant tinted), or --contrast high.

iglass profiles don't show up in iTerm2.

Run iglass doctor. The most common cause is another broken file in the dynamic profiles folder, which stops iTerm2 from loading all of them.

Uninstall

iglass uninstall            # removes iglass from every terminal; asks to restore iTerm2 settings
brew uninstall iglass       # or: curl -fsSL …/install.sh | bash -s -- --uninstall

Development

make palettes          # rebuild colors after editing design/palettes.json
make themes            # rebuild the prebuilt themes/ files
make check             # shellcheck, generated-file check, palette tests, bats suite
tools/screenshots.sh   # README screenshots over a generated backdrop (needs Screen Recording)
tools/release-notes.sh X.Y.Z   # a release's notes, from CHANGELOG.md (see CONTRIBUTING.md)
tools/record-gif.sh    # docs/demo.gif (needs ffmpeg)
osascript -l JavaScript tools/social-card.js BACKDROP.png SHOT.png docs/social-preview.png

The website (vukkt.github.io/iglass) is site/index.html, published by the Website workflow with images taken from docs/screenshots at build time.

Tests run in a sandbox with stand-ins for iTerm2, Ghostty, kitty, Warp and system commands, so they never touch your real settings. See CONTRIBUTING.md.


iglass is an independent project, not affiliated with or endorsed by Apple Inc., iTerm2, Ghostty, kitty or Warp. Liquid Glass, macOS and SF Mono are trademarks of Apple Inc.

MIT · built by @vukkt · sponsor