-
Notifications
You must be signed in to change notification settings - Fork 2
Wallpaper Settings
| Mode | Description |
|---|---|
| Per | Each monitor displays an independent wallpaper. |
| Duplicate | The same wallpaper is shown on all monitors. |
| Expand | One wallpaper spans across all monitors. |
Changing the arrangement mode restarts all running wallpapers and saves the new layout.
These settings control wallpaper behavior under specific system conditions. Each rule can be set to one of three values:
| Value | Effect on wallpaper |
|---|---|
KeepRun |
Continue playing normally. |
Silence |
Keep playing but mute audio. |
Pause |
Pause rendering and audio entirely. |
| Rule | Default | When it applies |
|---|---|---|
| App Focus | KeepRun |
A regular application window gains focus (not fullscreen). |
| App Fullscreen | Pause |
A fullscreen application is detected on the same monitor. |
| Battery Power | KeepRun |
The device is running on battery (not plugged in). |
| Power Saving | KeepRun |
Windows Battery Saver mode is active. |
| Remote Desktop | Pause |
A Remote Desktop session is detected. |
Status mechanism (StatuMechanism) controls the scope of rule enforcement:
| Value | Behavior |
|---|---|
Per |
Rules apply only to the wallpaper on the affected monitor. |
All |
Rules apply to all wallpapers simultaneously. |
Each wallpaper has a per-wallpaper effect configuration. Open the settings panel for a wallpaper to adjust:
| Property | Description |
|---|---|
| Saturation | Color richness (0.0 = grayscale, 1.0 = original, 3.0 = maximum). |
| Hue | Shift the color wheel (0–360°). |
| Brightness | Overall luminance (0.1–2.0). |
| Contrast | Tonal range (0.0–2.0). |
| Volume | Audio playback level (video and web wallpapers). |
| Speed | Playback speed multiplier (video wallpapers). |
| Scaling | How the wallpaper fits the display — see Scaling Modes below. |
Changes are previewed in real time. The configuration is saved per-wallpaper and restored automatically.
| Mode | Behavior |
|---|---|
fill |
Stretch to fill the display, ignoring aspect ratio. |
uniform |
Scale to fit entirely within the display, preserving aspect ratio (may leave bars). |
uniformFill |
Scale to cover the full display, preserving aspect ratio (may crop edges). |
none |
Display at original resolution, no scaling. |
auto |
Let the player choose based on content type. |
Audio only on desktop (IsAudioOnlyOnDesktop) — when enabled, wallpaper audio plays only while the desktop has focus. Any foreground application automatically silences the wallpaper audio. Useful for ambient audio wallpapers that should not compete with application sound.
The mapping of wallpaper → monitor is saved automatically as a WallpaperLayout list and restored on next launch. If a monitor that was in the saved layout is no longer connected, its entry is ignored until the monitor is reconnected.
Any Still Image or Motion Picture wallpaper can be applied directly as the Windows lock screen background. The feature writes the image path to the Windows lock screen registry key — no external tool required.