Skip to content

Settings Personal

Taiizor edited this page Jun 5, 2026 · 3 revisions

Settings: Personal

The Personal settings page (PersonalSettingPage) controls the in‑app Store behavior, Library browsing experience, and a set of appearance/behavior tweaks for how wallpaper cards are laid out, previewed, sorted, and paginated. Most of these settings persist to Portal.json, with a few in Library.json (deletion behavior) and Engine.json (whether the Library/Store auto‑open on launch). Changing the Store Server clears the Store cache so the new backend's catalog is fetched fresh. This page is a pure reference — every setting, its key, file, default, and range.

Contents

Where to find it

In the Portal, open Settings (top toolbar gear) → Personal (icon PersonLock16).

Sucrose Portal — Personal settings page

Store

Setting Control Key JSON file Default Range / options Effect
Store Server ComboBox StoreServerType Portal.json Soferity GitHub, Soferity Selects the Store backend; switching clears the Store cache (Store.json, Pattern.json)
Store Duration (cache hours) NumberBox StoreDuration Portal.json 3 1–24 How long the downloaded store catalog is cached before refresh
Store start on app launch ToggleSwitch StoreStart Engine.json true true / false Opens the Store page automatically when the Portal launches
Adult content ToggleSwitch StoreAdult Portal.json true true / false Shows adult wallpapers/categories in the Store

Library

Setting Control Key JSON file Default Range / options Effect
Delete confirm ToggleSwitch DeleteConfirm Library.json true true / false Asks for confirmation before deleting a library wallpaper
Delete corrupt ToggleSwitch DeleteCorrupt Library.json false true / false Auto‑deletes corrupt/incomplete library entries on load
Library start on app launch ToggleSwitch LibraryStart Engine.json true true / false Opens the Library page automatically when the Portal launches

Appearance & Behavior — previews

Setting Control Key JSON file Default Range / options Effect
Store preview ToggleSwitch StorePreview Portal.json false true / false Animated hover preview on Store cards
Store preview hide ToggleSwitch StorePreviewHide Portal.json false true / false Hides the static thumbnail while the hover preview plays
Library preview ToggleSwitch LibraryPreview Portal.json false true / false Animated hover preview on Library cards
Library preview hide ToggleSwitch LibraryPreviewHide Portal.json false true / false Hides the static thumbnail while the hover preview plays

Appearance & Behavior — adaptive layout

Setting Control Key JSON file Default Range / options Effect
Adaptive margin NumberBox AdaptiveMargin Portal.json 5 5–25 Margin between cards in the Library/Store grid
Adaptive layout NumberBox AdaptiveLayout Portal.json 0 0–100 Max items per row; 0 = automatic

Appearance & Behavior — sorting & pagination

Setting Control Key JSON file Default Range / options Effect
Sort mode ComboBox LibrarySortMode Portal.json Creation Name, Creation, Modification The field the Library is sorted by
Sort kind ComboBox LibrarySortKind Portal.json Descending Ascending, Descending Sort direction
Store pagination NumberBox StorePagination Portal.json 30 1–100 Items shown per Store page
Library pagination NumberBox LibraryPagination Portal.json 30 1–100 Items shown per Library page

Notes

  • Switching the Store Server between GitHub and Soferity clears the cached catalog (Store.json and Pattern.json under %AppData%\Sucrose\Cache\Store) so the next browse downloads the new backend's listing. The GitHub backend cannot be used to publish wallpapers — only browse/install. See Using-Store.
  • Hover previews can increase CPU/GPU load while you browse, since they animate the wallpaper thumbnail; leave them off on low‑power machines.
  • Adaptive layout = 0 lets the grid fit as many cards per row as the window width allows; set a fixed number to force a column count.
  • Delete corrupt runs on Library load, so an incomplete import (e.g. a half‑downloaded package) may be removed automatically when the page refreshes.

See also

Home

Getting Started

Wallpaper Types

Using Sucrose

Settings Reference

Creating Wallpapers

Engine Reference

Automation & Command Line

Architecture & Internals

Data, Files & Diagnostics

Building & Contributing

Help & Support

Clone this wiki locally