Solutions for common issues can be found in the FAQ and Known Errors
❗️ Windows 10/11 users: scroll down to see an important warning regarding Windows support
Enable Acrylic/Glass effect in VS Code.
Links: GitHub | Visual Studio Code Marketplace | issues
Maintenance of this project is made possible by all the contributors and sponsors. If you'd like to sponsor this project and have your avatar or company logo appear below, click here. Any support is greatly appreciated 💖
By default, when Vibrancy is installed on VSCode 1.86 and newer on Windows, your VSCode windows may stop being resizable, snappable or maximizable. This is a known issue related to VSCode 1.86 and Electron 27 and it occurs due to hardware acceleration leading to distorted text. Vibrancy will by default apply a mitigation that enables frameless windows, but this also causes issues with window interaction.
The correct process to install Vibrancy on Windows is:
- Update your VSCode shortcut to include
--disable-gpu-compositing
at the end of "Target" field, for example:"C:\Users\User\AppData\Local\Programs\Microsoft VS Code\Code.exe" --disable-gpu-compositing
- (optional) Update your shell configuration to add the same argument to
code
, needed if VSCode isn't running when you usecode
- Install Vibrancy Continued
- Go to settings and check Disable frameless window (
vscode_vibrancy.disableFramelessWindow
) - Press F1 and select Reload Vibrancy
For more information, see issues #140 and #122.
This extension works by editing VS Code's checksum-verified HTML files, which means that a warning prompt will appear after installing and enabling Vibrancy Continued. This warning is safe to disregard, and all changes can be reverted. Click on the cogwheel and select Don't Show Again to hide it.
To fix the "[Unsupported]" warning on VS Code's title bar, please refer to this extension: Fix VSCode Checksums.
✔ macOS (Intel & Apple Silicon)
✔ Windows 10/11 (x64 & ARM64)
✔ Visual Studio Code
✔ VSCodium
✔ Cursor (work in progress, see here for more info)
- Make sure the VSCode theme you've selected is 'Dark+' or one of the supported themes
-
Install the extension from Visual Studio Code Marketplace.
-
Press F1 and activate command "Reload Vibrancy."
- Restart VSCode when prompted.
Each time VS Code is updated, please re-enable Vibrancy using the same steps. If you're experiencing issues, please check the FAQs.
Native method of Vibrancy Effect.
- auto : Automatically switch with system version.
- acrylic : (Windows 10 only) Fluent Design blur.
- under-window, fullscreen-ui, appearance-based, light, dark, titlebar, selection, menu, popover, sidebar, medium-light, ultra-dark: (MacOS only)
Opacity of Vibrancy Effect. -1 is theme default, 0 is maximum transparency, and 1 will remove all transparency.
value: -1.0 ~ 1.0
Import any custom CSS/JS files into the VSCode editor, as file paths. The files will be imported in the order they are listed. On Windows, forward slashes must be used.
Use this feature to add a custom Vibrancy Continued theme or modify an existing one.
EXAMPLES:
- Windows:
C:/Users/MyUserName/Documents/custom.css
- macOS:
/Users/MyUserName/Documents/custom.css
value: array[]
Use a new method for preventing window flashing during resizing. Eliminates the need for a refresh interval, but may be less compatible in some cases.
boolean, default is true
Disable frameless window, which is a mitigation that fixes a GPU-related render bug on Windows with VSCode 1.86 and newer. You may see distorted and blurry graphics if you disable this mitigation with an affected GPU. Running VSCode with a --disable-gpu-compositing
argument, such as via a shortcut, will allow for this mitigation to be safely disabled.
Refresh interval (in milliseconds) for making the background transparent after window resizing. Lower values make the update less visible at the cost of increased CPU utilization. Ignored when using "Prevent Flash" method.
value: 1 ~ 1000, default is 10
Enable automatic dark/light mode switching based on OS mode. Requires window.autoDetectColorScheme
VSCode setting to also be enabled.
boolean, default is false
Select which themes to use for light and dark modes, they will be used instead of the main Vibrancy Continued theme selected.
Select Vibrancy theme:
- Default Dark
- Dark (Only Subbar)
- Default Light
- Light (Only Subbar)
- Noir et blanc
- Tokyo Night Storm
- Tokyo Night Storm (Outer)
- Catppuccin Mocha
- Solarized Dark+
- GitHub Dark Default
Theme | Screenshot |
---|---|
Default Dark | ![]() |
Dark (Only Subbar) | ![]() |
Noir et blanc | ![]() |
Tokyo Night Storm | ![]() |
Tokyo Night Storm (Only Subbar) | ![]() |
Solarized Dark+ (with theme: Solarized) | ![]() |
Catppuccin Mocha | ![]() |
GitHub Dark Default | ![]() |
You can contribute more themes! see here.
Press F1 or ⌘+Shift+P and activate command "Disable Vibrancy", then restart Visual Studio Code.
You can also just uninstall the extension and restart VSCode, which will automatically remove Vibrancy.
Check your settings. You should change the renderer type of the terminal to dom
.
"terminal.integrated.gpuAcceleration": "off"
It usually appears on Windows when you are using the VSCode System Installer. You should close VSCode completely, then run VSCode as administrator and retry what you did before (Enable/Reload/Disable Vibrancy).
Your installation of VSCode is owned by another user.
Run the following commands exactly as-is in the Terminal app to take ownership of the files, and enter your password when prompted:
sudo chown -R $(whoami):staff "/Applications/Visual Studio Code.app/"
sudo chmod -R 755 "/Applications/Visual Studio Code.app/"
A reinstallation will also fix this issue without any loss of settings.
Your installation of VSCode is affected by App Translocation.
To fix this, either use the Finder and move VSCode to /Applications
(or move it out of /Applications
and then back in), or run the following terminal command:
sudo xattr -dr com.apple.quarantine "/Applications/Visual Studio Code.app"
Please see Important notice for Windows users at the top of the description.
Ensure that you don't have transparency effects disabled globally through your OS settings.
This can usually be found under Accessibility settings, and it may be called "Transparency effects" or "Reduce transparency." If that didn't help, you can also check the Console section in VSCode's Developer Tools, which can be accessed through the command palette.
If nothing else worked, try reinstalling VSCode, you won't lose any settings and this will ensure that your VSCode installation is consistent.
Contributions are what make the open source community such an amazing place to learn, inspire, and create. Vibrancy relies on user contributions, and as such, any contributions you make are greatly appreciated.
If you have a suggestion that would make this better, please fork the repo and create a pull request. You can also simply open an issue with the tag "enhancement".
Don't forget to give the project a star! Thanks again!
- Fork the Project
- Create your Feature Branch (
git checkout -b feature/AmazingFeature
) - Commit your Changes (
git commit -m 'Add some AmazingFeature'
) - Push to the Branch (
git push origin feature/AmazingFeature
) - Open a Pull Request
When creating a PR, please target the development
branch.
Distributed under the MIT License. See LICENSE.txt
for more information.
EYHN : for making the original Vibrancy that this is a fork of
be5invis/vscode-custom-css : The basis of this extension program
DIYgod : Fix issues with VSCode 1.36