CLEMAIL v1.34 – Users Manual
Table of contents
1. Introduction
2. New in this version
3. Restrictions in the demo version
4. Install
5. Uninstall
6. Command line reference
7. Examples
8. About the preconfigured accounts
9. Getting a free email account
10. Web site integration
10. Final words
Command Line E-mailer (CLEMAIL) is a tool that allows you to send e-mail from the command prompt. It’s suitable for batch programming, personal use and applications that need e-mail capabilities. The goal is to bring command line e-mail to the Windows platform, and make it as easy as it possibly can get.
CLEMAIL has a number of preconfigured mail accounts that can be used to send e-mails. You don’t need an account of your own to send e-mails with this tool! It’s also possible to send e-mails using mail services that requires POP authentication (Yahoo for example.)
CLEMAIL runs on Windows 95/98/ME/NT/2000/XP.
Flag to set other encodings than base 64. No encoding is default. Before base 64 was the only encoding. (-encoding)
Flag to intercept and change the MIME message that CLEMAIL generates with an executable that you implement. (-hook)
Flag to print the MIME message that is sent to the smtp server. (-printmime)
3. Restrictions in the demo version
The software has 30 evaluation days. No features are disabled.
Installing CLEMAIL is a simple procedure:
1. Create a directory suitable for installation For example, “c:\Program Files\clemail\”
2. Extract the zip file into the directory. If you don’t have a zip extractor, please download Winzip at http://www.winzip.com/.
The installation is now finished.
If you like, add the directory where you installed CLEMAIL to the PATH environment variable. The system will search that directory when looking for executable files.
Simple. Just delete the files added during installation. (CLEMAIL does not make any changes to the registry.)
Here is a description of the CLEMAIL switches:
-help
Displays version and help information.
-quiet
Quiet mode. No reporting on stdout is done.
-from
Specify the sender’s e-mail address.
-to
Specify the receiver’s e-mail address.
-fromname
Specify the sender’s real name.
-toname
Specify the receiver’s real name.
-subject
Set the subject line.
-subjectfile
Read the subject line from disk.
-body
Set the body of the email.
-bodyfile
Read the body from disk.
-contenttype
Sets the MIME content-type used in the message body. Valid types are: text/plain, text/html and text/enriched. Default is text/plain.
-attach
Attach files. One or multiple arguments.
-smtpserver
Specify the SMTP server.
-smtpport
Specify the SMTP server port.
-popserver
Specify the POP server.
-popport
Specify the POP server port.
-popuser
Specify the username at the POP server.
-poppass
Specify the password at the POP server.
-encoding
Specify the encoding of the MIME message. Valid encodings are: none, base64. Default is none.
-hook
Specify the executable to intercept and change the MIME message. The excutable should read the message from stdin, change it and write it to stdout.
-printmime
Print the MIME message that CLEMAIL generates. Useful in combination with the -hook flag.
Example 1
Using a preconfigured mail account to send e-mails. CLEMAIL chooses a preconfigured account since no -from address or -smtpserver has been specified.
>clemail -to [email protected] -subject “The subject” -body “The body”
Example 2
Set the from and to real name.
>clemail -toname “Roger Karlsson” -fromname “Sureshot” -to [email protected] -subject “The subject” -body “The body”
Example 3
Sending a HTML mail from preconfigured mail account. The subject and body are read from disk.
>clemail -to [email protected] -subjectfile subject.txt -bodyfile body.html -contenttype text/html
Example 4
Attaching two documents.
>clemail -to [email protected] -subject “The subject” -body “The body” -attach attach0.txt attach1.txt
Example 5
Using a specific sender address and SMTP server. None of the preconfigured accounts are used.
>clemail -from [email protected] -to [email protected] -smtpserver mail.cs.umu.se -subject “The subject” -body “The body”
Example 6
Using quiet mailing. No output is written.
>clemail -quiet -to [email protected] -subject “The subject” -body “The body”
Example 7
Sending an e-mail using a yahoo mail. They require POP authentication. The yahoo username is “username” and the password is “password”.
>clemail -to [email protected] -from [email protected] -smtpserver smtp.mail.yahoo.com -popserver pop.mail.yahoo.com -popuser username -poppass password -subject “The subject” -body “The body”
Example 8
Encode the email in base 64.
>clemail -encoding base64 -to [email protected] -subject “The subject” -body “The body”
Example 9
Print the MIME message that CLEMAIL generates.
>clemail -printmime -to [email protected] -subject “The subject” -body “The body”
Example 10
Use another program to change the MIME message that CLEMAIL generates. The result is printed by using the -printmime flag.
>clemail -hook c:\changemime.exe -printmime -to [email protected] -subject “The subject” -body “The body”
8. About the preconfigured accounts
The preconfigured accounts for CLEMAIL have been integrated to make it as simple as possible to send email. If you don’t specify a sender address, CLEMAIL will use one of the preconfigured accounts. Though it is simple and convenient to use the preconfigured accounts, we recommend that you use one of your own accounts if you use CLEMAIL on a regular basis or send a large amount of e-mails. The purpose of the preconfigured accounts is to get a user going as fast as possible, not to serve all mail traffic.
When you use a preconfigured account, your IP address will be appended to the end of the body. This is not the case if you use your own account.
9. Getting a free email account
Here are a couple of mail service providers:
yahoo
nettaxi
CLEMAIL has not been designed for web site integration. This does not imply that you cannot use it on your web server, but there are a few things that you should be aware of. CLEMAIL trusts the input it gets on the command line! This implies that you have to be very careful what input CLEMAIL gets, so you MUST keep CLEMAIL out of the CGI-BIN directory. Our suggestion is to call CLEMAIL from a script that verifies the correctness of the input.
Thank you for using CLEMAIL. If you have questions or comments, please contact
[email protected]
