AmiMAIL
=======

A word about the silicon co-author
----------------------------------

This program was created with extensive AI assistance. That does not mean
security, testing or common sense were handed over to a chatbot. The code was
reviewed, tested on real Amiga systems and developed with security and current
best practices in mind. AI helped to build it; humans still had to make sure
the thing actually works.

Of course, no software can promise absolute security - not even software
written entirely by carbon-based life forms. If AI-assisted code gives you
sleepless nights, makes you fear a Skynet-powered Workbench, or you simply do
not want AI anywhere near your mailbox, please do not use this application.
Your Amiga will not take it personally.

AmiMAIL is a native IMAP/SMTP mail client for AmigaOS 3.2+ using the
ReAction GUI and AmiSSL. It is intended for standard mail providers that
offer IMAP and SMTP access.

AmiMAIL is a single-account client. Messages remain on the mail server and
are accessed directly through IMAP. It does not maintain a local offline
mail database.

Main features
-------------

- Native AmigaOS 3.2+ ReAction interface
- Single configurable IMAP/SMTP account
- Configurable server names, ports and login names
- Direct SSL/TLS and STARTTLS support through AmiSSL
- Optional SMTP login using the same credentials as IMAP
- Automatic detection of standard IMAP system folders
- Manual mapping of Sent, Drafts, All Mail, Spam/Junk and Trash
- Expandable nested IMAP folder tree with remembered folder state
- Optional Inbox fetch at startup
- Optional automatic Inbox check every five minutes
- Compose and reply to messages
- Create, save, reopen, edit and send IMAP drafts
- Optional IMAP copy of successfully sent messages
- Move and delete messages
- Empty Trash and Spam/Junk folders
- Mark messages as read/unread or flagged/unflagged
- Multi-selection for supported message operations
- MIME, Base64, Quoted-Printable and RFC 2047 handling
- Up to 8 outgoing attachments with a combined maximum of 10 MB
- Save attachments from received messages
- Sort messages by sender, subject, date or size
- Local Contacts/Address Book
- CSV and VCF/vCard contact import with duplicate detection
- Contact selection for To, CC and BCC
- Configurable new-mail notification sound using AmigaOS DataTypes
- Native ReAction iconify support with background mail checks
- Window position and size are restored between program starts
- mailto: support with single-instance hand-off
- Built-in GitHub update check and release download to RAM:
- German interface on German systems, English otherwise

Account security
----------------

AmiMAIL stores account data encrypted using a user-defined master password.
Sensitive account information is protected using PBKDF2-HMAC-SHA256 and
AES-256-GCM authenticated encryption.

Requirements
------------

- AmigaOS 3.2 or newer
- Motorola 68020 CPU or newer
- ReAction
- TCP/IP stack providing bsdsocket.library V4
- AmiSSL 5.x with a valid AmiSSL: assign and CA certificates
- Correct Amiga system date and time for TLS certificate validation
- Working Internet connection
- Mail provider offering IMAP and SMTP access

Installation
------------

IMPORTANT: Set the program icon stack to at least 65000 bytes. A value of 100000 bytes is recommended for reliable operation.

1. Extract the archive to an Amiga drawer.
2. Install AmiSSL 5.x if it is not already installed.
3. Make sure AmiSSL: and its CA certificates are available.
4. Make sure the Amiga system date and time are correct.
5. Start AmiMAIL.
6. Open Account Settings and enter the IMAP/SMTP server details.
7. Define a master password for the encrypted account data.

Project and source code
-----------------------

https://github.com/Andiweli/AmiMAIL

License
-------

AmiMAIL is released under the GNU General Public License, version 3.
See the LICENSE file and the project source repository for full details.

Copyright (C) Andreas 'Andiweli' Stuermer.

 PERMSSN    UID  GID    PACKED    SIZE  RATIO METHOD CRC     STAMP          NAME
---------- ----------- ------- ------- ------ ---------- ------------ -------------
[Amiga]                 204709  360236  56.8% -lh5- ca00 Aug 17 17:35 AmiMAIL
[Amiga]                   2126    2888  73.6% -lh5- fb2c Aug 16 22:51 AmiMAIL.info
[Amiga]                  85398  192100  44.5% -lh5- 7f30 Aug 15 11:13 Notifications/newmail-3-Klang-Bright.8svx
[Amiga]                  36190   96100  37.7% -lh5- e534 Aug 15 11:13 Notifications/newmail-3-Klang.8svx
[Amiga]                  42988   96100  44.7% -lh5- 1f05 Aug 15 11:04 Notifications/newmail-Chime.8svx
[Amiga]                  59093  192100  30.8% -lh5- 2e0a Aug 15 11:04 Notifications/newmail-Gong.8svx
[Amiga]                  80663  192100  42.0% -lh5- 7118 Aug 15 11:04 Notifications/newmail-Palim.8svx
---------- ----------- ------- ------- ------ ---------- ------------ -------------
 Total         7 files  511167 1131624  45.2%            Aug 17 23:33