YAMS - version 2.20
Yet Another Mail Sender
FREEWARE or POSTCARDWARE
Sam Francke copyright 2000 2001

O. Contents of help.rtf
-----------------------
   I. Postcard
  II. Feedback
 III. About This Program
  IV. How To Use The Program
   V. Add and Edit Account
  VI. Import from LDIF file
Via.  Import from any CSV file [version 2.10]
 VII. Multi Language [version 1.10]
VIII. Message Template [version 2.00]
  IX. Preview Window
   X. Manipulate Recipients in ListView [version 2.00]
  XI. Signature File [version 2.00]
 XII. Registry
XIII. Addresses
 XIV. More About [version 2.00]

I. Postcard
-----------
If you are using YAMS, send me a postcard of your dwelling-place. 
That will give me a motivation for further development of YAMS. 
Address see below.
It is cheapest way of registering a program :
If you mention your e-mail address on the card, I'll
send you a message of receiving your card.

II. Feedback
-------------
1. If you have comments, found bugs or you have a suggestion
send me a mail.

III. About This Program
-----------------------
YAMS is a simple freeware SMTP mailer. It sends the same e-mail in many recipients.
This means that Yams sends to every recipient as mailing him separately.
IT IS OF COURSE NOT MEANT TO SEND UNSOLICITED E-MAIL TO RANDOM PEOPLE.
Great for program updates, invitations and so on.

IV. How To Use The Program
---------------------------
1. Add an account (if you use YAMS for the first time with menu [Account][Edit];
2. Load or create a message;
3. Load or create a list with receivers;
4. Choose a log file type, with menu [Options]; 
5. Fill out the subject edit box;
6; Push the Send button.

V. Add and Edit Account
------------------------
Adding a new account:
1. menu [Account][edit];
2. fill out the top right edit box new account name and click the plus button;
3. now your account name appears in the first edit box below the line;
4. now fill out the other edit boxes and hit the green check button;
5. an message box appears that you have added your new account. 

Editing an account:
1. select an account in the top left combobox;
2. now edit one or more items;
3. push the green check button and your changes are accepted.
The fields to edit: 
1. smtp server, eg smtp.metal.net;
2. your name for login at your smtp server, eg John Smith;
3. your name for the header in the send e-mail, eg WebMaster J.Smith;
4. e-mail address for reply-to and return path, eg JohnSmith@metal.net.

VI. Import e-mail addresses from LDIF file--Netscape
------------------------------------------------------------
Only for Netscape 4.7x users.
1. if you add an e-mail address to your (Netscape address book enter a 'Nickame', eg t2t,
t2t is now a search item for YAMS's import from LDIF file;
2. if you right click on PersonalAddressBook in the left window of Address Book,
click [New List...] enter the name of List Name edit box, eg family;
go to the right window and select the addresses you need for the new list;
drag with left mouse button down to the family list and drop them;
the list name 'family' is now a search item for YAMS's import from LDIF file; 
3. create a LDIF file with Netscape 4.71:
select address book
menu [File][Export...]
give the file a name and save the file (with the extension ldif
that's all
4. activate YAMS menu [Extra][import Netscape addressbook];
select one of the options ... if necessary fill the search item in the edit box;
click the [open file button], and open the LDIF file, the e-mail addresses found,
are stored in the YAMS main window receivers list;
5. click the button [close window];

VIIa	Import from any CSV file
The CSV (comma separated values) are an ascii (i.e. plain text) representation of spread-sheet data. 
The values are separated by commas, to indicate the separating points for columns. 
There are also files like TCV (tab separated values) or a semi-colon can be used as a separator.
	
A CSV file looks like this:
Name         ,First Name ,Last Name ,Address            ,Country ,NickName
John West    ,John       ,West      ,johnw@hotmail.com  ,UK	 ,T2T
Maria East   ,Maria      ,East      ,maria@softmail.com ,USA	 ,T2T
Gerrit Poppe ,Gerrit     ,Poppe     ,poppe@mymail.nl    ,NL	 ,YAMS
 
Each value has is own place in the CSV file. Country is in column 5, Name on the first.
With Netscape, OutLook Express and other e-mail programs you can produce CSV files 
from their address books.
YAMS uses also a CSV file to store the recipients.(see .lst files)
Name; Address; Nickname
	
Suppose the example (see above) is a Netscape CSV file.
The Name value in the first column had to be moved to the first column in YAMS, 
the address value in the 4 th column had to be moved to the second column in YAMS,
and NickName from column 6 to the third column in YAMS.
With the import utility we can do that in five steps.
	
Step 1:
Select an input CSV file and an output file to store the imported addresses.
(Select as source file test_csv.txt, shipped with YAMS as example file)
	
Step 2:
In the window 'selected source file' you see the contents of the selected source file.
Select a row in that window, in which you recognize the items to import,
name, e-mail address and nickname. The separator is selected automatically.
	
Step 3:
On the left the items needed in YAMS: name, address and nickname.
On the right: yellow labels named: name, address and nick name.
At the bottom right sided a list box named: 'items found in source file' 
with the found values and their columns in the source CSV file, [item1] and so on.
Now drag and drop [item 1] the name to the yellow label named: name,
drag and drop [item 4] to the yellow label named: address and
drag and drop [item 6] to the yellow label named: nickname. 
When you have done this, it is clear to YAMS how to transport data from the input to
the output file. 
	
Nick name is optional, you can also drag and drop [item 5] 'country'
to the yellow nick name label  or another one. 

Step 4.
Here you can filter or search on a selected item. Drag and drop [item 5] to
the yellow label named: [none].
Click the check box 'set filter', select 'global' or 'exact',
add USA in the search edit box.

Step 5.
If you have done everything, the import button is enabled, click and the addresses 
are imported to YAMS, in this case all the addresses in the USA.
The file with imported addresses is saved to disk now. 	
If you are not content with the result, you can repeat Step 2, Step 3 or Step 4.
If an error occurs you can hit button 'show errors' to see the lines with errors.

VII. Multi Language
--------------------
YAMS in your own language.
When you start YAMS for the first time, YAMS is in English.
If you want YAMS in Portuguese or Dutch, select menu [Language] and select
the language you want.
Language modules are: portugues.dat, nederlands.dat and english.dat.
If your language is not there, feel free to translate the text file
language.txt in your own language, for instructions see language.txt.
E-mail language.txt to me.

VIII. Message Template
--------------------
Use a template mail with $name$ as name field like this:
	 
Dear $name$,
here your message
	
The field $name$ is replaced with the name in the ListView corresponding
with the e-mail address. $name$/$nickname$ can be placed every where in 
the message, and as many times you need.
The same applies for $nickname$.
A message without $name$ or $nickname$ does not occur an error.
In the preview window the result is visible.

IX. Preview Window
-----------------
When for the first time a message is opened, the preview window is show.
This to show you how your message looks like when it is sended to a
recipient.
In the preview window is also shown the replacement of $name$ and $nickname$,
if the signature file is also loaded in the preview window, if activated.
 
Like the preview window shows your message, your message is send.
 
X. Manipulate Recipients in ListView
---------------------------------------
The receivers are placed in a ListView, with three columns:
name, e-mail address and nickname.
Click one of the headers to sort the list.
Multi selecting is enabled, with key [shift] pressed a range is selected,
with the [ctrl] key pressed, individual items are selected or unselected.
With double click on an item, the edit window is enabled.
Right clicking enables a pop up menu with the next items:
edit, add, delete, changes nicknames and save selected items.
delete, changes nicknames and save selected items can be used on multi selected items.
'Old lists' (version 1.00 and 1.10 can be 'imported' via menu [file][load old lists].
It is possible now to send to selected recipients, check [send to selected receivers],
if [send to selected receivers] is not visible, pull down the blue split bar above the message window.
 
XI. Signature File
--------------------
In the option window, check [signature file] and select a file with the load file button.
In the preview window the signature file is shown.
The message shown in the preview window, is the message which is send to the recipients.
Editing in the preview window has no affect, every time a new receiver is selected for sending
YAMS built a new message, with the field $name$ and the sign file.

XII. Registry
-------------
window position and so on are stored in the window registry
you can find them in HKEY_CURRENT_USER / YAMS;

XIII. Addresses
----------------
Sam Francke
mailto:s.j.francke@hccnet.nl
home page: http://home.hccnet.nl/s.j.francke/yams/yams.htm
feedback page: http://home.hccnet.nl/s.j.francke/yams/feedback.htm
address for postcard:
Sam Francke
Arendlaan 41
3853 SB Ermelo
The Netherlands

XIV. More About
----------------
YAMS was written using Delphi 3 professional.

THIS PROGRAM IS NOT INTENDED TO BE USED FOR SENDING UNSOLICITED E-MAIL (SPAM.
ALSO I DO NOT IN ANY WAY INTEND TO FEEL RESPONSIBLE FOR HOW THIS PROGRAM IS USED. 

YAMS is freeware which means that you are allowed to redistribute the program as 
long as you distribute the full archive with the following files:

setup.exe and readme.txt.

Files created by YAMS:
yams.dat - file with accounts
*.mes - message files
*.lst - recipients list files
and log files.