SwithMail 2.2.4.0
--Send SSL SMTP email silently from command line (CLI), or a batch file using Exchange, Gmail, Hotmail, Yahoo! Plus, or a custom server - for FREE!
Swith??
swith
–adverb
1. immediately; quickly.SwithMail is a windows application that is extremely easy to use. You run the program, set up basic settings (from address, to address, smtp server info, email subject and body), click save, and you're ready to go. Now you can send email using these settings silently from the command line, a batch file, or (the reason I wrote it), if a windows service quits.
Trying to use Gmail, but getting a "5.5.1 Authentication Required" message?
Google has security set up to disallow logging in from certain applications that they deem "Less Secure."
To get around this, you can head over to https://www.google.com/settings/security/lesssecureapps and turn on access to less secure applications.Google's also getting away from Less Secure Apps and now they're recommending "App Passwords" -- here's how to set them up: https://support.google.com/accounts/answer/185833?hl=en
Prerequisites
Reqires .NET framework 4.6.2
Want to see some screen shots?
Download the How-To and Usage Guide:
Swithmail How-To and Usage Guide - updated (2011-10-21 - v2.0)
- None - all known issues have been resolved with the latest release.
find a bug not in this list? Let me know!
Exit Codes:
When running silently from command line (or more specifically a batch file), Swithmail now supports error codes.
0 - No error - email delivered
1 - Error - something went wrongUsage in a .bat file:
@echo off
rem ...
set errorlevel=
C:SwithMailSwithMail.exe /s /x "SwithMailSettings.xml"
IF %errorlevel% ==0 GOTO SUCCESS
IF %errorlevel% ==1 GOTO ERROR:SUCCESS
echo Success!
GOTO END:ERROR
echo Error!
GOTO END:END
Usage:
SwithMail.exe [/Silent] [/ToAddress ...] [/CC ...] [/BCC ...] [/FromAddress ...] [/FromName "..."] [/Subject "..."] [/Body "..."] [/HTML true] [/Attachment "C:PathToFile.txt"] [/Param1 "Mr. Smith"] [/enc "..."]
Options:
/Silent -- [also '/s' and '/q'] send an email without any prompt.
/XML -- [also '/x'] "C:\PathToSettings.xml"
/FromAddress -- [also '/from'] email address
/FromName -- [also '/name'] name displayed
/Server -- server address - no port specified
/Port -- [also '/p'] server port - needed if /Server is used
/Username -- [also '/u'] specified different username to use when logging in with SSL / TLS
/Password [also '/pass'] password - in plain text
/SSL -- [also '/TLS'] "true" or "false" depending on if SSL / TLS is enabled
/ToAddress -- [also '/to'] email address(es); multiple separated by ';' or ','
/CC -- email address(es); multiple separated by ';' or ','
/BCC -- email address(es); multiple separated by ';' or ','
/ReplyTo -- [also '/rt'] address to set as the "Reply To" address
/Subject -- [also '/sub'] subject "in quotes"
/Body -- [also '/b'] email body "in quotes" - html tags allowed when /HTML=true
/BodyTxt -- [also '/btxt'] full path of a text file to be used as the message body.
/HTML -- "true" or "false" depending on if HTML tags are allowed in the body
/Attachment -- [also '/a'] "C:\PathToFile.txt|C:\PathTo2.txt" - separate with pipe (|) symbol
/Param{1-9} -- [also '/p{1-9}'] use %Param1% in subject or body, && replace it with this value
/Test -- use when testing from CLI. Message will appear with errors or success
/Encoding -- [also '/enc'] Specify different charset to be used (UTF8 by default)
/ReadReceipt -- [also '/rr'] Request Read Receipt (where the client acknowledges and agrees)
/DontReplace -- [also '/drnl'] Don't replace New Line with '<br />' on HTML email
/Log -- [also '/l'] Path to Log file with success and failures. Logs Date, ToAddress, and Subject. If no path is specified, the log file will be in the directory from where SwithMail is running.
/Priority -- "high" or "low" - flags message priority. Default is "normal" (no flag)
/MessageID -- [also '/mid'] Generate email header Message-ID
Global variables (use in email subject & body, and "from name"):
%now% - displays current date & time
%computername% - displays computer name
%username% - displays username of account running SwithMail
Notes:
-arguments are NOT case sensitive
-arguments can be prefaced with '/', '-' or '--'
-arguments and values MUST be separated with a space. (':' and '=' removed as of 2.0.5.0)
-arguments not specified will use option saved in settings"
Example Usage:
swithmail.exe /s /toaddress "1@mail.com;2@mail.com" /cc "cc@mail.com" /subject "here, %Param1%" /body "line 1
line 2" /html /param1 "Mr. Smith"
Obviously, you wouldn't need to use %Param1% when you specify the subject and body from the CLI, but, again, if you need to send emails on a schedule to multiple different recipients, and you want to personalize them, open SwithMail without the /silent option, configure settings, and fill out the subject and body using %Param1% - %Param5%, then you can write a batch script, and specify the different "to" addresses, and the parameters, and have SwithMail do the rest!
Windows operating systems tested and working:
- Windows 7
- Windows 8
- Windows 10
- Windows 11
- Windows Server 2008
- Windows Server 2012
- Windows Server 2016
- Windows Server 2019
- Windows Server 2022
Others versions should work, but I have not tested them. If you try it, and it does work, let me know and I'll add it to the list. Thanks!
Revision: v2.2.4.0
========================
-Enhancement - Allow usage of %now%, %computername%, and %username% in "/FromName" (in xml and cli).Revision: v2.2.3.0
========================
-Bug Fix - Message Priority header fix -- added additional priority headers for different email account types
-Bug Fix - %ParamX% now replaced in Text File Body message when sending test email through GUI -- was working through CLI prior
-Minor Bug Fix - relabel "TSL" to "TLS" -- too many acronyms in my head. keeping "/tsl" argument for legacy support for people.
-Minor Tweak - rearrange main window in GUI to make slightly smaller.Revision: v2.2.2.0
========================
-Bug Fix - "Reply-To" issue resolved.Revision: v2.2.1.0
========================
-Enhancement - Increased number of Parameters that can be passed from 5 to 9
-Minor bug fixesRevision: v2.2.0.0
========================
-Updated .NET Framework version to 4.6.2Revision: v2.1.9.0
========================
-Enhancement - Added "Generate Message-Id" functionality
-Tweak - updated Donation link to "https://www.tbare.com/donate/prod=swithmail"Revision: v2.1.8.0
========================
-Enhancement - Added CC, BCC, and Attachments to Logging fileRevision: v2.1.7.0
========================
-Enhancement - Added /Log and /Priority optionsRevision: v2.1.6.0
========================
-Bug Fix - Resolve issue with Outlook replacing extension with ".dat"Revision: v2.1.5.0
========================
-Enhancement / Bug Fix - Added fix for Wildcard attachments that doesn't ignore text before the asterisk.Revision: v2.1.4.0
========================
-Enhancement - Added option to not auto replace new lines with '<br/>' for html email (fixes .html file body text files)
-Enhancement - Added alternate "plain text" view for HTML emails to help reduce SPAM score.Revision: v2.1.3.0
========================
-Enhancement - Added Support for wildcards on attachments ("c:\path\to\files\*.csv" will attach all .csv files in the folder -- NOTE: You must specify the file extension -- *.* will not work).Revision: v2.1.2.0
========================
-Enhancement - Added /ReadReceipt (or /rr) to request a read receipt (where the client acknowledges and agrees)Revision: v2.1.1.1
========================
-Bug Fix - fixed encoding issues when using non-US characters in ANSI text file for /bodytxtRevision: v2.1.1.0
========================
-Enhancement - Added /Encoding (or /enc) argument - Specify different charset to be used (UTF8 by default)
-Enhancement - Updated GUI to allow for /BodyTxt file selection and /Encoding field
-Enhancement - Updated XML to hold /BodyTxt and /Encoding argumentsRevision: v2.1.0.0
========================
-Enhancement - Added /BodyTxt (or /btxt) argument - specify a text file to be used as the message body. (%Param1% - %Param5% CAN be used in the text file and be replaced by arguments.Revision: v2.0.9.0
========================
-Enhancement - Added Exit Codes ('0' for success, '1' for error) for batch file useRevision: v2.0.8.0
========================
-Bug Fix- Fixed hang when running as scheduled task as different userRevision: v2.0.7.0
========================
-Added "Username" field - now you can specify a different "Username" other than the send from email addressRevision: v2.0.6.0
========================
-Added "Reply To" field - now you can specify a different "Reply To" addressRevision: v2.0.5.0
========================
-Removed Colon (:) and Equal sign (=) separator for CLI arguments - was causing issue when those characters were in the strings behind them.Revision: v2.0.4.0
========================
-Bug Fix - fixed /sub argument string changing to "true" when using the long CLI form.Revision: v2.0.3.0
========================
-Added option to Obscure password in XML file from the GUIRevision: v2.0.2.0
========================
-Added global variables %now%, %computername%, and %username%Revision: v2.0.1.0
========================
-Fixed error where CLI string would clear from clipboard when program closedRevision: v2.0 (Changes from v1.5)
========================
- Removed settings from saving "in-app" - now all settings are saved to an XML file, and the XML file is called from the command line
- Added support for multiple file attachments - up to 4 in-app, unlimited** in XML file and in command line
- Added support for generating CLI string for you, taking the guess work out of your arguments
- Changed Usage screen to be slightly easier to read
- Changed Settings screen to be tab-based, allowing for smaller screen, and more settings
- Several other minor tweaks and enhancements** "Unlimited" means that SwithMail will try to deliver all attachments - email providers may have limits not enforced by SwithMail - If that limit is exceeded, emails may fail to send.
Typical disclaimer applies:
This software is provided by the copyright holder and contributors "as is" and any express or implied warranties, including, but not limited to, the implied warranties of merchantability and fitness for a particular purpose are disclaimed. In no event shall the copyright owner or contributors be liable for any direct, indirect, incidental, special, exemplary, or consequential damages (including, but not limited to, procurement of substitute goods or services; loss of use, data, or profits; or business interruption) however caused and on any theory of liability, whether in contract, strict liability, or tort (including negligence or otherwise) arising in any way out of the use of this software, even if advised of the possibility of such damage.
Basically, I am not responsible for the way this application is used, nor can I ensure that no damage will be caused by using this program. Don't use it to send SPAM. Please... that's not why I wrote it, and nobody likes SPAM!
