Uninstalling Sucrose

Uninstalling Sucrose

Sucrose uninstalls cleanly through Windows Apps & Features, which runs the dedicated uninstaller Sucrose.Undo.exe. The uninstaller terminates all Sucrose processes, deletes the install and (optionally) data folders, removes the desktop and Start Menu shortcuts, restores any desktop icons it had hidden, deletes its registry key, and then self-deletes via a temporary batch file. You can also uninstall through whichever package manager you installed with. This page covers each method and exactly what gets removed. For the internal flow, see Undo Internals.

Table of contents

• Uninstall via Apps & Features
• The Yes / No / Cancel prompt
• Uninstall via package managers
• Silent uninstall
• What gets removed
• See also

---

Uninstall via Apps & Features

1. Open Settings → Apps → Installed apps (or the classic Apps & Features).
2. Find Sucrose Wallpaper Engine and choose Uninstall.

Windows reads the UninstallString from HKCU\Software\Microsoft\Windows\CurrentVersion\Uninstall\Sucrose (Sucrose installs per-user, so the uninstall entry is under HKCU) and runs %LocalAppData%\Sucrose\Sucrose.Undo\Sucrose.Undo.exe.

---

The Yes / No / Cancel prompt

When Sucrose.Undo.exe runs with no arguments (the interactive case), it plays a notification sound and shows a localized Yes / No / Cancel dialog:

Choice	Result
Yes	Remove the app and delete your user data (%AppData%\Sucrose — settings, library, logs, cache, showcase).
No	Remove the app but keep your user data.
Cancel	Abort; nothing is removed.

Choose No if you might reinstall and want to keep your library and settings; choose Yes for a complete removal.

---

Uninstall via package managers

If you installed with a package manager, uninstall the same way. These ultimately resolve to the same UninstallString (the Sucrose.Undo.exe uninstaller):

Manager	Command
Chocolatey	choco uninstall sucrose
Scoop	scoop uninstall sucrose
WinGet	winget uninstall Taiizor.SucroseWallpaperEngine

• Chocolatey reads HKCU:\Software\Microsoft\Windows\CurrentVersion\Uninstall\Sucrose → UninstallString and runs it.
• Scoop runs (Get-ItemProperty HKCU:\SOFTWARE\Microsoft\Windows\CurrentVersion\Uninstall\Sucrose).UninstallString.

---

Silent uninstall

Heads up: As of the current code there is no working silent uninstall. The registry QuietUninstallString stores "<Uninstall>" -s, but running Sucrose.Undo.exe -s does not remove anything. The uninstaller doesn't parse arguments — passing -s simply skips the Yes / No / Cancel prompt, leaves the internal result as Cancel, and exits immediately without terminating processes, deleting folders, removing shortcuts, or deleting the registry key.

To actually uninstall, run Sucrose.Undo.exe with no arguments and choose Yes or No in the dialog (see The Yes / No / Cancel prompt):

"%LocalAppData%\Sucrose\Sucrose.Undo\Sucrose.Undo.exe"

(If true silent support is intended, the uninstaller in App.xaml.cs must be changed to perform removal when -s is supplied.)

---

What gets removed

When you confirm with Yes or No, Sucrose.Undo.exe:

1. Terminates all Sucrose* processes (two passes, one second apart) — the Launcher, Portal, services, and the running render engine.
2. Restores desktop icon visibility and refreshes the desktop (undoing the "hide desktop icons" option if it was on — v26.6.4.0 added restoring previously hidden desktop icons).
3. Deletes the install path %LocalAppData%\Sucrose (preserving the still-running Undo and Sucrose.Runtime folders, which are cleaned up afterward).
4. Deletes user data %AppData%\Sucrose — only when you chose Yes.
5. Removes shortcuts — the Desktop and Start Menu Sucrose Wallpaper Engine.lnk.
6. Deletes the uninstall registry key HKCU\Software\Microsoft\Windows\CurrentVersion\Uninstall\Sucrose.
7. Self-deletes — writes a temporary batch file in %TEMP% (del_<guid>.bat) that kills the uninstaller, waits, then removes the install / runtime / uninstall folders and finally deletes itself.

The auto-start mechanism is a Windows Task Scheduler task named Autorun for Sucrose (not a registry Run entry). A full uninstall removes Sucrose; if you only want to stop it launching at logon, see Theme, Tray & Startup and Troubleshooting Settings, Startup & GPU.

---

See also

• Undo Internals — the uninstaller flow in detail.
• Installation — reinstall or move to another channel.
• Data Locations — what lives in %AppData%\Sucrose and %LocalAppData%\Sucrose.
• Backup, Restore & Reset — export your settings before uninstalling.
• Theme, Tray & Startup — disabling logon startup without uninstalling.