Prerequisites
- Visual Studio Code 1.63.0 or newer
- Windows 10/11 or macOS
- Administrator/sudo access for initial setup
Installation
Install from Marketplace
Install Vibrancy Continued from the Visual Studio Code Marketplace.Or install directly in VS Code:
- Press
Ctrl+Shift+X(Windows/Linux) orCmd+Shift+X(macOS) - Search for “Vibrancy Continued”
- Click Install
Enable Vibrancy
Activate the extension:
- Press
F1to open Command Palette - Type “Reload Vibrancy”
- Select Reload Vibrancy
- Restart VS Code when prompted
You’ll see a warning that your installation appears corrupt. This is expected—click the cogwheel and select Don’t Show Again.
Windows Users: Fix Window Resizing
- Update your VS Code shortcut with
--disable-gpu-compositing: - In VS Code settings, enable Disable frameless window (
vscode_vibrancy.disableFramelessWindow) - Press
F1and run Reload Vibrancy
Choose a Theme
Customize your appearance:
- Open Settings (
Ctrl+,orCmd+,) - Search for “vibrancy theme”
- Select from 14 themes like:
- Default Dark
- Tokyo Night Storm
- Catppuccin Mocha
- GitHub Dark Default
Customize (Optional)
Fine-tune your experience:Adjust Opacity:Range: Options: See Configuration for all options.
-1 (theme default) to 1 (no transparency)Change Vibrancy Type (macOS):auto, under-window, fullscreen-ui, and moreChange Vibrancy Type (Windows):Example Configurations
- Minimal (Default)
- Tokyo Night
- Auto Theme Switching
- High Transparency
- Windows Acrylic
The simplest setup using default theme:
Fix Terminal Transparency
If your integrated terminal looks wrong, disable GPU acceleration:- Open Settings (
Ctrl+,orCmd+,) - Search for “gpu acceleration”
- Set Terminal › Integrated: Gpu Acceleration to
off
Common Issues
Nothing happens after first install
Nothing happens after first install
This is a known issue. Simply run Reload Vibrancy a second time and restart VS Code.
Window won't resize (Windows)
Window won't resize (Windows)
You need to add
--disable-gpu-compositing to your VS Code shortcut and enable the Disable frameless window setting. See Windows Setup Guide.Permission denied (macOS)
Permission denied (macOS)
Transparency isn't working
Transparency isn't working
Check:
- System transparency effects are enabled (not “Reduce transparency”)
- You’ve restarted VS Code after enabling Vibrancy
- Terminal GPU acceleration is off
- Your VS Code color theme matches the Vibrancy theme
After VS Code Updates
Each time VS Code updates, you need to re-enable Vibrancy:- Press
F1 - Run Reload Vibrancy
- Restart VS Code
Next Steps
Explore Themes
Browse all 14 built-in themes with screenshots
Configuration Reference
Learn about all available settings and customization options
Platform Guides
Detailed setup for Windows and macOS
Custom CSS
Create your own themes with custom CSS/JS

