HELP.md

Common Issues

Code installation is corrupt

This warning may appear after running the uninstall command, reopen VSCode for this to disappear.

If this warning still appears after an uninstall, reinstall VSCode.

VSCode stopped working #46

This extension modifies an internal file to make backgrounds work, if VSCode stops working replace %LocalAppData%\Programs\Microsoft VS Code\resources\app\out\vs\workbench\workbench.desktop.main.js with workbench.desktop.main-backup.js.

This extension also modifies %LocalAppData%\Programs\Microsoft VS Code\resources\app\product.json, replace with product-backup.json if VSCode stops working.

 

Disable/uninstall doesn't remove background

Backgrounds are not removed on extension disable or uninstall, you must run the Background: Uninstall command to remove backgrounds.

Options not working for editor/sidebar/panel

background.useWindowOptionsForAllBackgrounds is deprecated, do not use it.

Options will not change if background.useWindowOptionsForAllBackgrounds is set to true, either change the options for window or set background.useWindowOptionsForAllBackgrounds to false.

Background doesn't work on window buttons (minimize/maximize/close) #178

These buttons are controlled by the system and not VSCode; and can not be modified by this extension.

 

(Windows) Doesn't work on WSL #27

Backgrounds can not be changed while running this extension in a remote WSL window. Backgrounds must be changed by making changes in the main VSCode window, then opening the remote WSL window.

(Mac) read-only file system #76

This extension doesn't natively support Mac, write permissions must be granted to the VSCode application:

1. Move Visual Studio Code.app from Download to the Application directory.
2. Run sudo chmod -R a+rwx '/Applications/Visual Studio Code.app' to grant write permissions.

(Linux) snap: read-only file system #140

Applications installed using snap are inherently read-only, install VSCode using deb or rpm.