AmiGmail
========

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.

AmiGmail is a native Gmail client for AmigaOS 3.2+ using the ReAction GUI,
IMAP, SMTP and AmiSSL. It is designed specifically for Gmail and is not a
general-purpose IMAP client.

Messages remain on the Gmail server and are accessed directly through IMAP.
AmiGmail does not maintain a local offline mail database.

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

- Native AmigaOS 3.2+ ReAction interface
- Single Gmail account
- Inbox, Sent, All Mail, Trash, Spam and Drafts support
- Expandable Gmail label tree with remembered folder state
- Optional Inbox fetch at startup
- Optional automatic Inbox check every five minutes
- Compose and reply to messages
- Open, edit, save and send Gmail drafts
- Move and delete messages
- Mark messages as read or unread
- 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

Authentication
--------------

AmiGmail uses a Gmail App Password. The Google account must have two-step
verification enabled. The normal Google account password should not be used.

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
- Gmail account with two-step verification and an App Password

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 AmiGmail.
6. Enter the Gmail address and Gmail App Password in Account Settings.
7. Define a master password for the encrypted account data.

Gmail servers used by AmiGmail:

  IMAP: imap.gmail.com:993
  SMTP: smtp.gmail.com

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

https://github.com/Andiweli/AmiGmail

License
-------

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

AmiGmail is an independent hobby project and is not affiliated with,
developed by, supported by or sponsored by Google LLC. Gmail is a
trademark of Google LLC.

Copyright (C) Andreas 'Andiweli' Stuermer.

 PERMSSN    UID  GID    PACKED    SIZE  RATIO METHOD CRC     STAMP          NAME
---------- ----------- ------- ------- ------ ---------- ------------ -------------
[Amiga]                 192293  333896  57.6% -lh5- d940 Aug 17 17:35 AmiGmail
[Amiga]                   2152    2988  72.0% -lh5- 981c Aug 16 22:51 AmiGmail.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  498777 1105384  45.1%            Aug 17 23:33