Repository navigation
Settings and Data
WMT is portable. Its configuration and generated data live in a data folder next to the executable or WMT-GUI.ps1, not in the registry or your Documents folder. This page explains what is stored, how settings are saved, and how to back up or reset the data safely.
WMT resolves the data path in this order:
- The folder that contains the running EXE or script.
- The current working directory if the launch path cannot be determined.
It creates data on demand:
<WMT folder>\data
Examples:
C:\Tools\WindowsMaintenanceTool\data
C:\Users\you\Downloads\git\Windows-Maintenance-Tool\data
If the WMT folder is read-only (for example, under Program Files), creating or saving files in data can fail. Keep WMT in a writable folder.
Most files live in the data folder next to WMT. Compact recompression state is an exception: it lives in a secured ProgramData folder so the SYSTEM scheduled task can use it. Exact contents depend on the features you use.
| File or folder | Created by | Purpose |
|---|---|---|
settings.json |
Settings changes | Main configuration file |
settings.json.bak |
Settings save | Previous valid settings copy |
last-crash.txt |
Crash handler | Last captured WMT error and context |
winapp2.ini, winapp3.ini
|
Cleaner rule refresh | Cached community cleaner definitions |
cleanerml_cache.json |
Cleaner rule refresh | Parsed CleanerML rule cache |
cleaner-refresh-last.json |
Cleaner refresh | Timestamp/status of the last rule refresh |
cleaner-auto-last.json |
Automatic cleaning | Result of the last automatic clean |
RegistryBackups\ |
Registry cleaner |
DeepClean_Backup_*.reg, DeepClean_Skipped_*.log, HKLM_Backup_*.reg
|
hosts_backups\ |
AdBlock update | Timestamped hosts backups |
hosts_bk_*.bak |
Hosts Backup | Manual hosts backup |
RouteTable.txt |
Save Routes |
route print output |
firewall_rules_*.wfw |
Firewall Export | Exported firewall policy |
Installed_Drivers.txt |
Driver report | Readable installed-driver list |
Driver_Store_Packages.csv |
Driver report | Machine-readable driver package list |
DriverBackup_* / Drivers_Backup_*
|
Driver export | Exported driver packages |
package-install-logs\ |
Provider Log files | Install and diagnostic transcripts |
ProgramData\WindowsMaintenanceTool\compact-tracker.json |
Compact Compression | Tracked targets and recompression state; the worker script and logs are in the same secured folder |
steam_library.json, steam_applist.json
|
Library cache | Steam inventory cache |
legendary_library.json, legendary-games, legendary-launchers
|
Library cache | Epic/Legendary inventory and launch data |
gog_library.json, gogdl_installs.json, gog-games, gogdl-launchers
|
Library cache | GOG inventory and tracked installs |
legendary\ |
Provider install | WMT-managed Legendary executable and files |
gogdl\ |
Provider install | WMT-managed GOGDL executable, auth.json, and files |
MyDevice_*.txt |
My Device Export | Device summary |
DiskUsage_*.txt |
Disk Usage Export Report | Disk usage report |
Additional files can appear when a provider, report, or backup feature is used.
settings.json is a UTF-8 JSON object. WMT uses an ordered dictionary so the key order stays stable between saves.
Common keys and defaults:
| Key | Default | Meaning |
|---|---|---|
Theme |
dark |
UI theme |
WindowState |
Normal |
Main window state |
WindowBounds |
1280 x 820 | Main window position and size |
SubwindowBounds |
{} |
Remembered tool-window sizes |
RememberSubwindowBounds |
true |
Restore tool-window sizes |
RunInTrayOnClose |
false |
Hide to tray instead of exiting |
ReduceRamInTray |
true |
Aggressive low-memory tray mode |
LaunchMinimized |
false |
Start hidden in the tray |
DisableBackgroundJobs |
false |
Turns off background refresh work |
UpdateScansDisabled |
false |
Disables automatic and tray update scans |
UpdateAutoScanMinutes |
0 |
Auto-scan interval; 0 is disabled |
UpdateNotificationsEnabled |
true |
Native update notifications |
UpdateSilentInstallEnabled |
false |
Experimental headless update commands |
UpdateAutoInstallEnabled |
false |
Install updates automatically after scans |
WingetIncludeUnknown |
true |
Add --include-unknown to Winget scans |
WingetIgnore |
["228980"] |
Ignored package IDs |
HideCrossProviderDuplicates |
false |
Hide unknown-version Winget game duplicates |
CustomUpdateCommands |
[] |
Saved per-package update commands |
EnabledProviders |
All supported providers | Providers included in scans |
ProviderToggles |
{} |
Per-provider Search/Scan/Logs/Headless/Auto settings |
ProviderExecutionOverrides |
{} |
Per-provider execution overrides |
WuCategoryToggles |
{} |
Windows Update category selections |
RegistryScan |
{} |
Saved registry scan target states |
TempCleanup |
{} |
Saved cleaner selections and options |
LoadWinapp2 / LoadWinapp3
|
false |
Community cleaner rule sets |
LoadCleanerML / LoadCleanerMLPending
|
false |
CleanerML and pending rules |
SkipRuleDownloads |
false |
Use cached rules only |
CacheOnly |
false |
Skip cache validation |
CleanerLocalRefreshMinutes |
60 |
Local cleaner cache refresh interval |
CleanerRemoteCheckMinutes |
1440 |
Upstream rule check interval |
CleanerAutoCleanMinutes |
0 |
Automatic clean interval; 0 is off |
CustomDnsServers |
[] |
Saved custom DNS addresses |
CustomDohTemplate |
"" |
Saved DoH template URL |
CustomDohEnabled |
false |
Whether the custom DoH template is registered |
HideLegendaryUeAssets |
true |
Hide Unreal/Fab assets in the library |
Keys are added over time. Missing keys are filled with defaults when settings load.
WMT writes settings carefully:
- Serialize the complete settings object.
- Write a temporary file.
- Validate that the temporary file can be read back and contains required keys.
- Replace
settings.json. - Keep the previous file as
settings.json.bak.
If settings.json is empty, unreadable, or invalid at startup, WMT tries settings.json.bak. A recovered file is logged to the activity log. If both files are unusable, WMT falls back to defaults.
Do not edit settings.json while WMT is running; the next save overwrites your changes. Close WMT before manual edits.
- The Activity Log in the main window is in-memory. It is cleared when WMT exits.
-
last-crash.txtis written when WMT captures an unhandled error. It includes a timestamp, context, exception details, and recent log lines. - Debug Logs adds extra internal diagnostics but does not create a persistent full activity log.
- Provider Log files keeps install and diagnostic transcripts under
data\package-install-logs.
Logs can contain usernames, file paths, package IDs, server names, and IP addresses. Review them before posting.
WMT does not store Windows passwords. Some integrations keep authentication material:
| Integration | Where credentials live |
|---|---|
| Epic / Legendary | Legendary's config root: %USERPROFILE%\.config\legendary\user.json, or LEGENDARY_CONFIG_PATH if set. WMT's managed executable is in data\legendary, but the login token is in Legendary's config |
| GOG / GOGDL |
data\gogdl\auth.json; WMT can copy a valid auth.json from Heroic Games Launcher |
| Steam | Steam's own installation and appmanifest_*.acf files; WMT only reads them |
| WinGet, Chocolatey, Scoop, npm, pip, and similar | The provider's own configuration and credential stores, outside data
|
| GitHub / release downloads | No stored credential; downloads use normal HTTPS |
Protect the data folder accordingly. auth.json and user.json can grant account access.
To keep settings and caches:
- Exit WMT completely, including the tray icon.
- Copy the entire
datafolder to a safe location. - Keep the executable or script and the
datafolder together when moving WMT.
You can back up only settings.json if you care about configuration but not caches, logs, or backups. Do not restore an old settings.json over a newer one without closing WMT first.
- Exit WMT.
- Rename
settings.jsontosettings.json.old. - Optionally delete
settings.json.bak. - Start WMT. It creates a fresh
settings.jsonwith defaults.
This keeps reports, backups, and provider files but loses window layout, provider choices, ignore lists, and custom commands.
- Exit WMT.
- Rename or delete the
datafolder. - Start WMT. It recreates
dataas needed.
Deleting data removes registry backups, hosts backups, driver exports, firewall exports, logs, library caches, and GOGDL authentication. Export anything you need first.
WMT is portable, but the data folder is resolved relative to the launch file.
- Exit WMT.
- Move the EXE or the script folder.
- Move
datawith it, or let WMT create a new emptydatafolder. - If you use Start with Windows, toggle it off and on again so the scheduled task points to the new path.
WinGet manages the portable package, but uninstalling the package may not delete a data folder created beside it. After uninstalling:
- Check the old install folder for
data. - Remove it manually if you do not need the settings, backups, or logs.
- Remove the
WindowsMaintenanceToolscheduled task if Start with Windows was enabled. - Remove any desktop or Start menu shortcuts you created manually.