WT-JunkCleaner

01What WT-JunkCleaner does

Every time it runs, WT-JunkCleaner goes through the Junk Email folder one message at a time:

• It reads the message headers: who it was sent to, any unsubscribe link, and the sender-authentication result that Microsoft stamped when the message arrived.
• If the sender proved it is who it claims to be, WT-JunkCleaner unsubscribes using the safest method the sender supports.
• It deletes the message, whether or not an unsubscribe happened or worked.
• If you turn it on, it lists the domains of persistent spammers in a CSV file you can use to block them.
• It writes a CSV log so you can see exactly what happened to each message.

Built-in safety rules

Out of the box, WT-JunkCleaner follows three rules:

Other unsubscribe methods are available in Settings, but every one of them is off by default.

02Requirements

• Windows 10 or 11 with Windows PowerShell 5.1 (built in) and .NET Framework 4.8 (built in).
• Classic Outlook for Windows (Microsoft 365 Apps, Outlook 2016 or later), 32- or 64-bit. The new Outlook and Outlook on the web do not support this kind of add-in. The Command Prompt and scheduled runs work regardless of which Outlook you use.
• A Microsoft 365 / Exchange Online mailbox.
• Internet access to the PowerShell Gallery during install. The installer downloads one Microsoft module: Microsoft.Graph.Authentication.
• No administrator rights are needed. Everything installs for your Windows user only.

03Installing

1. Close Outlook. If Outlook is open, the installer waits and asks you to close it.
2. Download WT-JunkCleaner-Setup.cmd from taucher.llc. It is one self-contained installer file.
3. Double-click WT-JunkCleaner-Setup.cmd. Your browser or Windows SmartScreen may warn about a downloaded .cmd file; choose to keep and run it. A window opens and shows each step. (If you received the WT-JunkCleaner folder instead, double-click Install.cmd in it.)
4. Wait for "WT-JunkCleaner is installed." The first install takes a minute or two while the modules download.
5. Start Outlook. The WT-JunkCleaner group appears on the Home tab.

What the installer does

04Your first run

Do the first run by hand so you can sign in to Microsoft 365 and see what WT-JunkCleaner would do before it changes anything.

1. In Outlook, click Preview, or type WT-JunkCleaner preview in a Command Prompt.
2. A Microsoft sign-in window opens. Sign in with your mailbox account and approve the Mail.ReadWrite permission. Your sign-in is remembered for later runs.
3. Read the list. Each line shows what would happen (method, sender authentication, sender and subject). In preview nothing is unsubscribed or deleted.
4. If any real mail shows up, add that sender to Keep senders in Settings.
5. Click Clean Junk to do it for real.

05Using it from Outlook

The add-in puts a WT-JunkCleaner group on the Home tab of the main Outlook window:

Outlook stays usable while WT-JunkCleaner runs, because the work happens in its own window.

06Using it from the Command Prompt

Open a new Command Prompt after installing and type:

One-time overrides

Options typed after WT-JunkCleaner apply to that run only. They do not change your saved settings.

WT-JunkCleaner -MaxMessages 50
WT-JunkCleaner -OlderThanDays 3 -HardDelete
WT-JunkCleaner preview -Mailbox user@contoso.com
WT-JunkCleaner -BlockMode CsvOnly

07Settings reference

Open Settings from the ribbon, with WT-JunkCleaner config, or by pressing F1 in the Settings window to get back to this manual. Settings are saved in %LOCALAPPDATA%\WT-JunkCleaner\config.json.

The buttons at the bottom are Save & Preview, Save & Run now, Help, Save and Cancel. The Support it ☕ link in the bottom-right corner opens PayPal.

General tab

Unsubscribe tab

Spam domains tab

Schedule tab

08How each message is handled

Each message in Junk Email goes through these steps in order:

After all messages are done, the log, the spam-domain list (if it is on) and the summary are written.

09Listing spam domains

A lot of spam comes from networks that rotate through many subdomains (for example enews1 to enews17.fund4ever.com) and whose unsubscribe links lead nowhere. Unsubscribing cannot stop these; blocking the domain can. WT-JunkCleaner does not block anything itself. Instead it can hand you a ready-made list.

Turn on Write a list of spam domains on the Spam domains tab in Settings. After each run you will find SpamDomains_<date>.csv in the log folder, with one domain per row and the reason it was listed. Parent domains come first, then the subdomains seen.

Using the list

10Running on a schedule

1. Do one run by hand first (section 4), so your Microsoft 365 sign-in is saved.
2. Open Settings → Schedule, check Run WT-JunkCleaner automatically every day, choose a time, and click Save.
3. To check it, open Task Scheduler and find the task WT-JunkCleaner in the Task Scheduler Library. You can right-click it and choose Run to test it.

Scheduled runs use your Windows account, happen only while you are signed in to Windows, and open a minimized window. If your saved Microsoft 365 sign-in has expired, the sign-in window appears; complete it once and later runs go back to being silent.

11Reading the log

Each run writes WT-JunkCleaner_<date>_<time>.csv to the log folder. It opens in Excel.

12Troubleshooting

13Uninstalling

Close Outlook, then run WT-JunkCleaner uninstall, or run WT-JunkCleaner-Setup.cmd -Uninstall from a Command Prompt in the folder where you saved it. The uninstaller removes the add-in registration, the scheduled task, the PATH entry and the program files. It asks whether to keep your logs.

14References

WT-JunkCleaner v. 261031-1754 · © 2026 WalterTaucher LLC. All rights reserved. · info@taucher.llc

15Licence & copyright

WT-JunkCleaner is free. Copyright © 2026 WalterTaucher LLC. All rights reserved. WT-JunkCleaner, including its software, add-in and documentation, is the property of WalterTaucher LLC. It may not be sold, rebranded, or redistributed without written permission.

Microsoft, Outlook, Exchange Online, Microsoft 365, Entra ID and Windows are trademarks of the Microsoft group of companies.

Questions, bug reports or feature requests: email info@taucher.llc. You'll reach the people who wrote the software.