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.
Website · Install · Usage · kitty · Warp · Linux · FAQ
Tweaking iglass live: each iglass install updates the open window instantly.
brew install vukkt/tap/iglass # macOS or Linux; or use the install script below
iglass install # sets up the terminal you run it iniglass uninstall undoes everything. More options: Install and Usage.
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.
| Dark | Light | |
|---|---|---|
| Clear | ||
| Frosted | ||
| Tinted | ||
| Solid |
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 | ||
| Frosted | ||
| Tinted | ||
| Solid |
kitty 0.49 on macOS.
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% opaqueOn 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 | ||
| Frosted | ||
| Tinted | ||
| Solid |
Warp's November 2026 release on macOS.
| 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).
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 | ||
| GNOME · Tinted |
Ghostty on Fedora 44. KDE Plasma blurs the wallpaper behind the window; GNOME shows it through.
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,curlandjq(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 installOr 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 installOr from source:
git clone https://github.com/vukkt/iglass.git
cd iglass && ./install.sh --local
iglass installHomebrew 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.
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 settingsiglass 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 insteadOpacity below the readable minimum (0.66) asks for --force.
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.
One contrast-checked palette drives every terminal:
design/palettes.jsonholds Apple's system colors, the variants and the contrast targets.tools/build_palettes.pyblends 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.- 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.
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.
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).
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.
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.
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.
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.
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.
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).
Use a lower glass level (iglass preview --variant tinted), or --contrast high.
Run iglass doctor. The most common cause is another broken file in the dynamic profiles
folder, which stops iTerm2 from loading all of them.
iglass uninstall # removes iglass from every terminal; asks to restore iTerm2 settings
brew uninstall iglass # or: curl -fsSL …/install.sh | bash -s -- --uninstallmake 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.pngThe 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.