****************************
*  Carteiro 1.0b - FREEWARE   *
****************************
Copyright (C)2003 A. Madeira All rights reserved

Overview

I wrote Carteiro because I needed a program that could send congratulations by e-mail to a list of people (collaborators) on their birthday without my intervention. This is a beta version that is working in my computer.

Carteiro is an SMTP client that sends e-mails in two fashions: from the GUI of from a Command Line. This is NOT a SPAM MACHINE! You are NOT allowed to send unsolicited mail with Carteiro! You are warned.

Running Carteiro

To be able to run it from the command line, two files are required: 'carteiro.csv' and the message text file (*.txt - Parameter4);

The 'carteiro.csv' is a CSV file (a) that must have, at least, 3 fields:

• NOME - name of the person - free format

• EMAIL - one valid e-mail address (b)

• ANIV - day and month of birth - format DDMM (c).

(a) Coma Separated Values format. You can create the carteiro.csv file with Notepad or Excell
(b) Feature: any e-mail address started with * (asterisk) will be skipped.
(c) In your country you may have to use the format MMDD

The message text file (*.txt) is where you write the body text of the e-mail message. This file must exist in the same directory where is carteiro.exe.


Running Carteiro from its GUI is self-explanatory. See in next lines examples of running Carteiro as GUI or Command line.


GUI Examples

Mail From Address:
me@mydomain.com
or
My Name <me@mydomain.com>

Mail To Address:
him@hisdomain.com
or
His Name <him@hisdomain.com>

Mail Host Name (or IP):
smtp.theirdomain.com
or
123.45.678.90

Note: Default port number of the Mail Host is 25. If you want to use a diferent port you need to add the ':Portnumber' modifier after the Mail Host Name (or IP).
Example using port 27: smtp.theirdomain.com:27 or 123.45.678.90:27

COMMAND LINE Examples

Format (7 parameters separated by one space):
carteiro.exe Parameter1 Parameter2 Parameter3 ... Parameter 7


Parameter1 (Host Name): see example above "Mail Host Name (or IP)"

Parameter2 (Mail From): see above "Mail From Address"

Parameter3 (Subject): Subject of the message

Parameter4: (body message): text file that must exist in the same directory

Parameter5: optional Username for connecting to your host (or NONE)

Parameter6: optional Password for connecting to your host (or NONE)

Parameter7: optional Copy To e-mail address (or NONE)

Note: in command line mode the To addresses list is retrieved from the CSV file (carteiro.csv).



Command line example 1:

mail.myhost.org "ME <van@eb.ru>" "Happy Birthday!" message.txt none none none

Command line example 2:

myhost.net xan@aweb.hk Surprise! "my message.txt" none none vc@v7c.cn

Important: Parameters cannot have spaces. If you need spaces you must quote the parameter. See above examples, please.


Log file

In command line mode, Carteiro writes a log file in its directory. The log has the format "carteiro_YYMMDD_HHMMSS.log"


Install/Uninstall

To install, put carteiro.exe, the CSV file (carteiro.csv created by you) and the message text file (*.txt created by you) in the same folder. To uninstall, delete all of them.


Help, warraties, license and price...

Well. That's all for help. No warranty. Freeware if NOT used for spam. Price to use Carteiro to send unsolicited mail: EUR 1000000000.00 per email (just in case...).

************************************************************************

Last modified: