Settings System
The System Settings page (SystemSettingPage, the MenuSystem item in the Settings-mode navigation) is the maintenance console for Sucrose. Unlike the other Settings pages, it stores no toggles or values of its own — every card is an action (a button) that creates a log bundle, clears a cache folder, backs up/restores your settings, or performs a factory reset. Each card shows a live folder-size hint that refreshes every 3 seconds so you can see how much space a given folder is using before you clear it. All actions operate on the data folders under %AppData%\Sucrose\.
- Page summary
- Log maintenance
- Cache clearing
- Backup, restore, and reset
- What the folders contain
- Behavior notes
- See also
| Property | Value |
|---|---|
| Portal page |
SystemSettingPage (Setting6, icon PuzzleCube16) |
| Localization key | Portal.MainWindow.MenuSystem |
| JSON file | none (action-only page) |
| Areas | Log, Cache, Library, Backup, Reset |
| Dispatch | Most actions run through the Commandog process |
| Card | Action(s) | What it does |
|---|---|---|
| Log Temporary | Create / Delete |
Create saves a zip of the Log + Setting folders (excluding Objectionable.json, which holds the sensitive Personal Access Token) using Zip.Compress. Delete clears %AppData%\Sucrose\Log via the Commandog Temp command. |
The exported log bundle is named sucrose_log_yyyyMMdd_HHmmss.zip. Attach it when filing a bug report. See Logs-Diagnostics.
The log archive deliberately excludes
Objectionable.jsonso your Personal Access Token is not shipped in a support bundle.
Each "clear" card targets a specific on-disk folder:
| Card | Action | Folder cleared |
|---|---|---|
| Cache Temporary | Start (clear) | %AppData%\Sucrose\Cache |
| Store Temporary | Start (clear) | %AppData%\Sucrose\Cache\Store |
| Library Temporary | Start (clear) | the active library folder (Library.Location, default %AppData%\Sucrose\Library) |
Library Temporary clears your installed wallpaper library folder. Use it deliberately — it removes installed wallpapers, not just throwaway cache. For details on the cache subfolders and their expiry, see Cache-Management.
| Card | Action(s) | What it does |
|---|---|---|
| Setting Backup | Export / Import | A folder picker, then the Commandog Export / Import command. Export copies every *.json from %AppData%\Sucrose\Setting\ into the chosen folder. Import copies external *.json back into the Setting folder. |
| Setting Reset | Start | The Commandog Reset command — a factory reset that deletes every *.json in %AppData%\Sucrose\Setting\, restoring all defaults. |
All three operations (Export, Import, Reset) kill all Sucrose processes first, perform the file operation, then reopen the Portal on the System Settings page (via ArgumentCommandType.SystemSetting). Unlike the log bundle, Export does not exclude Objectionable.json -- it copies every *.json in the Setting folder verbatim, so a settings backup includes your Personal Access Token. Import and Reset apply no exclusion either; only the log-bundle path (Zip.Compress with an Excludes list) omits it. For the exact semantics see Backup-Restore-Reset.
The action cards operate on these paths:
| Path | Contents |
|---|---|
%AppData%\Sucrose\Setting\ |
All settings JSON files (General.json, Engine.json, Portal.json, etc.) |
%AppData%\Sucrose\Log\ |
Per-process date-stamped log files (<Process>-yy.MM.dd.log) |
%AppData%\Sucrose\Cache\ |
Update/store/report/engine caches |
%AppData%\Sucrose\Cache\Store\ |
Store catalog (Store.json, Pattern.json) and downloaded themes |
%AppData%\Sucrose\Library\ |
Installed wallpapers (the default library location) |
For the complete folder map, see Data-Locations.
- This page intentionally has no persisted settings; nothing here is written to a JSON key.
- Because backup/restore/reset terminate every Sucrose process, your active wallpaper stops and the Portal relaunches afterward — expect a brief flash.
- Hand-editing or restoring
Setting\*.jsonis safe to do while the app is closed; the settings managers self-heal a missing/empty/invalid file by resetting it to{ "Properties": {} }on next read. See Settings-Persistence. - The folder-size hints refresh roughly every 3 seconds, so the displayed sizes may lag a fast-growing cache by a moment.
- Settings-Overview — how the Settings pages map to JSON files
- Backup-Restore-Reset — full export/import/reset behavior
- Cache-Management — the cache tree and expiry rules
- Logs-Diagnostics — log locations and producing a bug-report bundle
- Data-Locations — the complete on-disk folder map
- Settings-All-Keys — every setting key across all pages