Table of Contents
Trojitá allows you to read, write, organize, search for, and send email. If you've got an IMAP email account, Trojitá will allow you to access and use it. IMAP is a protocol that allows your mail to stay on the server, rather than downloading it to your local machine. However, Trojitá does in fact download parts of your messages – even all of your messages – for convenience. In the 1990s, most people used POP3 mailboxes, and their email software downloaded all their messages, removing them from the server. The disadvantage was that if you used any other computer, your messages were not available. IMAP solves that problem by keeping the mail on the server. The software you use on your local computer/cellphone simply issues instructions ("reply to this email," "display this email," etc.) for the server to execute.
First you need an IMAP account. There are many providers; FastMail is one; Tuffmail and Pobox are others. Google's Gmail service provides IMAP access to your Gmail account (Outlook and others do not). And if the manager of your Microsoft® Exchange server has configured it, you can access Exchange through IMAP as well. If you have got an IMAP account, a user name and password, that is all you should need to use Trojitá to access it.
Note that not all IMAP providers are equal and some offer service that is frustratingly slow. Microsoft®'s Exchange server too is reported to be somewhat slow. If you choose a good provider and use fast software, you'll be surprised how pleasant an experience it can be.
First, click on the General tab of the Settings box. Add your IMAP account as a new account, using these parameters:
Real Name: the name you want to show on your emails (your own first and last name)
Email: your email address
Organisation: your company name (optional)
Signature: any text you want to appear at the bottom of your emails, like your website name or a slogan
These settings become an identity, and you can have several, if you want, if for example, some of your mail is part of a mailing list where your messages should look different (a different signature line, for example). Note however that at present, Trojitá does not yet permit multiple IMAP accounts (that is, use with multiple servers).
Next, add the connection parameters necessary to access your account.
Method: choose SSL, if your provider requires it. Otherwise, choose "TCP" for a connection that starts unencrypted and may be upgraded to encryption while connecting. And if your provider requires you to perform that upgrade to encryption, check the "perform STARTTLS command" to ensure it does. "Local process" is for advanced users who, for example, are connecting to their provider over another SSH agent (in this case you'd put something like
ssh imap.provider.org dovecot --exec-mail imap). Generally, TCP or SSL are your two most likely choices.
IMAP Server: is your provider's server (e.g. mail.host.com)
Port: this parameter should change automatically depending on what you enter for "IMAP Server." Typically it is 143 for unencrypted connections and 993 for SSL connections.
Username: your username
Password: your password. At present, Trojitá stores your user name and password in a plain text file on your computer. This is not secure! If that worries you, leave the password field blank, and Trojitá will ask you once for your password, and keep it in memory until the application exits.
Start in Offline Mode:
Blacklisted Capabilities: Trojitá strives to be standards compliant. But some servers that advertise standards compliance are not actually so. If you're aware of some features that your provider advertises but does not actually provide, listing them here allows Trojitá to politely ignore them.
The Offline mode tab is where you configure Trojitá's ability to store local copies of messages on your server. The advantage of saving a copy locally is obvious: you can access it later without reconnecting. The disadvantages include filling up your local hard disk, and of course the security risk if anyone ever goes exploring on your computer. Trojitá's default is to store local copies indefinitely, but here you may choose if you prefer to store up to a certain number of days, or to not store at all. Note that the code to clean the message cache has not yet been implemented, so at present you should assume the message cache will not be pruned.
The SMTP tab is where you configure sending email.
Method: choose SMTP for unencrypted connections, or "secure SMTP" if you prefer (and your provider accepts) mail sent over SSL. If you choose "local sendmail-compatible" Trojitá will simply pass your mail to the sendmail app running on your local computer (and if you haven't got one, it will fail). Choosing this option requires you specify the sendmail parameters for using your local sendmail.
SMTP server: the name of the server to which your mail should be sent.
Port: This parameter should change automatically depending on what you choose for "Method." Typically, it's 587 for unencrypted mail, and 465 for mail sent over SSL.
Sendmail Executable: is only required if you've chosen "local sendmail-compatible" as your method. If so, here you should put whatever command is required for your message to be sent to your local sendmail app. The default is "sendmail -bm -oi" but if your local configuration is non-standard, you'll have to adjust this parameter appropriately.
StartTLS: check this box if your provider requires a TLS connection to send encrypted mail (this is not the same as using SSL by choosing "Secure SMTP" as your method above).
SMTP Auth: if you must input a user name and password in order to send mail, check this box. In the modern age, you almost always have to do so, as otherwise spammers send unwanted messages through the server.
Username: your user name.
Save outgoing mail: if you check this box, Trojitá will save a copy of every mail you send. This has been the default setting for all email programs for so long now that few people even know it's possible to not do so!
Sent folder name: If you do decide to keep a local copy of your sent mail, choose in which folder you'd like to keep it.
Send with BURL: The BURL extension is an extension to the IMAP standard, implemented in 2006, so not all servers make the service available. Imagine you have a huge email in your inbox with an attachment, and you'd like to forward that message. The normal way requires your IMAP client to download that huge message, and then resend it (causing two large network transfers). The BURL extension allows you to send that message without having to download it first. If your provider permits BURL, it's worth selecting this option.