-
-
Notifications
You must be signed in to change notification settings - Fork 60
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.
- Where to find it
- Store
- Library
- Appearance & Behavior — previews
- Appearance & Behavior — adaptive layout
- Appearance & Behavior — sorting & pagination
- Notes
- See also
In the Portal, open Settings (top toolbar gear) → Personal (icon PersonLock16).

| 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 |
| 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 |
| 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 |
| 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 |
| 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 |
-
Switching the Store Server between
GitHubandSoferityclears the cached catalog (Store.jsonandPattern.jsonunder%AppData%\Sucrose\Cache\Store) so the next browse downloads the new backend's listing. TheGitHubbackend 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.
- Settings-Overview — how settings are stored and applied
- Using-Store — browsing, filtering, and installing from the Store
- Managing-Library — importing, sorting, and the card context menu
- Settings-General — language, startup, volume, and library location
- Settings-All-Keys — every setting in one master table
Getting Started
- Installation
- System Requirements
- Quick Start
- Portal Interface Tour
- Updating Sucrose
- Uninstalling Sucrose
Wallpaper Types
Using Sucrose
- Managing Library
- Using Store
- Customizing Wallpaper
- Multi-Monitor
- Wallpaper Cycling
- Choosing Engines
- Performance Rules
- Theme, Tray & Startup
- Discord Rich Presence
Settings Reference
- Settings Overview
- Settings: General
- Settings: Personal
- Settings: Performance
- Settings: Wallpaper
- Settings: System
- Settings: Other
- Settings: All Keys
Creating Wallpapers
- Create Overview
- Create: Step By Step
- Create: Package Format
- Create: Customization Controls
- Create: JS Bridge
- Create: Audio API
- Create: System API
- Create: Property Listener & Filters
- Create: Web Architecture
- Create: Compatibility
- Create: Example Wallpapers
- Create: Sharing & Publishing
Engine Reference
- Engines Overview
- Engine: MpvPlayer
- Engine: VlcPlayer
- Engine: WebView
- Engine: CefSharp
- Engine: Nebula
- Engine: Vexana
- Engine: Xavier
- Engine: Aurora
- Engine Comparison
Automation & Command Line
Architecture & Internals
- Architecture Overview
- Lifecycle
- Commandog Dispatcher
- Single-Instance Mutexes
- IPC
- Backgroundog Service
- Crash Reporting
- Update Internals
- Property Service
- Undo Internals
Data, Files & Diagnostics
Building & Contributing
- Building From Source
- Repository Layout
- Shared Item Projects
- Code Conventions
- Preprocessor Symbols
- Publish Pipeline
- Bundle Installer Internals
- Extending Sucrose
- Contributing
- Translating with Localizer
- Localization Coverage
- Security Policy
- Privacy & Telemetry
Help & Support