Use your own wallpapers in OpenCode Desktop. Supports OpenCode 2.2.x from 2.2.6 and 2.3.x from 2.3.2 through the GUI plugin API.
opencode plugin add 'github:viralcodex/opencode-backdrop#v0.2.0'This installs the plugin globally. Alternatively, add it to your global opencode.json or opencode.jsonc, keeping any existing plugins. Do not add it to cli.json.
- Open Settings > Wallpapers.
- Choose Change folder to use a local folder, or + to upload an image.
- Select an image and adjust tint, brightness and fit.
Wallpaper starts off with an empty gallery. Images and preferences stay local, and images are not sent to models. Files must be non-empty and no larger than 8 MiB.
- Folder images support PNG, JPEG, WebP and SVG, including subfolders. Changes appear automatically.
- Uploads support PNG, JPEG and WebP.
- The gallery shows at most two rows, including the + tile. Use Show more to see all images, or Show less to collapse it.
- More tint improves text contrast. Fill background crops the image; Show whole image keeps it fully visible.
- Use
/wallpaperin chat to switch images or turn wallpaper off. Escape cancels the picker. - Turn Show wallpaper off to restore the app's backgrounds without losing your choices.
- Turn Wallpaper slideshow on to cycle through all gallery images in order. Choose None or Fade in the transition dropdown and set Display time in seconds, from 5 to 86400. The default is 60 seconds. Slideshow needs at least two images, and fades respect reduced-motion settings.
To remove an upload, hover or focus its tile and click X. Remove folder images by moving or deleting their source files.
You can set an initial folder with an absolute path instead of choosing one in Settings:
{
"$schema": "https://opencode.ai/config.json",
"plugins": [
{
"package": "github:viralcodex/opencode-backdrop#v0.2.0",
"options": { "folder": "/absolute/path/to/wallpapers" },
},
],
}The folder chosen in Settings takes precedence over this option.
{ "$schema": "https://opencode.ai/config.json", "plugins": ["github:viralcodex/opencode-backdrop#v0.2.0"], }