Glass Background & Opacity
Control window transparency and visionOS glass material.
Glass Background
vmux windows can use the native visionOS glass material, letting your environment show through behind the terminal content.
Glass is enabled by default. Toggle it from the Command Palette by searching for Glass Background, or adjust it in Settings.
Glass Styles
| Style | Description |
|---|---|
| Regular (default) | Frosted glass — the standard visionOS material with a soft blur behind the window. |
| Clear | Thin translucent material — less frosted, more of your surroundings visible. |
Change the glass style from the Command Palette by searching for Glass Style.
When glass is disabled, the terminal uses a solid background color from your current theme.
Background Opacity
The Background Opacity slider controls how much of your theme's background color shows on top of the glass material (or as a solid color when glass is off).
| Property | Value |
|---|---|
| Range | 0% – 100% |
| Default | 50% |
| Step | Continuous slider |
- At 0%, the background is fully transparent — you see only the glass material (if enabled) or nothing at all.
- At 100%, the background is fully opaque — the theme's background color covers everything.
- The default 50% gives a balanced mix of theme color and glass translucency.
Adjust it from the Command Palette by searching for Set Background Opacity.
How Glass and Opacity Work Together
Glass provides the visionOS material layer. Opacity controls how much of your theme's background color is drawn on top of that layer.
- Glass on + low opacity — maximum translucency, your environment shows through.
- Glass on + high opacity — the glass material is mostly covered by the theme background, but edges and borders still pick up the visionOS effect.
- Glass off + any opacity — a flat background using only your theme color at the specified opacity.
Tips
- Bright environments: Increase opacity for better text contrast.
- Immersive spaces: Lower opacity to blend the terminal into your surroundings.
- Dark themes: A lower opacity often looks great with glass, since the glass material adds subtle depth.
- Light themes: A higher opacity prevents the glass from washing out lighter text colors.