Set a custom background image for the Agent Zero UI. Upload any image and it renders as a subtle, blurred, or vivid backdrop behind the entire interface — including the homepage and all chat sessions.
- 🖼️ Upload any image — PNG, JPG, WEBP, GIF, AVIF, BMP supported
- 🎚️ Opacity control — 0–100% so your image stays subtle or bold
- 🌫️ Blur control — 0–20px frosted-glass effect
- 📐 Fit modes — Cover (fill), Contain (letterbox), or Auto (original size)
- 🔄 Live preview — changes apply instantly without page reload
- 🏠 Full UI coverage — applies to homepage and all chat views
- 🔌 Enable/disable toggle — switch off without losing your uploaded image
- Open Agent Zero → Settings → Plugins
- Find Background Changer and enable it
- Hard-reload the browser (
Ctrl+Shift+R/Cmd+Shift+R) - Open Settings → Developer → Background Changer
- Upload — drag and drop an image onto the upload zone, or click to browse
- Adjust — use the Opacity and Blur sliders to get the look you want
- Fit — choose Cover, Contain, or Auto from the Fit Mode dropdown
- Toggle — use the On/Off switch to enable or disable without removing the image
- Remove — click the red Remove button to delete the current image and reset
Settings are stored locally in bg_config.json inside the plugin directory. No external services or API keys required.
| Setting | Default | Description |
|---|---|---|
enabled |
true |
Whether the background is active |
opacity |
0.15 |
Background opacity (0.0 – 1.0) |
blur |
0 |
Background blur in px (0 – 20) |
size |
cover |
CSS background-size value |
position |
center center |
CSS background-position value |
MIT — see LICENSE