Tray icon reference¶
What every entry in the bridge's tray menu does. The bridge itself runs silently in the system tray (small monitor icon with five RGB pads underneath); all day-to-day work happens through the Configurator opened from this menu.
Right-click the tray icon to open the menu. Left-click runs the default action (Configurator).
Top level¶
| Entry | What it does |
|---|---|
| Configurator… (default click) | Opens http://127.0.0.1:17320/configurator in your default browser. Main UI — per-screen tabs for background / glow / effects / widgets, drag-and-resize layout preview, live settings push back to the wallpaper. See the Configurator section below. |
| Build Wallpaper… | Opens http://127.0.0.1:17320/builder — the in-browser editor for carving transparent regions out of any image. See building-wallpapers.md. |
| 🔓 Lock / 🔒 Unlock widgets (all screens) | One-click toggle that flips widgetsLocked on every active screen. Mirrors the lock-bar at the top of the Configurator's Widgets section. When unlocked, widgets can be dragged + resized on the live wallpaper and in the Configurator preview. |
| Advanced (submenu) | Power-user stuff pushed out of the default menu — see below. |
| Updates (submenu) | In-app update checker + the "Allow beta versions" toggle — see below. |
| About… | Standalone window with version, GitHub link, maintainer + avatar, open-source-credits link, and a "Buy me a coffee" PayPal button. |
| Quit | Hard-stops the bridge process. Wallpaper pages disconnect; the SignalRGB plugin keeps trying to send UDP but with nothing listening. Re-launch the exe to resume. |
When a newer release is published, an extra ⬆ Update available: vX.Y.Z — open release page entry appears at the top of the menu.
Advanced submenu¶
| Entry | What it does |
|---|---|
| Quick add widget (submenu) | Per-screen submenu that mirrors the Configurator's Add a widget picker grid. Same eleven types, plus an Edit widgets toggle and a "Currently placed: N" status line. |
| Quick effects (submenu) | Per-screen submenu with radio lists for ambient preset (off / snow / rain / sparks / aurora), tint-with-glow toggle, and pixelfx mode (off / trail / glow / ripple / all). Same state as the Configurator's Effects section. |
| Reload config | Re-reads %LOCALAPPDATA%\SignalRGBWallpaper\config.json from disk. Useful if you edited it by hand or are debugging settings sync. Pushes the reloaded state to all connected wallpaper pages. |
Updates submenu¶
| Entry | What it does |
|---|---|
| Check for updates now | Manual trigger. Hits GitHub Releases API; refreshes the menu with a "Latest: vX.Y.Z — open release page" entry if newer. |
| Enable update checks (checkbox) | Master switch (default on). When off, the daily background poll is suspended. |
| Allow beta versions (checkbox) | Default off. When on, prerelease tags participate in the comparison. Semver-aware — 0.7.0-beta < 0.7.0, so stable users won't get downgraded to a beta. |
| Status line | One of: Up to date — last checked Xm ago · Latest: vX.Y.Z — open release page · Last check failed: … · Not yet checked. |
| Installed: vX.Y.Z | Read-only indicator of the running bridge version. |
The Configurator¶
The Configurator is the in-browser UI served at
http://127.0.0.1:17320/configurator. Per-screen tabs at the top
(Screen 1 / 2 / 3 / 4 — only the ones up to your screen count are
useful). Each tab has four collapsible sections.
Background¶
| Control | What it does |
|---|---|
| Image path | Direct path to your background image (PNG / JPG / WebP / SVG). Editable text field — paste a URL or absolute path. |
| Choose image… | File picker; the bridge converts to PNG and stores it under %LOCALAPPDATA%\SignalRGBWallpaper\screens\screen-N-<timestamp>.png. |
| Open Builder… | Opens the in-browser builder in a new tab — for cutting transparent regions out of an image. |
| Fit | cover (crop to fill — default), contain (letterbox), fill (stretch). |
| Dim | Black overlay opacity, 0–100 %. Useful when a bright background drowns out the glow. |
Glow¶
| Control | What it does |
|---|---|
| Show glow layer | Master on/off for the SignalRGB-driven glow layer. |
| Layout | Pixel grid (default), vertical stripes, horizontal stripes, centered pills, hidden. |
| Strength | Multiplier for the glow's overall brightness/blur, 0–200 %. |
| Grid blur | Blur radius in CSS pixels for the pixel-grid layout (default 30 px). Larger = softer / more diffuse glow. |
| Stripes blur | Same for the stripes layout (default 60 px). |
Effects¶
| Control | What it does |
|---|---|
| Ambient preset | Five tiles: Off / Snow / Rain / Sparks / Aurora. Each except Off shows a live mini-canvas preview running the actual preset. Click to apply. |
| Tint particles with the live glow colour | When on, the particle colours track the live SignalRGB-feed average. Off by default. |
| Density | 1–100, controls particle count / saturation. Default 60. |
| Pixelfx (cursor) | Mouse-trail / hover-glow / click-ripple / all combined. Trail and glow work under Lively click-through (cursor pos is pushed by the host); ripple needs real clicks (toggle Wallpaper interaction in Lively). |
| 3D parallax | Background image slides against the cursor for a fake-depth effect, 0–120 px max-displacement. 30 ≈ subtle, 80 ≈ dramatic. Uses Lively's livelyCurrentCursorPos + a DOM mousemove fallback. |
Widgets¶
| Control | What it does |
|---|---|
| Lock-bar | Big toggle at the top with a colored status dot. Locked = read-only; unlocked = drag + resize active on the wallpaper and in the layout preview. |
| Layout preview | Scaled rectangle of the screen (auto-fits to the reported viewport, falls back to 1920×1080 if no wallpaper is connected yet). Each widget is a draggable + resizable box. Drop = persisted via WebSocket. |
| Snap to grid | Toggle + step picker (10 / 20 / 40 / 80 px). When on, drag + resize snap to the grid and the preview overlays the snap grid in accent blue. State persists in browser localStorage. |
| Widget list | Per-widget rows showing icon + label + a short description. Configure opens a form modal (per-type options schema, no more prompts). Remove deletes the widget. |
| Add a widget | Picker grid with all eleven registered widget types (clock, calendar, weather, sticky-note, countdown, picture, quote, CPU meter, RAM meter, audio spectrum, network — well, network is hidden but the registry slot is there). Click to add at the type's default position; the widget appears on the live wallpaper immediately. |
Where settings live¶
%LOCALAPPDATA%\SignalRGBWallpaper\config.json— main config: per-screen settings array, screen count, language, update-check flags. Updated on every settings change.%LOCALAPPDATA%\SignalRGBWallpaper\screens\screen-N-<timestamp>.png— any background image uploaded through the Configurator or the Builder. Old timestamps get pruned on the next upload.HKCU\Software\Microsoft\Windows\CurrentVersion\Run\SignalRGBWallpaperBridge— autostart entry (set by the installer when the matching task is checked). Remove it with the uninstaller or delete the value by hand.
Localisation¶
The whole tray menu + About dialog respect the language config key
(auto / en / de). auto (default) picks from your Windows locale.
Override by editing config.json:
The Configurator picks up the active language on its first WebSocket push from the bridge and re-localises live without a reload.
Builder window strings are also DE / EN since v0.7.4-beta; it fetches
the active language from the bridge's GET /config endpoint on load
and applies it to all labels + toast messages.