Update or Uninstall Local Waifu
Update or uninstall the app without accidentally deleting her data.
Follow the bold button names and numbered steps. Technical names are included only when you need to recognize a model or file inside the app.
Update the Direct edition
Goal
Install an available Direct-edition update without risking known-bad local data.
Before you start
- Create a backup with Settings → Advanced → Make a backup.
- On macOS, check the Data health indicator in the same Backup & safety section. On Windows the Data health readout is in the block headed Make a backup.
- Connect to the internet.
- Note the platform differences: on both platforms updates are included with a license and the trial does not receive them. On macOS the installer also runs a data-health check first and blocks the install if it fails. On Windows the installer does not run that check before installing, although Data health is shown in Settings → Advanced.
Steps: macOS
- Open Settings → General.
- Under Updates, find the row Check for updates and select Check Now. The switch Check at launch above it controls whether the app looks for a new version when it starts. Nothing is downloaded or installed without asking you.
- If a newer version appears, read the version number.
- Select Install & Restart.
- Wait for the download and allow the app to close and relaunch.
- Open Settings → About and verify the new version.
Steps: Windows
- Open Settings → General.
- Under Updates, read Current version and select Check for updates. The switch Auto Update controls the check at launch.
- If a newer version appears, read the version number.
- Select Download v and wait for the download to finish.
- Select Update now. The app closes so the installer can replace its files.
- Start Local Waifu again and open Settings → About to verify the new version.
Expected result
The update installs only after your confirmation and leaves the app on the newer version. On macOS the install also waits for the pre-update database and encryption-metadata safety checks to pass; on Windows those checks are not part of the update flow, which is why the backup in the first step matters more there. The Windows installer that the app downloads is always the Direct build from the official release; the Store/Unlocked edition has no in-app update route.
If something goes wrong
- On macOS, if Data health fails or installation is blocked, do not force the update. Make a backup and contact support.
- On both platforms a trial cannot use the in-app update route (Updates are included with a license); use the supported download route for your entitlement.
- If the updater cannot connect, check proxy, firewall, VPN, and Offline Mode, then use Download the latest version manually if shown.
- Nothing installs merely because the check at launch is enabled. Download and installation require user action: the launch notification offers one Install action, and the installer cannot be started twice.
- On Windows, if Update now fails or the installer does not open, download the Direct installer from the official release page and run it. That path also installs over an existing copy.
Update the Store/Unlocked edition
Goal
Keep the Store/Unlocked build on its own distribution channel.
Before you start
The Store/Unlocked build has no Direct-edition updater, license tab, or Direct release-channel access.
Steps
- Create a backup.
- Check the store or client from which you obtained Local Waifu, such as itch.io or the itch app.
- Download or install the update through that same channel.
- Do not replace it with a Direct build merely to obtain the Direct updater.
- After updating, open Settings → About and verify the version.
Expected result
The Store/Unlocked edition remains license-free and continues using its correct update channel.
If something goes wrong
Confirm that the downloaded installer is the Store/Unlocked build. If the update unexpectedly presents a trial, license field, or paywall, stop and obtain the correct store build before changing data.
Uninstall while keeping your data
Goal
Remove the application while preserving data for later reinstallation.
Before you start
Create a backup. A Direct license has no device limit, so there is nothing to deactivate before you uninstall. If you are selling or giving the computer away, follow the wipe steps in Chapter 45.
Steps: macOS
- Quit Local Waifu.
- Move Local Waifu from Applications to the Trash.
- Do not delete
~/Library/Application Support/com.lumizone.localwaifu/.
Steps: Windows
- Quit Local Waifu and wait for its local engine processes to stop.
- Open Settings → Apps → Installed apps → Local Waifu → Uninstall.
- Leave Delete the application data unselected if that option is offered.
Expected result
The program is removed while the app data remains available to a later installation.
If something goes wrong
If reinstallation starts as a blank app, do not overwrite or reset anything. Confirm that the original data directory still exists, preserve it, and contact support.
Remove Local Waifu and its data completely
Goal
Remove the application, local content, and saved credentials from a computer you no longer intend to use.
Before you start
This is destructive. Export characters and create an external backup first. The Direct license needs no deactivation, because there is no device limit.
Steps
- Remove cloud provider keys and connected-account credentials from their settings panels.
- Open Settings → Telegram and use Forget token + pin.
- Open Settings → Advanced → Developer Options, then find Reset Database, select Reset All, and confirm with Yes, delete. On Windows this leaves portraits, generated images, and voice references on disk; step 6 covers those.
- Restart the app once if you need to confirm the reset completed.
- Quit and uninstall Local Waifu using the platform procedure above.
- Delete the remaining Local Waifu data directory only after verifying your backup:
- macOS:
~/Library/Application Support/com.lumizone.localwaifu/ - Windows:
%APPDATA%\com.lumizone.localwaifu\
- macOS:
- Remove separately stored model files if you also want to reclaim their disk space.
Expected result
The application, user data, secrets, and optional model files are removed from the computer.
If something goes wrong
Reset All does not remove every credential by itself. In particular, license/trial data, cloud provider keys, and the Telegram token can remain in the secret store. That is why credentials must be removed explicitly and the remaining data directory deleted for a complete wipe.