iglass

Product Introduction

1. Definition: iglass is a free, open-source terminal theme and configuration tool designed for macOS and Linux. It is a technical utility that applies a cohesive "Liquid Glass" aesthetic—characterized by transparency, blur, and system-native color palettes—to compatible terminal emulators like Ghostty, kitty, and iTerm2.
2. Core Value Proposition: It exists to bring a visually sophisticated, system-native glass material design to the developer's terminal environment without altering core functionality. Its primary value is delivering an Apple-like aesthetic with guaranteed color contrast, cross-terminal compatibility, and a completely reversible, non-destructive installation process.

Main Features

1. Native Liquid Glass Integration: On macOS 26+ with the Ghostty terminal, iglass utilizes Apple's proprietary NSVisualEffectView API to apply the system's genuine Liquid Glass material, not a simulated blur. This ensures perfect visual integration with the macOS desktop, including dynamic light/dark mode transitions and accurate blur radius.
2. Multi-Terminal & Multi-Platform Engine: The tool functions as an intelligent configuration engine. It detects the host OS (macOS or Linux) and the installed terminal emulator (Ghostty, kitty, iTerm2), then applies optimized theme files and settings specific to that combination. For Linux, it detects desktop environments (KDE Plasma, Hyprland, GNOME 51) to apply appropriate blur or fallback tinting.
3. Contrast-Aware, Multi-Level Palette System: iglass provides four distinct glass levels (Clear, Frosted, Tinted, Solid) and eight macOS-accurate accent colors. A core technical feature is its contrast-checking algorithm, which validates foreground text color visibility against the actual rendered background (factoring in transparency and the user's wallpaper), not a static color, ensuring WCAG-compliant readability in all conditions.

Problems Solved

1. Pain Point: Terminal theming is often fragmented, visually inconsistent with the host OS, and risks breaking readability or existing configurations. Manual theme installation can be irreversible and conflict with user settings.
2. Target Audience: macOS and Linux developers, system administrators, and power users who prioritize a visually cohesive desktop experience. Specifically, users of Ghostty, kitty, and iTerm2 who want a native, aesthetically refined terminal that matches modern OS design languages.
3. Use Cases: Essential for developers seeking a terminal that visually blends with macOS Sonoma+ or a modern Linux desktop; for users who frequently switch between light and dark modes and need a theme that adapts automatically; for teams or individuals who require guaranteed color contrast for accessibility and reduced eye strain during long coding sessions.

Unique Advantages

1. Strengths & Limitations (Pros & Cons):

   • Pros: Utilizes genuine OS-level visual effects (macOS Ghostty) for superior fidelity. Offers a completely safe, reversible installation with pre-write validation and backups. Provides a unified, contrast-guaranteed aesthetic across multiple terminals. Actively detects and adapts to the user's environment (OS, DE, terminal).
   • Cons: The flagship Liquid Glass effect is limited to Ghostty on macOS 26+. Advanced blur effects on Linux depend on specific compositor and desktop environment support (e.g., requires KWin, Hyprland, or mutter 51+). iTerm2 implementation uses standard transparency and blur, not the native macOS material.

2. Key Alternatives & Differentiation:

   • Manual Theme Configuration: Users can manually find and apply themes for each terminal. iglass differentiates by providing a unified, cross-terminal tool with automatic environment detection, built-in contrast checking, and a single-command reversible install, eliminating manual hunting and risk.
   • Terminal-Specific Theme Collections (e.g., iTerm2 Color Schemes, kitty themes): These are vast libraries of static color schemes. iglass differentiates by offering a curated, system-aware design system focused specifically on the glass aesthetic, dynamic light/dark mode support, and a dedicated tool (iglass) for management—functioning more like a dedicated theme engine than a static palette.
   • Oh My Zsh/Powerlevel10k: These are shell frameworks with visual themes. iglass is complementary and non-conflicting, as it themes the terminal emulator application itself (window background, selection colors), not the shell prompt. They operate at different layers of the stack.

Frequently Asked Questions (FAQ)

1. Does iglass change my shell or terminal shortcuts? No, iglass is strictly a visual theme for the terminal emulator window. It does not modify your shell (e.g., bash, zsh, fish), shell configuration, plugins, or any keyboard shortcuts. It only changes colors, transparency, and blur effects.
2. Which terminals and operating systems are supported? iglass officially supports Ghostty, kitty, and iTerm2 on macOS. On Linux, it supports Ghostty and kitty. The authentic Liquid Glass effect requires Ghostty on macOS 26 (Sequoia) or later. Linux blur support depends on your desktop environment's compositor.
3. How do I uninstall iglass and revert all changes? Run the command iglass uninstall from your terminal. This process will restore all modified configuration files to their exact original state by using backups created during installation, ensuring a byte-for-byte reversal.
4. Can I use iglass with my existing terminal color scheme or theme? No, iglass is a complete theme system. Installing it will override your terminal's current color palette and background settings with the iglass design. However, your font settings and other non-color preferences remain untouched.
5. How does the contrast checking work? The iglass algorithm simulates the final rendered appearance of the terminal window—including the chosen glass transparency level and a sample desktop background—to test foreground text color contrast ratios. This ensures readability is maintained in real-world use over dynamic wallpapers, not just on a theoretical flat color.