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
├── SignalT\         file-based signal IPC channel (Launcher + Backgroundog, transient .sgnl files)
├── Content\         engine local HTTP server content for web wallpapers (WebView/CefSharp)
├── Gif\             Vexana GIF engine cache
├── MpvPlayer\       MpvPlayer engine profile/data + SucroseProperties.json
├── VlcPlayer\       VlcPlayer engine working 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.
SignalT\	Launcher + Backgroundog	Transient .sgnl signal files	File-based signal IPC channel; files are short-lived and regenerated at runtime.
Content\	WebView / CefSharp engines	Files served by the engine's local HTTP server	Local content for web wallpapers; recreated automatically.
Gif\	Vexana engine	GIF frame cache	See Engine-Vexana.
MpvPlayer\	MpvPlayer engine	mpv profile/data + SucroseProperties.json	See Engine-MpvPlayer.
VlcPlayer\	VlcPlayer engine	libVLC working data + SucroseProperties.json	See Engine-VlcPlayer.
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\, VlcPlayer\, 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\SignalT\, Cache\Content\	Yes	Both are regenerated at runtime; clear only while wallpapers are stopped
Cache\Gif\, Cache\MpvPlayer\, Cache\VlcPlayer\, 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