Settings tour
Open Settings from the tray icon, from the Start menu, or by launching Umbra a second time (a second launch opens Settings in the running copy). The window reopens where you left it: size, monitor, maximized state and last page.
| Page | What it does |
|---|---|
| General | Start with Windows, refresh interval, animations, appearance (corner radius, border, accent color or the Windows accent, interface font and size, light text, reduce transparency) and advanced options (log level, developer mode, GPU, startup delay, proxy). |
| My widgets | Turn each widget on or off, edit its options, size and opacity, lock it, give it its own refresh interval, schedule when it shows, add another copy or reset its position. Also where you start edit mode and approve or revoke widget commands. |
| Layouts | Save the arrangement of your widgets under a name, then apply, rename or delete it. Layouts can switch automatically when you dock or undock. |
| Browse | The community catalog: install, update or remove widgets in one click. Each card shows the hosts, notifications, media and commands a widget asks for. |
| Themes | Install community themes and switch between them live. |
| Hotkeys | Global shortcuts for edit mode, refresh, show/hide, peek and Settings. |
| Data & privacy | What each widget can reach and store, recent blocked requests, backup and restore, reset, and safe mode. |
| About | Version, update status (with release notes once after an update), source link, Copy diagnostics for bug reports and pre-filled issue links. |
Keyboard
Section titled “Keyboard”- Esc closes Settings.
- Ctrl+F or / jumps to the Browse search.
- Ctrl+1 to Ctrl+7 switch pages.
- The arrow keys move through the sidebar and the refresh interval.
Switches and buttons have names for screen readers.
Changes apply live
Section titled “Changes apply live”There is no Save button. Changing a setting updates widgets immediately, and settings.json in your data folder is written for you. Settings that need a restart say so: the proxy and hardware acceleration.
The tray menu
Section titled “The tray menu”The tray icon’s tooltip shows the widget count and whether edit mode or safe mode is on. A dot on the icon means an Umbra update is ready. The menu opens Settings, toggles edit mode, opens the data folder, restarts Umbra, and offers Undo for a widget copy you just removed.
The same settings from a script
Section titled “The same settings from a script”Everything in Settings is also available from umbractl and the MCP server, for example umbractl general --refresh 120 and umbractl configure sp500 --scale 1.5.