Skip to content

Settings and Data

chaython edited this page Nov 15, 2026 · 1 revision

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.

Where the data folder is

WMT resolves the data path in this order:

  1. The folder that contains the running EXE or script.
  2. 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.

Files WMT creates

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

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.

How settings are saved

WMT writes settings carefully:

  1. Serialize the complete settings object.
  2. Write a temporary file.
  3. Validate that the temporary file can be read back and contains required keys.
  4. Replace settings.json.
  5. 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.

Activity log and diagnostics

  • The Activity Log in the main window is in-memory. It is cleared when WMT exits.
  • last-crash.txt is 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.

Credentials and external state

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.

Back up WMT

To keep settings and caches:

  1. Exit WMT completely, including the tray icon.
  2. Copy the entire data folder to a safe location.
  3. Keep the executable or script and the data folder 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.

Reset WMT

Reset settings only

  1. Exit WMT.
  2. Rename settings.json to settings.json.old.
  3. Optionally delete settings.json.bak.
  4. Start WMT. It creates a fresh settings.json with defaults.

This keeps reports, backups, and provider files but loses window layout, provider choices, ignore lists, and custom commands.

Reset everything

  1. Exit WMT.
  2. Rename or delete the data folder.
  3. Start WMT. It recreates data as needed.

Deleting data removes registry backups, hosts backups, driver exports, firewall exports, logs, library caches, and GOGDL authentication. Export anything you need first.

Move WMT to another folder

WMT is portable, but the data folder is resolved relative to the launch file.

  1. Exit WMT.
  2. Move the EXE or the script folder.
  3. Move data with it, or let WMT create a new empty data folder.
  4. If you use Start with Windows, toggle it off and on again so the scheduled task points to the new path.

Uninstall and leftover data

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 WindowsMaintenanceTool scheduled task if Start with Windows was enabled.
  • Remove any desktop or Start menu shortcuts you created manually.

Related pages

Clone this wiki locally