MailForge User Manual

Advanced VSTO Outlook Add-in for email management, search, templates, batch operations, and more — with dark theme and 18+ features.

VSTO Outlook Add-in C# .NET 4.8 Dark Theme 18+ Features

✨ Features

MailForge is a professional toolkit for managing your Outlook inbox more efficiently:

MailForge adds a single MailForge tab to the Outlook ribbon, organized into 7 groups:

GroupButtons
IntelligenceAdvanced Search · Daily Digest · Quick Notes
AnalyticsEmail Dashboard · Storage Analyzer · Data Scanner
Batch ToolsBatch Operations · Smart Categorize
Email TemplatesNew Template · Apply Template
Compose ToolsQuick Reply · Schedule Send · Signatures
ManageEmail Tracker · Snooze · Archive · Settings
AppearanceToggle Theme
🔍

Advanced Search

Search across all folders by Subject, From, To, Body, Date, Flag, Unread status, and Attachment presence.

📰

Daily Digest

Generate a summary digest of recent activity across your mailbox.

📝

Quick Notes

Attach a private note to any email for later reference.

📊

Email Dashboard

Visual charts of your email activity — sent, received, and overall mailbox statistics.

💾

Storage Analyzer

Analyze which folders and senders consume the most mailbox space.

📂

Data Scanner

Scan emails for sensitive data patterns (PII, credentials, etc.).

Batch Operations

Archive, delete, move, and mark read/unread for multiple emails simultaneously.

🧠

Smart Categorize

Auto-assign Outlook categories based on sender patterns.

📄

New Template

Create reusable email templates for repetitive replies.

📥

Apply Template

Apply a saved template to a new or existing email in one click.

↪️

Quick Reply

Fast email replies with one click for your most common responses.

🕐

Schedule Send

Schedule emails for delivery at a specific date and time.

✍️

Signatures

Manage and insert multiple Outlook signatures.

📍

Email Tracker

Unified follow-up & tracking: register sent emails, track replies, snooze, and monitor open status.

😴

Snooze

Snooze emails to reappear in your inbox at a later time.

🗃️

Archive

Move selected emails to your archive folder in one click.

⚙️

Settings

Configure appearance, storage paths, signatures, and default search options.

🌗

Toggle Theme

Switch between GitHub-dark and clean Light themes instantly. Applies live without restarting Outlook.

📦 Installation & Setup

Requirements

RequirementVersion
Microsoft Outlook2016, 2019, 2021, 2024, or Microsoft 365
.NET Framework4.8
VSTO Runtime4.0
Operating SystemWindows 10 / 11
Visual Studio2019 or 2022 (for building only)

Method 1: Using install.bat (Easiest)

1
Open the project in Visual Studio and run Build → Rebuild Solution.
2
Run install.bat with Administrator privileges.
3
Close and reopen Outlook. Trust the add-in prompt when it appears.
4
The MailForge tab appears in the Outlook ribbon.
Note: If Outlook is already running, close it first and reopen it so the add-in loads properly.

Method 2: Manual Registration

  1. Copy MailForge.dll to %LOCALAPPDATA%\MailForge\.
  2. Add the following registry keys:
Windows Registry Editor Version 5.00 [HKEY_CURRENT_USER\Software\Microsoft\Office\Outlook\Addins\MailForge] "Description"="MailForge" "FriendlyName"="MailForge" "LoadBehavior"=dword:00000003 "Manifest"="file:///%LOCALAPPDATA%/MailForge/MailForge.vsto|vstolocal"
Warning: Administrator privileges are recommended for installation. Without them, the add-in installs for the current user account only.

📊 Email Dashboard

The Email Dashboard provides visual charts of your email activity. View sent and received email statistics at a glance.

📝 Email Templates

Email templates are useful for repetitive responses:

  1. From the Save menu, create a new template.
  2. Edit the template text.
  3. When composing a new email, select your template from the Load menu.

📦 Batch Operations

After searching, select results and perform batch operations:

OperationDescription
ArchiveMove emails to the archive folder
DeleteDelete selected emails
MoveMove to a specific folder
Mark ReadMark all selected as read
Mark UnreadMark all selected as unread
Smart CategorizeCategorize based on sender patterns

📍 Email Tracker

MailForge unifies follow-up and tracking into a single tab:

⚙️ Settings

From the Settings page, you can configure:

❓ Frequently Asked Questions

Does MailForge require Administrator access?

No. Installation is performed for the current user account. Administrator privileges are recommended but not required.

Is MailForge compatible with Outlook 365?

Yes. MailForge is compatible with Outlook 2016, 2019, 2021, 2024, and Microsoft 365.

How does MailForge prevent duplicate emails?

MailForge uses a HashSet to track EntryIDs of emails and ensures each email appears only once in search results.

Does Regex search work?

Yes. Enable the Use Regex checkbox to use regular expressions in search fields.

What format does the CSV export use?

The CSV file contains columns: Subject, From, To, Date, Size, Attach, Flag, Unread. Saved with UTF-8 encoding.

What if VSTOInstaller is not found?

The installer automatically falls back to manual registry registration. The install.bat script selects the best available method.

Search is slow or the grid stays empty?

MailForge streams mailboxes with GetFirst/GetNext (never enumerates the whole store), so even a 100 GB mailbox won't hang Outlook. If results don't appear, make sure at least one filter is set and that Importance is left on Any unless you specifically want to filter by priority.

🛠️ Troubleshooting (Office 2024)

Outlook 2024 is stricter than 2016/2019/2021. If the add-in fails to load or is disabled, apply the steps below.

Symptom: "Not loaded. A runtime error occurred during the loading"

Symptom: "Slow and Disabled" with a 12-second average delay

Tip: After any fix, fully close Outlook, run fix-outlook-user.bat, then reopen Outlook. Verify the MailForge tab appears in the ribbon and no "disabled" warning shows in File → Options → Add-ins → Manage COM Add-ins.

📁 Project Structure

MailForge/ ├── Forms/ # UI forms (WinForms) │ ├── AdvancedSearchForm.cs # Advanced email search │ ├── BatchOperationForm.cs # Batch email operations │ ├── DarkThemeHelper.cs # Dark/Light theme engine │ ├── EmailDashboardForm.cs # Email analytics dashboard │ ├── FollowUpForm.cs # Unified Email Tracker (follow-up + tracking) │ ├── SettingsForm.cs # Application settings │ ├── SignatureManagerForm.cs # Signature management │ ├── StorageAnalyzerForm.cs # Storage analysis │ ├── SensitiveDataScannerForm.cs # Data scanning │ ├── TemplateForm.cs # Email templates │ └── ... ├── Services/ # Business logic services │ ├── JsonStorageService.cs # JSON file storage │ ├── TemplateService.cs # Email templates │ ├── FollowUpTrackerService.cs # Follow-up + tracking management │ ├── SettingsService.cs # Application settings │ └── ... ├── Resources/ # Resource files (22 glassmorphism icons) ├── Ribbon1.cs # Outlook ribbon definition ├── Ribbon1.xml # Ribbon XML layout ├── ThisAddIn.cs # VSTO add-in entry point ├── OutlookSafe.cs # Safe ribbon stub + global error guard ├── App.config # Binding redirects for .NET 4.8 / Office 2024 ├── fix-outlook-user.bat # User-level COM registration + CRL-off fix ├── install.bat # Installation script ├── uninstall.bat # Uninstallation script ├── MailForge.csproj # Project file └── README.md # Project readme

📚 Complete Tab Guide

A comprehensive standalone HTML guide covering the usage of all 18 MailForge ribbon tabs — with step-by-step instructions, features, and tips for each.

Download Full Guide (HTML)