Cache Management

Cache Management

Sucrose keeps all of its transient, regenerable data under %AppData%\Sucrose\Cache\. This includes the in-app Store catalog and downloaded themes, update downloads, crash reports, per-wallpaper saved properties, and each render engine's working data. This page maps the cache tree, explains the GIF/web download cache (30-day expiry, SHA1-named files), and shows how to clear the cache safely from the Portal.

Contents

• Where the cache lives
• Cache tree
• Subfolder reference
• The GIF / web download cache
• Engine working folders
• Clearing the cache
• What is safe to delete

Where the cache lives

%AppData%\Sucrose\Cache\

Everything under Cache\ is regenerable — Sucrose recreates whatever it needs on next use. Deleting the cache never affects your settings (in Setting\) or your wallpaper Library (in Library\). See Data-Locations for the full data map.

Cache tree

%AppData%\Sucrose\Cache\
├── Bundle\          update download cache (Sucrose.Update)
├── Store\           in-app Store cache:
│   ├── Store.json   store catalog snapshot
│   ├── Pattern.json store pattern data
│   ├── <Category>\<wallpaper>   downloaded store themes
│   └── Temporary\   store download temp; also the GIF download cache
├── Report\          crash reports: <Id>.json
├── Properties\      per-wallpaper saved property values
├── Gif\             Vexana GIF engine cache
├── MpvPlayer\       MpvPlayer engine profile/data + SucroseProperties.json
├── CefSharp\        CefSharp engine cache + SucroseProperties.json
└── WebView2\        WebView2 user-data folder + SucroseProperties.json

Subfolder reference

Subfolder	Written by	Contents	Notes
Bundle\	Sucrose.Update	Downloaded update packages	Cleared automatically over time; safe to clear when not updating. See Update-Internals.
Store\	Portal Store	Store.json, Pattern.json, downloaded themes per <Category>, and Temporary\	The Store catalog snapshot and your downloaded Store wallpapers. See Using-Store.
Store\Temporary\	Portal Store + GIF loader	Store download temp and the GIF download cache	See GIF / web download cache.
Report\	Watchdog / Reportdog	<Id>.json crash reports	See Crash-Reporting.
Properties\	Property service	Per-wallpaper saved customization values	Deleting reverts wallpapers to their default property values. See Property-Service and Customizing-Wallpaper.
Gif\	Vexana engine	GIF frame cache	See Engine-Vexana.
MpvPlayer\	MpvPlayer engine	mpv profile/data + SucroseProperties.json	See Engine-MpvPlayer.
CefSharp\	CefSharp engine	CEF browser cache + SucroseProperties.json	See Engine-CefSharp.
WebView2\	WebView engine	WebView2 user-data folder + SucroseProperties.json	See Engine-WebView.

The GIF / web download cache

GIF wallpapers loaded from a URL are cached by the Sucrose.XamlAnimatedGif library (UriLoader):

• The library's default download cache location is Path.GetTempPath(), but the Portal repoints it to %AppData%\Sucrose\Cache\Store\Temporary.
• Cache file names are SHA1 hashes of the source URL (so the same URL maps to the same cache file).
• The default cache expiry is 30 days — entries older than that are re-downloaded.

This means a remote GIF wallpaper does not re-download on every restart; it is served from the SHA1-named cache file until it expires. Clearing Store\Temporary\ forces a fresh download on next use.

Engine working folders

Each browser/video engine keeps its own working folder under Cache\ (CefSharp\, WebView2\, MpvPlayer\, Gif\). These hold the engine's browser/user-data cache plus, for the customizable engines, a SucroseProperties.json capturing the currently applied filter values. They are recreated automatically; clearing them resets the engine's cache (a browser wallpaper may reload more slowly the first time afterward). See Engines-Overview.

Clearing the cache

From the Portal, go to Settings → System. The System page exposes folder-clearing actions with live size hints:

Action	Removes
Clear Store temp	%AppData%\Sucrose\Cache\Store
Clear Cache	%AppData%\Sucrose\Cache (the entire cache tree)
Clear Log	%AppData%\Sucrose\Log

See Settings-System and Backup-Restore-Reset for the full set of maintenance actions. You can also delete folders under Cache\ manually while Sucrose is closed.

📷 Screenshot needed: Portal → Settings → System showing the Clear Cache / Clear Store actions with their live size hints.

What is safe to delete

Folder	Safe to delete?	Consequence
Cache\Bundle\	Yes	Update re-downloads if needed
Cache\Store\	Yes	Store catalog and downloaded themes re-fetch; downloaded Store wallpapers are removed
Cache\Store\Temporary\	Yes	GIF/web downloads re-fetch
Cache\Report\	Yes	Old crash reports removed
Cache\Properties\	Yes	Wallpapers revert to default customization values
Cache\Gif\, Cache\MpvPlayer\, Cache\CefSharp\, Cache\WebView2\	Yes	Engine caches rebuild on next use
Setting\	No (this is your config)	Use Backup-Restore-Reset instead
Library\	No (your installed wallpapers)	Wallpapers would be lost

See also

• Data-Locations
• Backup-Restore-Reset
• Using-Store
• Settings-System
• Crash-Reporting
• Engines-Overview