Settings General

Settings: General

The General settings page (GeneralSettingPage) is the first Settings page in the Portal. It groups the everyday options most users touch: application language, how Sucrose starts with Windows, the tray/notify‑icon and close behavior, the window backdrop and background image, engine audio volume, and the location of your private wallpaper library. Settings on this page are spread across four JSON files (General.json, Portal.json, Engine.json, Library.json) because Sucrose groups settings by topic rather than by page. Every value below applies live; most volume and backdrop changes take effect immediately, and changing the library location can move your existing files.

Contents

• Where to find it
• Appearance & Behavior
• Sound
• Library
• Notes
• See also

Where to find it

In the Portal, click the Settings gear in the top toolbar, then choose General (icon WindowApps16). See Portal-Interface-Tour for the navigation layout.

Appearance & Behavior

Setting	Control	Key	JSON file	Default	Range / options	Effect
Application Language	ComboBox	Culture	General.json	current UI 2‑letter ISO	one entry per shipped UI language	Switches the Portal/app language and re‑applies it live via the culture service
Application Startup	ComboBox	RunStartup	General.json	0 (None)	0=None, 1=Normal, 2=Priority (admin), 3=Scheduler	Configures autostart‑on‑login; drives the Commandog Startup / StartupP / Scheduler commands (clamped 0–10)
Notify Icon visibility	ComboBox	AppVisible	General.json	true (Show)	Show / Hide	Shows/hides the tray icon; sends the Launcher a Show / Hide signal
Notify → Exit on close	CheckBox	AppExit	General.json	false	true / false	When true, closing the window exits the app instead of minimizing to the tray
Window Backdrop	ComboBox	BackdropType	Portal.json	None	every WindowBackdropType; Mica/Acrylic require Windows 11	Sets the Portal window material; unsupported entries are disabled
→ Background image	Button (file picker)	BackgroundImage	Portal.json	(empty)	image file path	Live‑previews an image behind the window; a remove button clears it
→ Backdrop stretch	ComboBox	BackgroundStretch	Portal.json	(default UniformToFill)	None / Fill / Uniform / UniformToFill	How the background image fills the window
→ Backdrop opacity	NumberBox	BackgroundOpacity	Portal.json	100	0–100 (%)	Opacity of the window backdrop/background image

The application theme (light/dark) is not on this page — it is toggled from the top toolbar and stored as ThemeType in General.json. See Theme-Tray-Startup.

Sound

Setting	Control	Key	JSON file	Default	Range / options	Effect
Engine Volume	Slider	WallpaperVolume	Engine.json	100	0–100	Master volume for wallpaper audio (video/web/YouTube)
→ Play on desktop	CheckBox	VolumeDesktop	Engine.json	false	true / false	Mute unless the desktop is shown
→ Mute when other audio active	CheckBox	VolumeSilent	Engine.json	false	true / false	Silences wallpaper audio when another app is playing sound
→ Volume sensitivity	NumberBox	VolumeSilentSensitivity	Engine.json	5	1–10	Threshold for the "mute when other audio active" detection

Library

Setting	Control	Key	JSON file	Default	Range / options	Effect
Private Library location	Button (folder picker)	Location	Library.json	%AppData%\Sucrose\Library	any folder path	Where installed wallpapers are stored; can relocate existing files
→ Move library files	CheckBox	Move	Library.json	true	true / false	When on, changing the location moves existing files; the target folder must be empty

Notes

• Startup modes chain into Windows autostart: Normal uses the current user's run mechanism, Priority runs elevated (admin), and Scheduler registers the Task Scheduler task Autorun for Sucrose. Autostart is not a registry Run entry — to remove a stuck autostart, delete that scheduled task. See Troubleshooting-Settings-Startup-GPU.
• Notify Icon vs. Exit on close interact: AppVisible controls whether the tray icon exists, while AppExit controls whether the window's close button exits the app or minimizes it to the tray. The Launcher process owns the actual tray icon; the Portal just sends it Show/Hide signals.
• Mica / Acrylic backdrops require Windows 11; on Windows 10 those options are disabled and the window falls back to a solid backdrop.
• Changing the Private Library location with Move enabled relocates all installed wallpapers; the destination must be empty before the move.

See also

• Settings-Overview — how settings are stored and applied
• Theme-Tray-Startup — theme, tray icon, and startup modes in depth
• Managing-Library — importing and organizing wallpapers
• Settings-Personal — store, preview, sorting, and pagination options
• Settings-All-Keys — every setting in one master table