WINBOX 4.2
-------------------------------------------------------------------------------
WinBox 4.2 (October 1997)
POP3, IMAP, SMTP and NNTP client (MIME compliant) for
Win 95 and Win NT.
Copyright (C) 1996 by Agustin Lopez Bueno & Centro de
Informatica - Universitat de Valencia. All rights reserved.
-------------------------------------------------------------------------------
(PLEASE REVIEW THE ENTIRE CONTENTS OF THIS HELP!!!!)
Winbox is a windows network application to read and send e-mail using common
Internet protocols.
More technically, Winbox is a standard POP3, IMAP 2, 3 and 4 (to read remote mailboxes),
SMTP (to send mail) client application for Windows Sockets. Optionally
(activating them in the winbox.ini), WinBox is also a simple NNTP (to read
Usenet News), Finger, Lookup to Name server, Time and Echo client.
This program is known to work with:
- Windows95.
- Windows NT.
- PPP and SLIP.
Return to Contents
IBM PC compatible machine.
MS Windows 95 or Windows NT.
WinSock v1.1 compliant TCP/IP stack.
Mouse (recommended).
4 Mb RAM (recommended).
Winbox requires you to have a properly installed WSOCK32.DLL.
If you don't have a WSOCK32.DLL, I'd suggest getting the
free one from Microsoft or the shareware Trumpet Winsock
from ftp.trumpet.com.au or buying a vendor supported one
(for example from FTP Software, Inc).
Windows NT and Windows 95 come with a WSOCK32.DLL. If you
use a different vendors stack on these platforms you will
need to replace the WSOCK32.DLL that comes with the OS.
Return to Contents
Winbox is distributes in several languages:
- English
- Spanish
- Catalan
- Germanish
- Swedish
- Finnish
If you want to translate Winbox to another language,
please contact with the author. It is easy to do it.
Winbox mantains all the labels in Windows resources.
Return to Contents
Files included in this package are:
- index.htm Main help file (in HTML format).
- changes.htm Differences entre Winbox releases (in HTML format).
- winbox.exe The program.
- winbox.ini The definitions/preferences file for Winbox.
- binhex32.dll Library for BinHex 4.0 coder and decoder.
- ilbdem95.dll Shareware library for displaying images in HTML.
- dmgrafik.dll
- register.txt
- xfaces32.dll Library necessary to send and display xfaces.
- welcome.msg Initial welcome message for default mailbox.
- nosplash.xxx If you want not display the splash picture, rename this
file to "nosplash"
- english.dll These are the language dlls.
- spanish.dll
- catala.dll
- german.dll
- swedish.dll
- finnish.dll
Return to Contents
- Full IMAP client.
- POP3 client.
- Using POP3 protocol and a standard server, WinBox can RETRIEVE EACH MESSAGE
INDIVIDUALLY and see the mailbox index WITHOUT RETRIEVING all the mailbox!.
- Also, as usual in POP3 clients, WinBox can:
- retrieve all messages and delete the server copy
- retrieve all mail and leave copy in the server
- retrieve the new mail periodically (if deleting the server copy)
- MailUtil client. Using this (non-standard, but easily UNIX-installable) server,
the users can CHANGE THEIR PASSWORDS and FORWARD THEIR MAIL without administrator
intervention. E-Mail "Hector.Rulot@uv.es" for server details.
for more details
- Send mail directly via SMTP.
- Winbox is also a simple NNTP client and has many network tools: Finger, Lookup to
Name server, Time client and Echo client. All of these extras can be disabled in the
winbox.ini file to simplify the user view of the program.
- WinBox has Multi-Language support: all the program is EASILY TRANSLATABLE by
modifiying only resources via a resource editor. There are already English,
Spanish and Catalan versions.
- WinBox is MULTI USER. The configuration, preferences and all private files of
each user are automatically stored in a separate directory. The distinction is
done BY USER NAME. Also, WinBox can be launched specifiying the directory of
users directories (see command line parameters).
- MIME compliant.
- Besides MIME BASE64 & (text) Quoted-printable coding, WinBox can
code atachments with UUENCODE and BinHex 4.0.
- Besides MIME BASE64 & (text) Quoted-printable decoding, Winbox can
decode UUENCODE and BinHex 4.0 messages (not only MIME attachments).
- For non-english language users, Quoted printable encoding can be disabled,
or the program can be intructed to ASK before doing a quoted-printable encoding.
This encoding is activated whenever a non-7bit character is found in the
message text.
- When no using Quoted-printable encoding, you can EASILY DEFINE THE CODE TABLE for
8 bit chars sustitution, simply editing winbox.ini. You can change one char for one or
more chars (up to five).
- Subject field will be translated with the winbox.ini table
if have 8 bits chars.
- WinBox can automatically launch viewer applications based on the the MIME
type/subtype of the attachment. Any type/subtype can be defined and can have
its viewer associated to it.
- SORTS Messages by Date, From, Subject or Size, in ascending or descending order.
- MULTIPLE address books, signatures and LOCAL mailboxes are handled.
- The alias in an address book can be GROUPS of e-mail adresses (limited to a
255 chars list).
- Arbitrary complex addresses are supported (including Carbon Copy and Blind Copy).
- Automatic wrap of the text when you are writing the message.
- Can save automatically all sent messages.
- Autologin: Winbox can store user/password for its initial connection. Obviously
this is only useful for PRIVATE and physically secure PC's.
- "Pause" command, to lock the connection or message editing without losing it.
- Replies (which ask if you want to include original messages and are
"Reply-To" aware) and forwards.
- Fast POP3 Indexing (WARNING: This is not POP3 standard. EMail Hector.Rulot@uv.es
for more details).
- Auto signature (appending it to the written text or like text or
html attachment)
- HTML attachments. If you attach one HTML file to your message,
Winbox will find the local files appointed in that file and send then
all like MIME attachments (warning: this is in probes).
- Send and display xfaces.
- Send and show "X-Url" header field.
Return to Contents
YOU MUST HAVE A PROPERLY INSTALLED WINSOCK.DLL FOR THIS APPLICATION
TO WORK. REFER TO YOUR WINSOCK.DLL DOCUMENTATION FOR SETUP!!
1. Create a directory for this program and expand and copy there all
the files of the package.
2. By default, Winbox uses 'C:\MAILUSER' directory for saving users
address books, signature files and mailboxes. If you want other directory
for this, edit winbox.ini and change the [general]usersdir entry.
3. Create an ICON for WinBox in any Program Manager group (by dragging the
winbox.exe from the file manager to the desired program group of the
program manager).
4. Launch the program by clicking two times on the ICON.
5. Press "cancel" at the user/password menu. Click Setup
and set correctly the fields of all setup "cards" (see below for an
explanation of them).
6. Now, with Mail/Read messages or Mail/Change user, you can access your
mailbox. Note that you must have your mailbox opened before be
abled to write and send messages.
Return to Contents
In Setup:
-General:
- TMP directory: Winbox needs a tmp directory to save and read several
tmp files.
- Timeout (in seconds) for network connections.
- Font (type and size): for writing and reading messages.
- Default printer.
- User (non-writable field): display the actually logged user.
- Read Mail at Startup: get index automatically after the user signs-on.
- Wrap lines: (When compossing messages) auto wrap the lines the user writes
when the length of a line reaches this number.
- Confirm message deletion when closing mailbox.
- Spaces by tab: Winbox will convert the tab chars to spaces.
- Ignore "Reply To". If this is checked, the replies are always done to
the "From:"address.
-Misc:
- Default "sentmail" mailbox, signature and address book.
- Save sent mails: when the user sends a message, save it in the default
mailbox (this option can be overriden when writting the message).
- Sign sent mails: Automatically sign sent mails with the default signature
(this option can be overriden when writting the message).
- Signature as attachment: You can choose append the signature as text at the
end of the message or like the last attachment (text or HTML).
- You can setup two parameters for the time server:
- DST: Daylight savings time. Only add one hour if it is checked.
- GMT: Greenwich Meridian Time. Add the numbers of hours specified.
- You can set your Web home page and the Web browser.
-MIME options:
- If you don't check "Quoted-printable encoding", Winbox will code the 8 bit
chars (code>127) with the table defined in "winbox.ini".
See the [Character_Translations] entry of winbox.ini. The format is
"Decimal_character_code=character[s]" up to 5 chars.
- "Ask before encoding" means that if you use any 8 bit char (usually non-US
chars) in a message, WinBox will ask you permission to quote-printable encode
it. If this option is not checked, WinBox WILL ENCODE the message without
warning.
- You can add and modify the MIME Type/Subtype entries. You can assign a
MIME Type/Subtype to any DOS/Windos file extension, and the viewer to
launch to see it. This table is used when sendig and receiving MIME
attachments.
-Mail server:
- Address (IP name or number) and port (the standard is 110 for POP and 143
for IMAP) for the mail server.
- For the POP3 server:
Retrieve:
- At request: don't retrieve all the messages from the server. Winbox
will show the index of the mailbox and will keep the connection open
so you can get only the messages you want.
- All messages, but let the server keep the original ones.
- All messages, and DELETE them from the server (the standard POP3 behaviour).
When this option is checked, you can instruct WinBox to ask every time
before retrieving (and deleting) all from the server. Also in this case,
Winbox can check if there are new mail every specified amount of minutes.
- Fast Indexing (WARNING: not standard!): If you server support this feature,
the indexing proccess is a lot faster (email Hector.Rulot@uv.es to ask for
the modified POP3 server).
- For the IMAP server:
- You can check if there are new mail every specified amount of minutes.
- Pass "From" to SMTP daemon: With this option checked, Winbox will send the line
"From: " to the SMTP server. SMTP servers could need or not this option to
resolve aliases.
-SMTP server:
- Address and port (the standard one is 25) for SMTP server.
- Email domain.
-Other servers:
- Address and port (usually 119) for NNTP (NetNews) server.
- Address and port (usually 106) for Change Password server. This server is
non-standard, but the system administrators of POP3 servers habitually
install it.
- Address and port (usually 106) for Change Forwards server. Note that this
server is a non-standard one; email Hector.Rulot@uv.es for details.
Return to Contents
-You can set the IMAP remote directory to create and work with
remote folders in [general]IMAPremotefolder.
-If you wan not to use any server, like forwards or password,
you can set the server name as "xx.xx.xx.xx" (without ""). This
is the initial configuration for all the servers in the
distributed package.
-When a NEW user makes a login, WinBox asks permission to create a new
directory to save all the files bearing to that user (address books,
signatures, mailboxes,...). Click Ok.
Winbox also copies the winbox.ini in the user directory. All succesive
configuration modifications will be saved in the user private copy
of the "winbox.ini"; and this will be be the configuration file selected
whenever this user logs in. Every user has his own configuration!.
-If you don't want to leave your files in the PC (addressbooks,mailboxes,...)
you must run winbox with some command line parameters. See that section.
-You can generate your user and password (encrypted) with Tools/Make autoconnect file
in a file named autoconn.ini in the Winbox directory (not
in the user directory: in this case WinBox revert to a mono-user behaviour).
When runnig Winbox after that, it will try to log in with this user and
password.
-Clicking the left button of the mouse in the top of the message index,
you sort the list in ascending mode. The same with Control key pulsed,
you will sort in descending mode.
-Clicking the rigth button of the mouse in the message index, you can change
the message flags.
-If you put a file named "nosplash" in the Winbox directory,
Winbox will start without the splash screen.
-If you delete "welcome.msg", this file will not copied to the
initial (default) mailbox created for the new users.
-If you want Winbox show a non-common ASCII MIME attachments in the Winbox
text area, you must configure SETUP/MIME options like this:
type=APPLICATION/PGP
extensions=_W_
launcher=
In this way, Winbox will show APPLICATION/PGP attachs in the text read area.
Use this only for ASCII attachs.
Return to Contents
If you want to send your face in the message, you must do the next
steps:
- Convert your photo to the size 48 x 48 pixels in black and white.
- Save it in XBitmap graphic format (not Windows Bitmap!). Several programs
of UNIX world can do it (like xv). Sorry but I do not know if there are
any Windows program to do this. If anybody knows any, please tell me it.
- Put this file in your user directory with the name "face.xdm".
- That is all. Winbox will insert your face in the message when you send it.
Return to Contents
Now you can two tokens in parameters line:
-dusersdirectory (Full path to the users directory)
-iinifile (Full name of ini file for all users)
example: winbox -dc:\micorreo -ic:\winbox\winbox.ini
If you put the flag -iinifile, the setup menu will be disabled.
This case is for one centralized configuration of multiple users.
Return to Contents
I have mantained compatibility to up among mailboxes y addressbooks of different
Winbox versions. Winbox 3.3 will understand the old formats but not
viceversa.
If you want to mantain the main old ini configuration, rename Winbox.ini to other
name. Now delete all files in Winbox Directory. Uncompress the zip. Now you have three
possibilities:
- Edit the new winbox.ini with your local preferences.
- Run Winbox, press Cancel at User/Password window and then make the changes in Setup.
Restart Winbox.
- Compare new Winbox.ini to old and then add the new Winbox.ini entries to the old
winbox.ini and rename it.
Then copy this file to all the user directories (by example to c:\mailuser\user1). The users
will lost their "user defined" setup preferences (sorry, no conversion
program), but they will not lost their mailboxes, addressbooks and signatures.
Warn them to redefine their preferences.
Return to Contents
WinBox can't:
- Enqueue messages to send them later.
- Send mail via POP3 server.
- The user can't specify a "Reply-To:" address (too many problems for the
postmaster).
- Dialing directly to a Internet.
Return to Contents
If you want to get the last version of Winbox, look at
my Web Home Page:
http://www.uv.es/~lopezj
Return to Contents
I am having problems to show the program in high resolutions with big
fonts. You must use small fonts if you want to see Winbox rigthly.
All bug reports and suggestions for improvement should be sent to
Agustin.Lopez@uv.es.
Return to Contents
- The installer.
- A full help file.
Return to Contents
Thanks to Hector Rulot (Hector.Rulot@uv.es) for his advices.
Thanks to Marcus Juchem for his help in debugging and his
german translation.
Thanks to Martin Gustafsson for his swedish translation.
Thanks to Tero Väisänen for his finnish translation.
Thanks to David Baldwin (dbaldwin@pbear.com) for his shareware
component for HTML viewing. You can contact with David Baldwin in:
22 Fox Den Road,
Hollis, NH 03049, USA
(603) 465-7857
Internet: dbaldwin@pbear.com
CompuServe: 76327,53
For information on the latest versions of the ThtmlViewer and other
Delphi components: http://www.pbear.com/
Thanks to the dwinsock team for his shareware winsocket component.
You can get more info on: http://www.aait.com/dwinsock/
Return to Contents
Agustin Lopez Bueno
Internet e-mail: Agustin.Lopez@uv.es
Centro de Informatica, Universitat de Valencia
Dr. Moliner 50, 46100-Burjasot, Valencia, SPAIN.
THE INFORMATION AND CODE PROVIDED IS PROVIDED AS IS WITHOUT WARRANTY
OF ANY KIND, EITHER EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO
THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
PURPOSE. IN NO EVENT SHALL WE BE LIABLE FOR ANY DAMAGES WHATSOEVER
INCLUDING DIRECT, INDIRECT, INCIDENTAL, CONSEQUENTIAL, LOSS OF BUSINESS
PROFITS OR SPECIAL DAMAGES, EVEN IF WE HAVE BEEN ADVISED OF THE
POSSIBILITY OF SUCH DAMAGES.
**********************************************************************
This program executable and all others text files may be
used without fee by individuals for non-commercial home use, and
by students, faculty and staff of academic institutions, with the
only condition of advise with mail to Agustin.Lopez@uv.es of his
use.
Non-commercial home use: Free, but please if you like Winbox
send an e-mail to Agustin.Lopez@uv.es
Academic use: Free
All other uses: contact Agustin.Lopez@uv.es
Archive sites: This program may be included on Government,
academic and non-commercial Internet archive sites and on CD-ROM
collections distributed by such sites, provided any charge is
solely to recover the cost of distribution. Any such
distribution must contain the complete program, including this
file. Non-commercial Internet archive sites must not be in the
business of making a profit from selling hardware, software,
information or services. (SimTel and mirrors authorized)
For distribution rights and for all other uses, including
all corporate use, please contact the author for
license information.
He can also be contacted via mail at Centro de Informatica,
Universitat de Valencia, Dr. Moliner 50, 46100-Burjasot, Valencia
SPAIN.
**********************************************************************
Return to Contents