Release Notes
August 15, 2026 · View on GitHub
Papercut SMTP v7.8.0 [2026-08-15]
New Features
- SMTP Authentication for Forwarding - The Forward dialog and forwarding rules now support SMTP username/password authentication, along with Forward dialog usability improvements and a new Name property for rules. Fixes #363 (Thanks for the report, Theo-bos!)
- Configurable Web UI Path Prefix - The Papercut Service web UI and API can now be hosted under a configurable HTTP path prefix, enabling reverse proxy scenarios (e.g.
https://myserver/papercut/). Fixes #365 (Thanks for the suggestion, Moreno-Gentili!) - Copy to Clipboard Context Menus - Right-click now offers Copy / Select All for selected text in the HTML message viewer (alongside the existing link menu), and in the Headers, Text Body, and Raw views. Fixes #366 (Thanks for the suggestion, PJOttCanHome!)
Improvements
- .NET 10 Upgrade - All projects upgraded from .NET 8 to .NET 10 for the latest runtime performance and security improvements. (Thanks, Abdulstar!)
- Service Tray Manager Deployment - The Service Tray Manager introduced in v7.7.2 is now included in the Windows Service deployment packages
- Smaller UI Footprint - Removed unused MahApps icon pack dependencies, reducing application size. Fixes #370 (Thanks, AntekOlszewski!)
- Documentation - Added Web UI screenshots and fixed the README star history chart (Thanks, PingouinFerreux!)
- Dependencies - Updated NuGet packages across all projects, including Rx.NET 7, ReactiveUI 24, WebView2, Autofac, and BouncyCastle, addressing a number of dependency vulnerability alerts
Bug Fixes
- Message List Stuck After Long Uptime - Fixed the desktop app's message list permanently stopping to update after running for a long time (new emails triggered notifications but never appeared until restart). A single transient file-system error could silently terminate the internal refresh subscriptions; refreshes are now resilient to errors, and the message list additionally force-refreshes whenever the window is restored from the tray or taskbar
- Rule Sync to Service - Fixed rule changes made in the desktop UI not being saved to the Papercut Service backend when connected. Fixes #368 (Thanks for the report, Pxtl!)
- Periodic Rules in Standalone Service - Fixed periodic background rules (such as the Mail Retention rule) never executing when running the standalone Papercut Service. Fixes #369 (Thanks for the report, Pxtl!)
Contributors
Special thanks to Abdulstar for the .NET 10 upgrade, AntekOlszewski for the icon pack cleanup, PingouinFerreux for the README fix, and to Theo-bos, Moreno-Gentili, and Pxtl for their reports and suggestions!
Several features and fixes in this release were developed with the assistance of Claude Code.
Papercut SMTP v7.7.2 [2026-03-22]
New Features
- Service Tray Manager - New Windows tray notification application for managing the Papercut SMTP Windows Service. Provides system tray icon with service status, start/stop/restart controls, quick access to the web UI, balloon notifications for new emails, and run-at-startup support. Fixes #249
- Upgrade Dialog with Release Notes - When an update is available, a new dialog shows current vs. new version with rendered release notes so you can review changes before upgrading. Fixes #344
- System Accent Color - Added a "System" option to the theme accent dropdown that reads and syncs with the Windows accent color in real-time. Now the default for new installs. Fixes #343
- Web UI Overhaul - Completely refreshed the Papercut Service web interface:
- Replaced Glyphicons with inline SVGs for a cleaner, dependency-free icon set
- Per-message delete with confirmation via new
DELETE /api/messages/{id}endpoint - Auto-refresh toggle button and browser back-button navigation
- Modern visual design with Plus Jakarta Sans font, refined colors, and improved layout
- Delete All Confirmation - "Delete All" now shows the message count and only deletes messages older than the confirmation timestamp, preventing accidental deletion of emails arriving during the confirmation dialog. Fixes #349 (Thanks, AntekOlszewski!)
Bug Fixes
- FileSystemWatcher Reliability - Fixed emails silently stopping to appear in the UI. Root cause was FileSystemWatcher buffer overflows from excessive NotifyFilter events. Now uses FileName-only filter, 64KB buffer, auto-recreation on faults, and a 30-second periodic fallback refresh. Fixes #352
- Notification Title - Fixed Windows toast notifications showing "velopack.PapercutSMTP" instead of "Papercut SMTP" by using Velopack's native
--aumidflag at install time. Fixes #350 - CID Embedded Images - Fixed intermittent failure to load Content-ID embedded images in the HTML viewer due to incorrect
file://URL format and MimeMessage cache state issues - HTML Email Preview (Web UI) - Fixed iframe collapsing to ~8px and load event race conditions by switching to
$watch-based rendering with direct document writing, ResizeObserver support, and retry-based height measurement - Cross-Thread Theme Exception - Fixed crash when Windows system theme changes while the app is running
Improvements
- Security: jQuery & Frontend Library Upgrades - Upgraded jQuery 1.11.0 to 3.7.1 and jQuery UI 1.10.4 to 1.14.1, mitigating CVE-2020-11022 and CVE-2020-11023 (XSS vulnerabilities). Also upgraded AngularJS 1.3.8 to 1.8.3 and Bootstrap 3.3.2 to 3.4.1. Fixes #353
- Aspire Integration Documentation - Added documentation for using Papercut SMTP with .NET Aspire projects, including connection string format and setup examples. (Thanks, mguinness!)
- Docker Documentation - Added troubleshooting guide for volume permission errors when running with mounted volumes
- Dependencies - Updated NuGet packages and Velopack to v0.0.1521
Contributors
Special thanks to AntekOlszewski for fixing the Delete All race condition and mguinness for documenting Aspire integration!
Several features and fixes in this release were developed with the assistance of Claude Code.
Papercut SMTP v7.6.2 [2025-11-11]
Release replaces 7.6.1 which had a major issue with email receiving in the UI.
New Features
- Dark Theme Support - Added full dark theme support with automatic Windows dark mode detection and synchronization. Fixes #228 (Thanks, wonea!)
- System/Light/Dark base theme selection with accent color customization
- Automatic system dark mode detection with live theme updates
- AvalonEdit syntax highlighting supports both light and dark modes
- Theme-aware attachment icons and UI controls throughout the application
- IP Allowlist Support - Added IP allowlist filtering for SMTP and HTTP connections with CIDR notation support. Fixes #333 (Thanks, mhkarimi1383!)
- Configurable via
SmtpServer:AllowedIpssetting - Support for individual IPs (e.g.,
192.168.1.100) and CIDR ranges (e.g.,192.168.1.0/24) - Comprehensive unit tests for IP validation and range matching
- Fail-closed security - blocks all connections if validation fails
- Configurable via
- Dynamic Property Editor for Rules - Replaced legacy PropertyGrid with custom MahApps.Metro-compatible dynamic property editor
- Reflection-based property discovery using System.ComponentModel attributes
- Intelligent control selection (TextBox, NumericUpDown, ToggleSwitch, PasswordBox)
- Category-based property organization with smart ordering
- Resizable GridSplitter between rules list and property editor
- Full dark theme support in Rules Configuration dialog
Improvements
- .NET 9.0 Upgrade - Upgraded entire solution to .NET 9.0 for improved performance and latest framework features
- Theme Consistency - Modernized UI to use dynamic theming with refreshed Options dialog and message list visuals
- Tab Preservation - Selected message detail tab (Message/Body/Headers/Raw) now preserved when switching between messages
- Code Quality - Fixed numerous compiler warnings and null-safety issues throughout the codebase
- Resource Management - Fixed X509Certificate2Collection resource leak
- Docker Improvements - Updated container and runtime images for .NET 9.0
Code Quality
- Comprehensive unit tests for IP allowlist validation
- More flexible SMTP/server startup wiring and options
- Internal robustness improvements with clearer initialization and lifecycle handling
- Better error handling across core components
Contributors
Special thanks to wonea for requesting dark theme support and mhkarimi1383 for requesting IP allowlist functionality!
Papercut SMTP v7.5.1 [2025-10-31]
Bug Fixes
- Forwarding Rules Failing - Fixed critical bug where email forwarding rules were completely broken due to TaskCanceledException. Fixes #331 (Thanks, wcwhitehead!)
- SSL/TLS Connection Mode - Fixed SSL/TLS connection mode to use SslOnConnect for port 465 and Auto for STARTTLS
- SMTP Timeout - Set proper SMTP timeout of 30 seconds for forwarding rules
- Backend Service Status - Fixed initial status detection for backend service
Contributors
Special thanks to wcwhitehead for reporting the critical forwarding rules bug!
Papercut SMTP v7.5.0 [2025-10-28]
New Features
- Search Functionality - Added Ctrl+F search to all message detail views (Message, Body, Headers, and Raw). Fixes #295
- Zoom Controls - Added Ctrl+Mouse Scroll Wheel zoom support to message detail views with persistence and visual indicators. Fixes #323
- Attachment Display - Attachments now display in the main message panel with icons and easy access. Fixes #112
- Context Menu for Links - Right-click context menu added for email links with copy and open functionality. Fixes #218
- Empty State Placeholders - Added smart empty state messaging to message list and detail views for better first-time user experience. Fixes #268
- SMTP Authentication and TLS/STARTTLS Support - Full support for SMTP authentication and TLS/STARTTLS encryption for secure email testing. Fixes #102
- Periodic Background Rules - Added periodic background rule execution with mail retention cleanup to both UI and Service. Related to #251
- Windows Package Manager (winget) Support - Papercut SMTP can now be installed and updated via winget. Fixes #231
- File Links Support - Made file:/// links functional by opening with shell/explorer. Fixes #232
- Example Console Applications - Added comprehensive example console applications for email testing scenarios
- Installer Help Support - Added help parameter support for PowerShell/cmd users. Fixes #287
Improvements
- Word-Wrap Support - Added CSS word-wrap support to HTML email rendering for better display of long text strings. Fixes #154
- Non-Standard Email Domains - Added support for non-standard email domains in development environments (e.g., .local, .dev). Fixes #284
- SSL Certificate Error Handling - Added optional SSL certificate error handling for WebView2 to support self-signed certificates. Fixes #243
- Comprehensive Unit Tests - Added extensive unit tests with FluentAssertions for improved code quality and reliability
- NuGet Package Upgrades - Upgraded all NuGet packages to latest versions, including migration to new Polly ResiliencePipeline API
- Service Architecture - Refactored attachment and process handling into dedicated services for better separation of concerns
- Settings Debouncing - Implemented debounced settings saves using Rx Throttle operator to reduce unnecessary I/O
Bug Fixes
- Window Size Saving - Fixed window size not saving correctly when minimized. Fixes #327
- PDF Attachment Opening - Fixed PDF attachment opening on Windows 11 24H2 and double-click issues. Fixes #310, #280
- Message Rendering with # Characters - Fixed message rendering for subjects containing # characters. Fixes #282 (Thanks, xavero!)
- SMTP IP Logging - Fixed SMTP service not logging remote client IP address correctly. Fixes #291
- Empty State Flicker - Fixed placeholder flicker when switching between emails
- WebView2 Deserialization - Added robust error handling for WebView2 message deserialization
- Null Safety - Various null safety improvements and fixes throughout the codebase
- Process.Start Null Checks - Added null checks for Process.Start return values to prevent exceptions
Code Quality
- Refactored to use IUiCommandHub.ShowMessage instead of MessageBox.Show for better testability
- Extracted debouncing logic into reusable SettingsSaveDebouncer
- Improved async patterns and error handling in example applications
- Fixed test assertions to use FluentAssertions consistently
- Added nullable reference type attributes throughout codebase
Documentation
- Added comprehensive TLS/STARTTLS setup documentation with Docker examples
- Created example projects: SendEmailTest, SendRichEmailTest, SendWordWrapTest, SendEmailWithTls, SendEmailWithFileLinks
- Improved Docker documentation with troubleshooting guides
- Added installation guide for PowerShell and command-line users
Contributors
Special thanks to xavero for fixing message rendering with # characters!
Papercut SMTP v7.0.2 [2025-10-09]
Improvements
- Modernized versioning system to use Directory.Build.props instead of GlobalAssemblyInfo.cs
- Added Windows ARM64 support (#283)
- Improved port configuration for SMTP and HTTP services (#285, #286, #293)
- Enhanced Docker support with non-privileged ports (SMTP: 2525, HTTP: 8080)
- Consolidated documentation and improved Docker build process
Bug Fixes
- Fixed Windows Service installation and auto-start issues (#294)
- Fixed Linux path separator handling (#292)
- Fixed SMTP server options configuration
Build System
- Refactored build.cake to reduce code duplication
- GitVersion now populates version properties via MSBuild
- Removed deprecated assembly patching approach
Papercut SMTP v7.0.1 [2024-11-08]
- Fixed Run on Startup broken. (Thanks, rikrak))
Papercut SMTP v7.0.0 [2024-10-14]
NOTE: Uninstall any existing Papercut SMTP installations BEFORE installing this new version.
- Upgraded to .NET 8
- Upgraded to latest dependencies (Caliburn Micro, Autofac, MahApps) and associated systems to support .NET 8.
- Switched to Velopack auto-upgradable installation system. Great project! (Thanks, caesay!)
- Fix for log updating constantly causing unnecessary WebView2 loading. (PR thanks to arthurzaczek)
- Fix for double request when clicking on links in emails. Issue #232.
- Added InvokeProcess Rule (#274)
Papercut SMTP v6.2.0 [2022-04-24]
- Upgraded to .NET Framework v4.8 (PR thanks to 1Jesper1)
- Service doesn't overwrite settings on exit anymore.
- Simplified HTTP binding setting for Service. Basically, "http://0.0.0.0" for "all" binding works again.
- Added Attachment Icon (PR thanks to Cload
- Added graceful fall-back support and error message if WebView2 isn't properly installed.
- Fix for checking registry key for installing edge webview2 & version fixes (PR thanks to 1Jesper1)
Thank you all for your feedback and assistance with this release!
Papercut SMTP v6.0.0 [2021-11-14]
NOTE: Papercut SMTP now requires that Microsoft Edge WebView2 be installed. Papercut SMTP will automatically run the installation dependency if WebView2 is not available.
- Moved to Edge (WebView2) for email display providing modern browser support for viewing.
- Support for SVGs.
- Support for newer HTML/CSS display.
- Fixed: Progress bar for Forwarding Dialog displays correctly now.
- Fixed: Multiple issues with the forwarding dialog.
- [#193] Add logging path to settings.json (PR thanks to 1Jesper1)
- [#192] Adds an option (defaulting to true) to enable popup notifications when a new message is received. (PR thanks to richardlawley)
- [#189] Use first capital character in text in "proceed" and "cancel" buttons (PR thanks to 1Jesper1)
Papercut SMTP v5.8.0 [2021-06-16]
- Moved to .NET Framework 4.7.2
- Upgraded to latest dependencies (Caliburn Micro, Autofac, MahApps)
- Fixed: Window sizes weren't binding properly.
- Converted system to Async.
- Added additional theme colors.
- Updated the logo.
- Fixed: Hide passwords in rules logging output.
- Fixed: Don't show passwords in rules logging output.
- [#175] Added font weight changing when message has been seen (PR thanks to LewisJohnson)
- [#180] Fixed message not displaying in Web UI when id includes '#' symbol (PR thanks to ryan-warrener)
- [#185] Responsive Delete button (PR thanks to rfverbruggen)
Papercut SMTP v5.7.0 [2020-04-05]
- Renamed product to "Papercut SMTP" to seperate from other products.
- Moved "Readme.eml" and logs to \ProgramData\Changemaker Studios\Papercut SMTP allowing it to be deleted.
- Changed default save directory for Papercut UI to %ApplicationData%\Changemaker Studios\Papercut SMTP. Mail in legacy paths are still supported.
- Added support for embedded message mime types and the ability to save the embedded eml.
- Performance improvements loading messages.
- Misc bug fixes.
Papercut v5.6.0 [2020-04-02]
- #143 Added "Delete All" button.
- Switch "Self Hosted Web" to use OWIN/Katana -- which should fix issues with binding.
- Added IP and port Papercut IPComm configuration in json settings.
- Improved message loading speed.
- Limited logging and added automatic logging pruning.
Papercut v5.5.0 [2019-03-08]
- NOTE: Web UI is now only available in PapercutService.
- Switched to using SmtpServer project for Papercut's SMTP Server.
- Added http:// link in log for Web UI improving discoverablity for the UI. Hopefully fixed the issues with the web ui binding.
- #137 - Removed plugin architecture.
- #96, #132 - Fixed issue with receiving email as UTF-8 by default.
- #105 - Fixed: Clicking target="blank" links in emails will now use the default browser.
Papercut v5.2.16 [2019-02-01]
- Added http:// link in log for Web UI improving discoverablity for the UI. Hopefully fixed the issues with the web ui binding.
- StartHttpServer for the Web UI needs to be called in another thread -- it was causing hangs on loading.
Papercut v5.1.88 [2018-12-02]
- Converted build to use Cake -- PR thanks to tdue21.
- Fix: Papercut Protocol failing during serialization due to incorrect JSON.NET settings PR thanks to jennings.
Papercut v5.1.76 [2018-08-16]
- #122: Add "Papercut" to SMTP banner.
Papercut v5.1.70 [2018-07-12]
- Hacky way to get a sort of "comment" into the settings file and keep them there. :)
Papercut v5.1.23 [2018-03-18]
- #50: When Message Sort Order is 'Descending' the 'current' message always moves to bottom.
- #110: Support for AUTH LOGIN and AUTH PLAIN.
- Added authentication parameters to SmtpSession
Papercut v5.1.19 [2018-03-04]
- #94: Removed manifest/deployment for oneclick.
Papercut v5.1.3 [2017-12-06]
- #73: Feature enhancements for the WebUI plugin.
- #81: Removed Click-Once.
- #85: Forwaring rule to server with STARTTLS not supported.
- #89: Forwarding messages to an SMTP server on a port other than 25.
- Added a check for the MessagePath configuration loader which will now soft fail if it cannot load the configuration.
Papercut v5.0.9 [2017-09-13]
- #4: URLs are decoded when clicking on link.
- #46: Added support for SeqApiKey for issue #46 fixed.
- #60: Simple bootstrapped MSI installer, thanks to tdue21.
- #63: Basic web ui features, thanks to jijiechen.
- Fixed the mispelling for Papercut.Module.
- Upgrade to .NET v4.5 - Leaving the past behind. WebAPI layer is properly loading now.
- Plugin directory no longer needs to be copied.
Papercut v4.8.0.3 [2017-03-29]
- #46: Papercut.Service.json Options.
- #52: ConnectionManager check for idle connections is incorrect.
- #54: Border Color Doesn't Change with Theme Changes.
Papercut v4.8.0.1 [2017-02-12]
- Removed "Always on disk logging"
- Theme Switcher
- Improved Option Handling
- Minimize to Tray Option
Papercut v4.7.0.1 [2017-02-08]
- Bug fixes for Message Encoding
Papercut v4.6.1.12 [2016-04-08]
- Merge branch 'master' into develop
Papercut v4.6.1.8 [2016-04-07]
- Trying multiple artifacts.
Papercut v4.5.0.0 [2016-01-26]
- Added Bcc support to message saving. Before the value was just getting thrown away.
- Fixes issue clicking some urls.
- Added conditional forward rule with retry.
- Fix for minor issue when saving and the window height/width is saved incorrectly.
Papercut v4.4.0.0 [2015-06-25]
- Improvement: #9864 “Log View” added to show all internal logging information for that session.
- Fixed: #9874 Message loading exception was not properly handled causing an unhandled exception and failure.
- Fixed: #9872 On some systems there were permissions issues accessing the IP addresses for the local system causing an unhandled exception and failure.
Thanks to Jstedfast (author of MimeKit) for his contribution:
- Rewrote and improved the logic that renders the email HTML.
Thanks to MikeWill34 for his contributions:
- Fixed: #9870 When Aero is disabled (on servers, for example), the windows didn’t have a drop shadow. Now they have a solid border.
- Fixed: Mark of the Web “ActiveX” security warning on email display.
- Improvement: Upgraded to Calburn Micro v2.0.
Papercut v4.3.0.0 [2014-11-05]
- Improvement: “Raw” message view re-added back as a view of the message data using AvalonEdit control for speed.
Papercut v4.2.1.0 [2014-10-11]
- Fixed: #9861 Exception if the specified file name for a mime part was duplicate.
- Added: Web links in emails are launched in default browser. (Thanks Jamie Humphries!)
- Added: Conditional Forward (RegEx) Rule based on body or headers.
- Fixed: Added the "Mark-of-web" for the email viewer to remove IE security warnings.
- Fixed: #9863 Papercut.Service was not correctly reporting it’s incoming mail directory to Papercut.Client.
Papercut v4.2.0.0 [2014-8-23]
- Fixed: #9859 Now using
tag when displaying the text email so that carriage returns/linefeeds are displayed.
- Fixed: #9858 Now won’t close the app when failing to delete a message. Displays the reason for the failure as well.
- Improvement: Increased the robustness and error handling of the SMTP FIle Receiving.
- Improvement: Now validates the existence of and creates (if necessary) the Default Message Save Path directory.
- Improvement: Improved the loading so that it catches all assembly loading errors and attempts to write them to the Event Log in case app load is failing.
- Changed: Set the protocol logging to "Verbose".
- Changed: Papercut.Service default save location now defaults to %BaseDirectory%\Incoming.
- Added: Remove the "read-only" flag from the message file when attempting to delete.
- Added: Example Papercut.Service.json file with comments to explain the settings.
Papercut v4.1.0.0 [2014-8-13]
- Fixed: #9851 Exception on TCP/IP port binding failure.
Papercut v4.0.0.0 [2014-7-24]
- Added: Automatic “rules” system and configuration. Currently only supports a forward rule. But unlimited forwards can be specified.
- Added: “Loading” UI
- Added: Save window height/width.
- Added support for rules to the backend service. Rules are configured by the front-end and pushed to the backend service automatically.
- Switched to using MailKit instead of custom Smtp Client for additional options it offers.
- Added authentication support to the forward rule.
- Issue #9852: Converted Papercut.Service to use a json settings file. Papercut Client/UI will continue to use the .NET settings system do it it's complex system of overrides based on the current user account.
- Improvement: Now properly disables the Message View if it’s disabled.
- Improvement: UI consistency -- added one place for Option and Exit links on the main UI.
- Improvement: Added "Delete (count)" to the delete button.
- Fixed: Issue #9849 – Null Reference in the Attachment/Mime Section
- Improvement: SMTP Server failure handling and added additional logging to help with issue #9851.
Papercut v3.0.0.0 [2014-6-8]
Papercut has switched to semantic versioning! That means you will have to uninstall old "clickonce" versions to get the latest as it will see it as an older version.
- Modern UI
- MVVM Architecture
- Watch Directories for New Messages
- Optional Backend Papercut Service
- Load on Windows Startup
- Attachments/Mime Sections
Papercut 2014-5-1
- Fixed: Message list box scrolling caused unhandled exception.
Papercut v2014-3-13
- Fixed: Converted back to .NET v4 so that XP users are supported.
- Fixed: Running papercut under SYSTEM account will now store messages in the application base directory instead of the \User\AppData\Papercut directory.
- Change: Using MimeKitLite instead of full MimeKit.
Papercut v2014-3-8
- Change: Application now using the excellent MimeKit library. Faster and better support for mime types.
- Change: Removed the the slow and annoying "raw view" and added "header view.”
- Change: Removed the Redundant "Html" view and added the "Text" view.
- Change: Changed "Close" to "Exit" as the close or minimize window button has the close functionality. It's nice to be able to exit Papercut from the main app window.
- Feature: Thanks to a little assistance from this answer on stack overflow (http://stackoverflow.com/questions/14103159/previewmouseleftbuttondown-interferes-with-clic-selection).
- Finally implemented that drag&drop message file feature. Now you can drag and drop a message file.
- Change: Saves and loads message in AppData\Papercut.
- Feature: Now you can delete a Message with the Delete Key (#9835) - message content from last message is now correctly cleared (#9840)
- Feature: Changed Processing to Buffered File output for speed, etc.
- Fixed: Issue #6026 -- Supports "Minimize on Close" option.
- Feature: Added CC and BCC to field list aka issue #9836.
- Feature: Added support for "dot stuffing", per RFC 2821, section 4.5.2.
- Fixed: FormatException on empty ReplyTo
- Fixed: fixed crash on start when there is an email with 0 byte.
- Fixed: Issue with email address parsing.