Since version 0.11.0, image files are now treated as file links instead of base64.
If the file does not exist when VSCode startup, the wallpaper will not be displayed.
- Normal mode will be discontinued
- Various parameters will be refactored
Press ⇧⌘P to bring up the command pallete and enter 'Wallpaper Setting'.
Select the desired setting from the menu.
Just follow the guide to easily set the wallpaper.
You can set an image as the VSCode background.
| Name | Required | Description | Remark |
|---|---|---|---|
| Opacity | △ | Transparency, Can be set to a value between 0.5 and 1. | In Normal mode, transparency is set all elements, including text and images, as well as the background. |
You can set a slide image as the VSCode background.
| Name | Required | Description | Remark |
|---|---|---|---|
| Opacity | *1 | *1 | *1 |
| Slide Interval Time | ○ | Image switching time. (Hour, Minute, Second, MilliSecond) | |
| Randome Play | - | Randomize image switching. | Default False. |
| Effect Fade in | - | Display Fade in effect when switching images. | Default True. |
| Load wait complete | - | Wait for the screen to display until all images are loaded. | Default False. |
*1 Same as the Wallpaper - Image.
Do you have many favorite images or slides?
You can easily switch between them using the Favorite Setting.
Don't repeat yourself! with this features.
| Name | Required | Description | Remark |
|---|---|---|---|
| Start Up | - | Set a random background from the favorite settings when VSCode starts up. |
Are you developing on multiple machines?
You no longer need to hand out image! with this features.
First, upload the wallpaper settings you wish to Sync.
Next, download and setup the wallpaper settings on another machines.
Want to delete your uploaded wallpaper settings?
Of course you can turn it delete. Just go to the menu and click on Delete or Uninstall and your uploaded wallpaper settings will be gone!
Please check the details in the Cautions section.
* This feature is disabled by default
* Only Wallpaper - Image setting can be Sync
* Image file size is less than 500KB, it can be used for Sync
* VSCode standard feature Settings Sync must be enable
Didn't like this extension?
Sorry for not being able to help you.
Let's uninstall it and erase all settings related to this extension.
It won't pollute your environment.
You want to set only the background, but you are not happy that even the text is transparent?
I understand! Let's resolve your complaint.
However, it will take some labor to resolve your complaint.
Also maybe it will not work.
Only those who understand this should use this feature.
Advanced Mode requires the json file of the color theme you are using.
If it is a color theme installed from extension, it is quicker to change the file extension of the vsix file download from marketplace to zip, unzip it, and get it from the theme folder.
We are not sure about the default theme is, so please investigate on your own.
From the VSCode settings screen, check the Advanced Mode checkbox in the Wallpaper Setting to enable the feature.
Invoke Wallpaper Setting from the command palette and select the Optimize.
First, the name of color theme you are using will be displayed, so please make sure it is the same. If it is different, please enter the corrent name.
Next, enter the three types of transparency.
| Name | Description | Remark |
|---|---|---|
| Base | Transparency used in basic areas. | |
| Overlap | Transparency used in overlapping areas. | |
| Selection | Transparency used in areas that shoud not be transparent. |
Finally, enter the json file path of the Color Theme you prepared.
- This process is required once per Profile
- Optimized Color Theme information will be added to profile's
settings.json
After that, please proceed as usual setting from the menu.
In Advanced Mode, transparency settings can only be set when Optimize.
Environment variables can be used to specify paths.
| Notation | Description | Remark |
|---|---|---|
| ${userHome} | Returns the string path of the current user's home directory. | Implementation-wise, we use node.js os.homedir. |
| ${<Environment Variables Name>} | If the environment variable specified in ${~} exists, it is replaced by its value. |
Prior to VSCode 1.72, the relevant message was not displayed. In fact, it is more correct to display.
The official explanation of this message is roughly as follows.
We are not trying to block VS Code patching, but we want to raise awareness that patching VS Code means you are running an unsupported version.
Respecting this assertion, this extension makes no attempt to prevent such messages from being displayed.
Even if we were to prevent it from being displayed, I believe the officials will block it.
This extension will make changes to the following three files.
- "VSCode installation directory" /Resources/app/out/vs/workbench/workbench.desktop.main.js
- "VSCode installation directory" /Resources/app/out/vs/code/electron-sandbox/processExplorer/processExplorer.js (Only when setting the background color for Process Explorer)
- settings.json
- extensions.json (Only when using the Sync feature)
"workbench.desktop.main.js" requires write permission. Therefor, this extension cannot be used with VSCode installed from "Snap Store" App Store for Linux (Because write permission cannot be obtained).
You probably have the following questions about Sync feature.
- Why is it disabled by default?
- Why can't Sync Wallpaper - Slide settings?
- Why is there a limit of 500KB file size or less?
- Will the upload images seen by the Setting Sync Administrator?
To answer thees questions, we must first briefly describe the Sync feature.
The Sync feature is achieved by converting image data to strings in Base64 and sharing them via Settings Sync.
Settings Sync backend is probably provided by Microsoft. And definitely not intended for image data sharing.
If you try to share an image file over MB (maybe even KB) with Settings Sync, Microsoft will be offended. They will reject the this extension and possibly disable the account of the user using the this extension from Settings Sync.
this is the reason why it is disabled by default and why limit is set.
The Base64 string uploaded to Settings Sync is encrypted in AES256 CTR mode.
Therefore, there is no fear of prying eye.
Unless you use poor values for password and salt, or I have made a mistake in the implementation of the cryptographic call.
From the VSCode settings screen, check the "Enable Sync" checkbox in the Wallpaper Setting to enable the feature.