
                       Integrating Potato with Email Apps
                                 Version 2.2

The normal procedure for sending Potato's output file is to insert it into the
body of a new message using your mail software. The insertion must be a text
insertion, not an attachment. Finally, you type or paste the address of the
remailer in the To: field.

In addition to the above method, Potato can produce messages in UNIX message
file format. If you are using Netscape 3.0 or 4.0, Eudora, or Agent, Potato can
copy the output file directly into your email client for sending.

In addition, Decrypt can write a UNIX message file, so that decrypted nym mail
can be read using your email app, including the ability to save attachments.
(For information on using Decrypt with email apps, please consult Decrypt.txt)


                       Instructions for Netscape Mail 
                       Instructions for Eudora 
                       Instructions for Agent and Others 
                       Additional Notes 
                       Instructions for Net-Tamer 
                       Other Email Clients 





Configuring Potato for Netscape 3.0 and 4.0

Modify the UNIX Message File section of pot.ini.
Here is a typical Netscape Mail 3.0 configuration:

# UNIX Message File
---unixform=netscape3
---unixfile=c:\progra~1\netscape\Mail\outbox

# UNIX Message Headers
---lst=14
From: myname@myisp.com
FCC: /C|/Program Files/netscape/Mail/Sent
Subject: None
---end


Here is a typical Netscape Mail 4.0 configuration:

# UNIX Message File
---unixform=netscape4
---unixfile=c:\progra~1\netscape\users\default\mail\outbox

# UNIX Message Headers
---lst=14
From: myname@myisp.com
FCC: /C|/Program Files/netscape/users/default/mail/Sent
Subject: None
---end

"unixfile" must be adjusted to specify the pathname of Netscape's Outbox on your
system. Note that Windows95 long directory names are NOT valid. You must use the
DOS "8.3" equivalent.

Note that Netscape's "Outbox folder" is really a file named "Outbox" contained
within Netscape's "Mail" subdirectory.

The header list should contain at least a valid From: header. You may put the
same address here as you have configured in Netscape, as some remailers require
a valid From address.

You may include the following header:

FCC: This is an internal header used and removed by Netscape when mail is sent.
It tells Netscape what folder the mail should be copied to after sending. If you
do not include an FCC line, the mail will not be copied to a folder after
sending. Note that in the FCC headers: a) there is a preceding "/", b) colons
are replaced by pipes "|", and c) forward slashes "\" are replaced by
backslashes "/". Also, Windows95 long filenames *are* valid in the FCC header.

Additionally, you may include any headers you want added to Netscape's outgoing
mail, such as a Subject.


Creating and Sending Mail with Netscape

After the above adjustments have been made to pot.ini, use the following
procedure for sending mail:

      Run Potato normally. When Potato creates mail.out, it will automatically
      add it to Netscape's Outbox. If you wish to send more than one message,
      run Potato again as required. You may ignore the message telling you to
      send mail.out.

      To send the mail, in Netscape Mail 3.0 select Send Messages in Outbox from
      the File menu. In Netscape Mail 4.0, select Send in Outbox from the
      Message menu.

If you would like to clear the Outbox folder from within Potato, please read the
Additional Notes section at the end of this document.

Netscape 4.0 Users:
Netscape 4.0 is more particular about it's Outbox folder. You should not have
the Outbox folder open in Netscape when Potato is running, or you will receive
an Access Denied error. If you experience other Access Denied errors, try
leaving the Outbox folder untouched until after you have sent the mail. In
general, there is no need to open the Outbox folder.





Configuring Potato for Eudora Pro and Eudora Light (Version 3.0.x)

(Thanks to Medicine Man for providing these instructions.)

Since Eudora uses UNIX message file format, Potato can copy its output file
directly into Eudora's Out Mailbox (out.mbx). Set up pot.ini as follows:

# UNIX Message File
---unixform=standard
---unixfile=c:\eudora\out.mbx
(modify path as necessary - must use DOS "8.3" format)

# UNIX Message Headers
---lst=14
From: your@real.address.goes.here
Subject: (This field is not required. This entire line may be omitted.)
---end


Creating and Sending Mail with Eudora


After the above adjustments have been made to pot.ini, use the following
procedure for sending mail:

      Compact the Out Mailbox if necessary. The reason for doing this is that
      Eudora is going to recreate the Table of Contents for this mailbox later
      on in this procedure. If it is not fully compacted, all messages that have
      been "deleted" from it will reappear. To compact the mailbox, you could
      use Special/Compact Mailboxes from the menu. However, this will compact
      all of your mailboxes. Depending on how many you have, this could take
      some time. A better way is to open the Out Mailbox so that the message
      summary window is displayed. There is a button in the lower left hand
      corner of the screen next to the horizontal scroll bar. This button
      contains three sets of numbers separated by slashes (the first number
      represents the number of messages that the mailbox contains, the second is
      the disk space in KB that the messages are occupying, the third is the
      amount of disk space that would be regained if the mailbox were to be
      compacted). If the numbers are grayed out and the third number reads zero,
      then the mailbox does not have to be compacted. If the numbers are not
      grayed out, then click on the button and this mailbox will be compacted.

      Close the Out Mailbox.

      Run Potato normally. Each run appends a message to the Out Mailbox.

      To send the mail, open the Out Mailbox. The following message will pop up:
      "Mailbox Out has been changed since its Table of Contents was created. Do
      you wish to use the old Table of Contents or create a new one?" Click the
      "Create New" button. The Out Mailbox message summary screen will be
      displayed. Now select and open each message that Potato has added and
      click on Queue (or Send if you have Eudora configured for immediate send).

      After all messages have been queued, send them as normal.






Configuring Potato for Forte's Agent and Others

Potato can generate a standard UNIX message file. Any program which imports or
sends messages stored in this format can be used to send Potato's mail.

Modify the UNIX Message File section of pot.ini. Here is a typical Agent
configuration:

# UNIX Message File
---unixform=standard
---unixfile=c:\temp\unix.out

# UNIX Message Headers
---lst=14
From: myname@myisp.com
Subject: None
X-Folder: Potato
---end

"unixfile" should be adjusted to specify the pathname of the UNIX message file
you want to write on your system. If not specified, Potato will write to
UNIXFILE.TXT in the ini path. Note that Windows95 long directory names are NOT
valid in the "unixfile" specification. You must use the DOS "8.3" equivalent.

The header list should contain at least a valid From: header. You may put the
same address here as you have configured in Agent, as some remailers require a
valid From address.

Additionally, you may specify an X-Folder header. This tells Agent what folder
to import the message to. Agent will remove this header when importing.

You may also include any additional headers you want included in your outgoing
mail, such as an optional Subject header. 


Creating and Sending Mail with Agent

After the above adjustments have been made to pot.ini, use the following
procedure for sending mail:

      Run Potato normally. When Potato creates mail.out, it will automatically
      append the UNIX message file. If you wish to send more than one message,
      run Potato again as required. You may ignore the message telling you to
      send mail.out.

      In Agent select Import Messages from the File menu, and specify the file
      you wish to import.

      Once the messages have been imported, select a message to send, and select
      New Copy of Message from the Post menu. Send the message in the usual
      fashion.




Additional Notes

      Before pressing Alt-r to run, pressing Alt-u will enable overwriting of
      the UNIX message file (or Netscape Outbox folder) on the next run only.
      All messages currently in the file will be erased. (Netscape automatically
      clears its Outbox after sending. However, the data is not actually erased
      unless you Compact Databases or Empty Trash folder.)

      Pressing Alt-u again will disable UNIX file writing. You may also set the
      default enable in pot.ini

      UNIX message file writing is disabled when using the Multiple (Alt-q) run
      function.





Net-Tamer

(Thanks to Zack <zack@anon.efga.org> for his assistance with Potato and
NetTamer.)

To make Potato's "mail.out" output files compatible with Net-Tamer, simply add
the following line to pot.ini: 

---nettamer=yes

This function overrides the incaddr function.

The first pathname listed in pot.ini's "Output" list (normally mail.out) is the
default mail output file. When Potato runs, it will create this file with the
extension "$20". The next time you run, the mail will be written to "mail.$21",
etc. These files may then be mailed directly using Net-Tamer.





Mailing Large Messages - Other Clients

If you cannot use the UNIX message file methods described above, the following
information contributed by users of other programs may be useful to you.

Potato requires you to use your mail software to send the final message it
generates. Some programs have size limitations. Forte's Agent (also avaliable in
a freeware version) can insert extremely large text files into the message body,
making it very applicable for use with Potato. Also, MS Internet Explorer 3.0
Internet Mail can insert large text files.

A Potato user contributed the following information:

      Some users may enquire about their seeming inability to send large files
      through remailers after preparing them with Potato. The fault almost
      certainly lies with their email client.

      I suffered from that problem. The ONLY email client (that I know of)
      allowing *direct* insertion of files >~35kb in to the message body is
      Agent. I tested Agent V1.01, Pegasus V2.54, DTmail, Mailcat, Eudora Lite
      V3.02, Netscape 4.01 and Netcplus -Smart Mail V3.02. (All on the WIN3.11
      platform only.) 

      Pegasus is one of the very few that allows complete disablement of MIME
      headers. But it will only allow direct import into its msg body of about
      35k. Any file larger than that requires using the attachment function with
      all MIME headers turned off. The attachment must be set to be in the msg
      body and treated as "text in" and with ASCII encoding in the attachment
      dialogue box.

      You must then send the mail to yourself, open it and then forward the mail
      after editing out the offending line shown below:

      -------------- Enclosure number 1 ----------------
      ::
      Encrypted: PGP


From another user:

      Inserting text into mailer: The MS IE 3.0x Internet Mail client makes this
      easy. Insert/TextFile looks for files with extension .txt and can handle
      at least a 150 KB file. I haven't checked for any larger limits. 
      
      
