MailProcessor Banner

System tray launcher for the three Universal Mail Tools.

Deutsche Dokumentation: README-DE.md

MailProcessor tests

MailProcessor Installer

MailProcessor sits in the Windows system tray and gives you one-click access to:

• Universal Mail Cleaner — Clean an IMAP mailbox by rules
• Universal Docs Grabber — Download documents and attachments from mail
• Universal Invoice Mail — Extract invoices automatically from mail

• System tray icon: launch any tool via right-click at any time
• First run: setup wizard with automatic scan for installed tools
• GitHub installer: download tools directly from GitHub Releases
• Version numbers shown in tray menu (read from each tool's CHANGELOG.md)
• Settings: change paths, remove tools, add manually
• Read-only snapshot export as mailprocessor-suite-v1.json for the companion view
• Windows autostart (registry entry)
• Bilingual: German / English

1. Install Python 3.10+
2. Install dependencies:

   pip install -r requirements.txt

3. Launch:

   start.bat

   or

   python main.py

4. Select the desired tools in the setup wizard

• Local release artifacts are staged in releases/v0.1.0/
• Rebuild the Windows executable with build_exe.bat
• The packaged binary is named MailProcessor-0.1.0-desktop.exe

• Python 3.10+
• PySide6 6.x
• One or more Universal Mail Tools (auto-downloaded via wizard)

python -m pytest -q
python -m compileall .

Current local test suite: 41 Pytest tests.

Settings are stored in %LOCALAPPDATA%\MailProcessor\config.json.

Tools are installed to %LOCALAPPDATA%\MailProcessor\tools\.

Part of the doc-bricks mail suite:

MIT License — see LICENSE