Core functions

Supports several mail accounts (max. 2 in the free version).
Supports standard Internet mail protocolos: POP3, IMAP, SMTP; as well as Microsoft’s EWS protocol for Exchange (since 1.3.0).
Main window shows all folders selected for synchronization at a glance.
Messages are loaded one “page” at a time as needed, scroll to bottom to load more.
Supports GMail – like way of working with email, when old messages are never deleted from the server.
Mail check time is independent of the number of messages (my Gmail account has over 100,000).
Supports viewing plain text and rich text messages, including embedded images.
Supports rich text formatting when composing messages including the signature (as of 1.2.5.0: bold/italic/underline, font size, font color; as of 1.4.0, embedded images, typeface).
Fast attachment loading, memory card-based attachment cache.
Flexible mail check scheduling.
Sound, LED, vibration notifications for new mail and errors. Per account notification options.
Silent mode for nights and weekends.
Preloads new message text and attachments (up to specified limits) when checking mail. Full message text is loaded on demand, when a message is viewed.
Can load full message text and attachments if put into background (pressing the Home key).
Support for SSL and TLS encryption.
A home screen widget with unread / total message counts that can be set to an account or a specific folder, and a message list widget (with scrolling on Android 3.0). Both have several built-in themes.
Separate settings for WiFi vs. mobile network (including a separate outgoing mail server setting for WiFi, if needed, as of 1.2.5.0).
IMAP: IDLE (push email), instant incoming message notifications (if supported by the server).
IMAP and EWS: messages can be moved between folders.
Smart Folder for quickly browsing messages that might need attention.
Per-folder color indicators.
Message navigation without leaving the message view.

What are the options for deleting messages?

There are three methods to delete messages.

The choices are: “Move to Deleted folder first” / “Delete from the server immediately” / “Hide in the app, keep on the server”. The initial default setting is “Move to Deleted”.

When using IMAP, you can synchronize the [ Deleted ] folder with the server if you like. With EWS, this is always the case.

Deleting messages from Gmail requires that they first be moved into the Deleted folder, which in turn has to be set up to synchronize with “[Gmail]/Trash”. When setting up a Gmail account, AquaMail sets this up automatically.

For POP3, the Deleted folder is local, so don’t forget to empty it from time to time (this will delete messages from the server).

The default delete method is specified under “Options and folders” / “Account options” separately for each account (long press the account in the main screen to open). The setting is called “Deleting messages”.

Changing the default changes the icon you see when viewing a message or when selecting several messages in a message list.

You can apply a non-default delete method in a message list by using the menu (or the “three dots” button which Google calls “overflow”).

So for example, you can keep the default method as “Move to deleted”, and if you see spam messages you’d like to delete immediately, select them, then use the Menu / Overflow button and choose “Delete now”.

How can I delete messages in AquaMail without deleting them from the server?

Each account has a setting for the default way to delete messages. The initial setting is “move to deleted first, delete from server when purging the deleted folder”.

To change the default: long press the account in the main screen and choose “Options and Folders”, then “Account options”.

Tap “Deleting messages” and choose “Hide in the app, keep on the server”.

This will change the default action icon for deleting messages from this account to “hide”.

Hidden messages can be restored by using the menu in the message list view. They will be also automatically deleted from the app at a later point to reclaim storage space.

Note that it’s not really necessary to delete messages from the app — old messages are automatically deleted over time without affecting the server, keeping storage usage under control. The default is to keep 250 most recent messages per folder (and can be changed in each account’s Folders and Options as “messages to keep”, renamed as “messages to cache” in 1.4).

How do I access server side folders?

This is only possible with IMAP or EWS (POP3 does not support access to individual folders).

As of 1.2.3.0, you can access folders on an as needed basis:

This can be done from the title bar of any folder’s message list (last item in the dropdown is “Other folders…”), when moving messages, in the account list in two panel mode.

When accessing folders this way, recently accessed ones (up to three) will be shown in the folder list drop-down and the account list (if the per-account setting mentioned above is enabled). They are removed from the recent list automatically, after one week (can be changed in app settings) or, as of 1.2.5.0, you can long press a “recent” folder to clear it.

Please note that the “Other folders…” entry is shown by default on tablet sized devices only. On phone sized devices, please long press an account, choose “Options and Folders”, then “Account options”, scroll to the end and enable “Show Other folders…”.

The second way to access a folder is to set it to sync (every time the app checks mail in the account), which will make it always show in the account list (“main window”) for easiest access.

To do this, long press the account in the main window, choose “Options and folders”, then “Folders”. Tap a folder, choose how it should be synced (most likely just “As incoming” since “special” folders like Sent, etc. are usually set up automatically). Each incoming folder is presented in the UI separately.

Finally, if you delete any folders that are set to sync in the app (using web mail, or another mail app), please bring up Account Options / Folders in Aqua Mail to sync its folder list with the server.

How to change the order of accounts in the main window?

Account are initially sorted by name.

To move an account within the list, long press it, then choose “Change order” from the popup menu.

Enabling message zooming and auto-fit (Android 4.0 and above)

Message zooming can be enabled for all Android versions, while auto-fit (like in Gmail) requires Android 4.0 and above.

The “zoom controller” setting makes no difference for the auto-fit or being able to zoom with double-tap or multitouch gestures.

Senders' images and color chips (colored letters) in message lists


Please see app settings under “message list” and enable or disable “contact images” and “color chips” right below.

Color chips are new in 1.2.5.0, and in 1.3.0 they’re enabled by default on the more modern devices.

When viewing or composing email, the font is too small

While viewing or writing email, adjust the font size using the volume keys. The setting is remembered, so if done accidentally, you might need to readjust the font.

What is the Smart Folder?

The Smart Folder shows messages that are unread, or which, over a selectable time period:

1) were received by the application;
2) were sent (this is the date/time in the header);
3) were read, including read in other apps (for IMAP).

You can include or exclude starred messages in this list, please see app settings under Smart Folder.

In other words, this is the list of messages that might require attention, or that you might need to come back to. This folder is enabled by default, but can be disabled in the app’s settings.

Per-folder color labels are also enabled by default, but can be disabled in settings.

To assign a folder a different color, or to set whether it’s included in the the Smart Folder, please do this:

1) long-press the account in the main window
2) choose “Options and folders”, then “Folders”
3) scroll to whichever folder you wish to change
4) long-press the folder or tap the settings icon to the right of the folder’s name

Why is there star between the unread count and the total count for some folders?

A folder is marked with a star (e.g. “3 * 100″) when it contains new, just received, messages. Viewing the folder’s message list resets the star. This lets one keep track of which folders need attention.

How are folders marked with square brackets different from those that are not?

Folders marked with square brackets have special meaning to the application (Unsent / Sent / Deleted).
They may be individually marked for server synchronization, or may not be.
A special folder that syncs with a server folder has a color marker, top left; the server folder’s name is shown as the first item in the folder’s popup menu (long press a folder to show).

How do I enable IMAP Push ?

When setting up a new account, IMAP Push (if supported by the server) is enabled for the default incoming message folder, but is disabled for the account, giving you more control.
To enable IMAP Push, all you need to do is turn on “Enable IMAP Push” for the account. To open: long press the account in the main window (account list) and choose “Options and Folders”, then “Account options”.
To enable or disable IMAP Push for a specific folder, bring up “Options and folders” again, then “Folders”, scroll down to a particular folder, and tap the settings icon to the right of the folder’s name.
In addition, there are application-level settings to enable or disable IMAP Push, and/or restrict it to WiFi (e.g. use IMAP Push over WiFi when at home or at work, but don’t waste mobile traffic and battery juice while en route).

Status bar icon in IMAP Push mode

This is required by Android for apps that need to stay in the background for extended periods of time, to avoid being “killed” by the system. You definitely would not want that for push email.

AquaMail tries to do things “by the book” and therefore follows this.

There is way to remove the icon in the app’s settings (the setting is under “Look and Feel”). When the icon is disabled, the app will use its own tricks to stay in memory and avoid getting killed.

Can I make the app start in the Smart Inbox or some other folder?

Yes it’s possible starting with 1.2.

Please see the app’s settings, then look under “Look and Feel”, the setting is called “Start the app in…”.

Notifications about all unread vs. just new messages

As of version 1.4, there is a setting under “Message notifications” for whether Aqua will notify about all unread messages (including old ones), or only about “truly new” unread messages.

The default is “all unread”, consistent with versions prior to 1.4 (and some people to prefer this logic for notifications, myself included).

When using the “new unread” option, swiping a notification from the status bar will make the app not notify you about same messages messages. You can think of it as “Dismiss, ignore”. This is how it works in the Android Gmail app.

What UI options are there?

There are UI settings for:
- the overall color scheme (light / dark with light messages / dark with dark messages)
- message list format (0/1/2 lines of preview, subject or sender first, date grouping headers)
- message display format (multitouch zoom or not)
- showing the last sync time for each account in the main window
The font can be adjusted using the volume keys when in message list, message display, or message compose windows.

How can I see the full list of message recipients?

When viewing a message, tapping on the header switches between brief and full header modes.
The full mode shows all message recipients, while the brief mode is optimized to be just two lines tall.

Is there a spell checker?

On Android 4, the app can use the spell checker built into the system. You can enable it in the device’s system settings, under Languages and Input. Once this is done, spell checking will be automatically enabled in the compose area.

If the setting is not there – the feature must have been removed by your Android device manufacturer from their flavor of Android system software. I can’t find it on my Samsung phones (but it’s there, as expected, on a Sony and an HTC).

On all Android versions, the app can work with Spell Checker by FlipDog Solutions, LLC – which is free on Google Play. Once this app is installed, the compose window in mine will have an item in its menu to call the spell checker as an external app.

How to quickly navigate to next / previous message without going back to the message list?

Move the message header to the side to navigate to next / previous message.
Message navigation commands are also included in the menu, and, or large screens and in landscape orientation, as buttons near the lower edge of the screen.
There is a setting for whether “next” means “older” or “newer”.

Printing messages

Use Menu -> Copy/Send/Share/Print -> Send/Share/Print message text when you have a message open. Then choose your printing app from the app selection window (i.e. where to “send” message text).

A variety of printing apps is supported, but I especially recommend Cloud Print by Paolo Fernandes, which can print formatted messages, including images.

Version 1.4 has support for Google Cloud Print, which is built into Android since version 4.4. The relevant menu item in the same place, under Copy/Send/Share/Print.

How can I specify a signature?

1) long-press the account in the main window
2) choose “Options and folders”, then “Composing and Sending”.
3) The signature setting is on the next screen.

What are those pink / blue / green triangles next to folder names?

Each folder that’s set to sync with the server (and therefore shows in the account list and other places) is automatically assigned a color.

You can disable folder colors in the app’s settings. It’s also possible to change the automatically picked color by doing this:

1) long-press the account in the main window
2) choose “Options and folders” then “Folders”
3) scroll to whichever folder you wish to change
4) long-press the folder or tap the settings icon to the right of the folder’s name
5) you’ll see a dialog with per-folder settings, the color is one of those

How do I add an account?

For the first account, i.e. when there are no accounts yet, the “add” button is smack in the middle of the (empty) account list area.

For the second (and more) account, please use Menu / Add account.

Now, what is the Menu? The Menu is either a “real” hardware button (on more “traditional” phones), or a sensor button below the screen (often seen on the more modern ones), or the on-screen “three dots” icon (Google calls it “the overflow affordance”), right in the app’s interface, on the very right of the icon bar (which starts off with “refresh”, “compose”, etc.).

How can I rename an account?

In the main window, long-press an account, then choose “Rename account”.

Can I exclude a particular account from scheduled mail checks, without having to delete it?

Long press the account name in the main window – choose “Options and folders” – then “Account options” – clear “Background sync” and/or “Enable IMAP Push”.

How can I delete an account?

Long press the account name in the main window – choose “Delete the account”

Changing an account's password in the app

Long press the account (in the account list), choose “Account setup”, enter the new password, press Next.

When composing a new message, not all accounts are available in the account list

Most likely, some accounts don’t have an outgoing mail server configured.
Long press the account name in the main window – choose “Account setup”, then “Manual”, “Next”, and make sure there is an outgoing server configured.

Requesting a 'read receipt'

The app supports requesting a “read receipt” when composing messages. This is in the menu.

Note that not all apps support read receipts on the receiving side. My app does not (yet), and neither do Gmail (Android or web), iPhone Mail (as reported by a user), built-in Android Email (the stock one from Google, manufacturer-enhanced versions may differ).

Moving messages into spam folder

The app supports an easy way of moving spam into the server’s spam folder (for IMAP accounts only, as POP3 does not provide server folder access).

1 – Long press the account, choose “Options and Folders” then “Folders”
2 – Scroll down to the server’s Spam folder (for Gmail, that’s “[Gmail]/Spam”).
3 – Tap the spam folder, choose “Sync as spam” or “Spam, do not sync”.

Now the menus in message list mode (when one or more messages are selected) and message viewing mode will have an item to move message(s) to spam.

Using the app with mail hosted at GoDaddy

Please use these settings in Manual account setup mode:

Incoming server: type IMAP, server name imap.secureserver.net, security SSL (strict), port 993 (will be filled in automatically)
Outgoing server: smtpout.secureserver.net, SSL, port 465

Note that it’s “smtpout” not “smtp”.

GoDaddy’s IMAP server claims to support IDLE (push email), but in practice, it’s unreliable. This is a server side issue, and affects other apps. According to a GoDaddy support engineer, IMAP IDLE it not supported, and he has no explanation why their servers list that capability.

https://groups.google.com/forum/?fromgroups=#!topic/k-9-mail/srdtV5MzRWQ

http://support.godaddy.com/groups/email/forum/topic/imap-email-not-being-pushed-to-phones/

More tips from a user:

A. Server config.
Instead of generic secureserver.net:
1. Login in godaddy account
2. Click “launch” in email section
3. Clik on the link “Server Settings” and use the servers from there.

B. Issue with SMTP relays.
If you’ve got the error that the send quota was exceeded, using the same steps, re-assign the number of relays for your account:
1. Login in godaddy account
2. Click “launch” in email section
3. For the account you are using, click on the corresponding drop down, click on edit and set again the number of relays. Be aware, the setting might take up 24 h.

Using two-step verification with Gmail

If you’ve configured two-step verification for your @gmail.com account, please generate an application-specific password for use in AquaMail, as described here:

http://support.google.com/accounts/bin/answer.py?hl=en&answer=185833

Using hosted Gmail (Google Apps) accounts

Please use Manual account setup mode with these settings:

- Incoming server: type IMAP, name imap.gmail.com, security SSL (strict), port 993
- Outgoing server: smtp.gmail.com, security SSL (strict), port 465

… with the actual (hosted) email as the login for both servers.

What security / privacy features are there?

To prevent someone from reading your mail, the app has a PIN code lock feature. This can be configured in the app’s settings (under Security). The timeout is configurable.

Also, starting with 1.2.0.4, there is a privacy setting for notifications which suppresses the display of sender/subject/preview.

What does the Time reference point setting do?

This is the time reference point for scheduled background mail checks.
Every 15 minutes counted from 0:0 would be 0:15, 0:30, 0:45 and so on.
Every 15 minutes counted fromт 0:10 would be 0:10, 0:25, 0:40, and so on.

What does the 'System settings' setting do?

AquaMail can either observe, or ignore settings under “Account and sync” in your device’s system settings.
This lets you disable automatic network sync for e.g. weather or news and keep AquaMail checking mail according to its set schedule.

How can I disable scheduled mail checking in the background?

Please see the app’s settings, under “Receiving mail”: “Scheduled mail checking” and/or “Enable IMAP Push”.

How can I change account type between IMAP and POP3?

An account’s type (POP3 / IMAP) cannot be changed once the account’s been set up.

Is there a way to save sent messages on the server?

Yes, the app can upload sent messages to an IMAP folder. There is also a setting for “BCC to self”.

For most IMAP servers, this should be configured automatically. If it was, you should see a color “label” on the left side of the account’s “[ Sent ]” folder in the account list.

To configure manually:
1) long-press the account in the main window
2) choose “Options and folders” then “Folders”, tap the server’s sent folder, choose “Sync with [ Sent ]“.

Note that some servers (e.g. Gmail) automatically save all outgoing email without the application needing to upload them. The app will be pulling down, rather than uploading, your sent messages.

Why are messages loaded using POP3 not marked as read on the server?

POP3 has no support for marking messages as read or unread. Some mail services mark messages as read once they’ve been downloaded by a mail application, some do not.

Unread message counter on the app's icon

Android provides no way to do this that’s 1) standard 2) accessible to third party apps.

Version 1.4.0 can do this on recent Sony, Samsung, LG devices, in the manufacturer’s standard launcher, by using unofficial, undocumented functions intended for apps built into the system.

This is disabled by default, please see app settings under “message notifications”.

There are two more options:

- Using AquaMail’s “message counter” widget.

The widget has four visual themes and can be configured to “point to” a specific account or a folder. You can find it in the same place as all other widgets (this differs between Android 2.* and 3-4.*, there are plenty of tutorials on the Internet if you need one).

- Switching to a third party launcher that has this capability.

Aqua supports: Apex Launcher Pro (you will need to enable “External notifiers” in its settings, under Advanced), Nova Launcher Prime (you’ll need to install Tesla Unread, no other configuration is necessary), Smart Launcher 2 (you’ll need to install Smart Launcher Notifications).

How can I specify my own mail check interval?

In the app’s settings, look under “Receiving mail”.
Scroll down a bit and specify your own “Custom check interval”.

Can I send any attachment type or just pictures?

The application can send any type of file attachment. In order to attach something other than an Gallery image, please install a file manager.

Cropping images while attaching

Please install QuickPic (free in Google Play).

Once you do, the menu in the compose screen will have a new item to “Attach cropped image”.

How does the application load attachments?

Attachments are downloaded into the specified folder (by default, /download) as needed. This folder is under your full control, you can remove unneeded files at any time.
When using POP3, attachments are also saved into a hidden folder on the memory card during scheduled mail checking, this is called caching. A cached attachment will be moved into the “/download” folder without having to download it from the server.
When using IMAP, attachments are loaded as needed. There is a setting under account options to preload and cache attachments up to a specified limit (set per message).

Cannot save attachments on the external sdcard

In Android 4.4, Google made a deliberate change that prevents third party applications from saving data on the “real” (external) memory card, on devices that also have a large built-in storage (like a memory card, but built in).

Android Police has a good write-up.

The change affects all third party applications, and there is no way around it — it’s a system policy, and, to reiterate, a deliberate change.

Why does Aqua resize images inserted into formatted text?

Yes, embedded images are resized.

First, they’re not meant to be used for photos and such. That’s what attachments are for.

Second, I ran into an issue in the Android text editor (which my rich text editor is built upon): it doesn’t render any embedded images wider than the screen.

How can I limit the amount of used traffic when there are large incoming messages?

There are settings for how much new message text is loaded when the application performs scheduled background mail checking.
You can also limit automatic message loading that’s triggered when viewing an previously incompletely loaded message.
There are separate settings for WiFi vs. cellular data connection.

Messages out of order, or wrong message dates

If the app is not downloading most recent messages from an IMAP account:

This can happen if you uploaded a lot of messages using a desktop mail app, maybe when migrating to a new mail provider, or moved a lot of messages to a new folder. Can also be caused by a server bug, since IMAP guarantees ordering by date for incoming mail.

Version 1.4 has a new per-account setting that lets you specify how many messages to sync by a date range, rather than by the number of messages. This works even in the above scenarios.

To use this setting: long press the account -> options and folders -> account options, and change the “Messages to sync” setting (formerly called “Messages per page”).

For migrated accounts, if you’ve uploaded your messages, some IMAP mail servers will then report the date/time when you did this as the date/time stamp for all messages.

If you’re seeing this, please delete the account in Aqua, add it back, and before it syncs any messages, open the account’s options and folders -> IMAP options, and change “which message date/time to download” to “Date/time sent (from message header)”.

The number of messages in a folder is suddenly zero, but there are messages in it

For a POP3 account, you might have checked email in a program that’s set to remove downloaded messages from the server. AquaMail displays the number of messages on the server, so seeing a zero is normal in this case.

How can there be 10 / 1 messages - 10 unread, 1 total?

For POP3, AquaMail takes the total message count from the server, and has its own, local unread count.
So, let’s say during a mail check there are 10 new messages, which will be marked as unread since they’re just being downloaded for the first time.
Now by the time of the next mail check, all messages but one are deleted from the server using some other program.
This would give you 10 unread messages in AquaMail, and 1 total, taken from the server.

What is the largest message I can send?

Most mail servers limit message size to about 30-40 megabytes. Considering that attachments are base64 encoded, this means about 25-30 megabytes per message.

What does the 'WiFi in sleep mode' setting do?

A phone or a tablet is can be set to disable WiFi when the screen is off to save battery.
When this setting is on, AquaMail will enable WiFi and try to connect to a WiFi network when waking up for scheduled background mail checks.

How can I make a backup of my mail accounts?

Use Menu in the main window, then choose “Backup and Restore”. You can back up all account settings, and optionally include the program’s settings. The backup file is encrypted.
Messages are not archived or restored, as in 2012, they should be kept on the server.

Entering and picking emails (contacts)

AquaMail integrates with the device’s Contacts/People application (which is in turn synced with your device’s @gmail.com account(s) and other accounts you may have configured, such as Google+).

The app will display a drop-down list of matching contacts as you enter them in any of the recipient entry fields (after two characters), matching on names and emails.

You can also press the contact picking button to the left of each recipient entry field to bring up the app’s own contact picker. The built-in contact picker filters contacts by email, has search, and a group tab where you can pick a whole group or individual group members. It also has a “recents” tab which shows email addresses from recent messages, regardless of them existing in the device’s Contacts/People app.

It’ also possible to use the system contact picker using the respective entry in the Menu when composing a message (or making it permanent in the app’s settings under Contacts). On Android 3.2 and above, this is filtered to only include contacts with email addresses (on most devices: this seems to be an undocumented Android feature).

Saving mail recipients (contacts)

You can save manually entered names/emails when composing a message by long pressing the contact picking button to the left of the respective entry field. You’ll be prompted for which one to save if there are several.

Also, AquaMail can automatically save all your outgoing mail recipients in the device’s Contact list. This is disabled by default, you can enable it in the app’s settings under Contacts.

When enabled, AquaMail will add all outgoing mail recipients to a separate group, “AquaMail”, which will be created in your device’s primary Google account. This group’s contacts will not be listed with all the others (this can be changed later in the Contacts/People app).

Sending messages to a group

I’m not aware of a way to ask Android to pick a group of contacts. There are three workarounds:

1 – Since 1.2.5.0: tap a contact picking button to the left of the respective address entry field. In the app’s built-in contact picker that comes up, swipe to the Groups tab, and either select one and all its contacts, or expand and select some of them.

Version 1.2.2.10-1.2.4.0 had a separate menu item to insert a group. In 1.2.5.0, this functions was merged into the new built-in contact picker.

2 – Create a dummy contact with a list of email addresses, separated by commas. The app will expand the list and add each email as a separate item. As far as I know, K-9 works the same way.

3 – Open the device’s Contacts/People app, open a group, use the menu / buttons / etc. to “Send email”, then choose Aqua Mail from the offered list of apps. Works on stock Android, some manufacturers remove this function.

Where does AquaMail store its messages?

Messages are stored in a database in the device’s internal memory. Cached attachments are stored on the memory card.

Is it possible to access stored messages after a device reset?

As long as the internal memory is cleared, no.

How long are old messages stored on the device? How can I delete them?

Usually, old messages are deleted automatically, each folder keeping the most recent 250 messages.
You can specify a different setting in a particular account’s “Options and folders”, either for the entire account, or for a specific folder (use the settings icon on the right side of a folder’s name).
You can also compact the message store deleting old messages by using the menu in the main window.

Can I move AquaMail to the memory card?

No, for a variety of reasons: performance, reliability, security, Android documentation.
Some non-official firmwares will let you move AquaMail to the memory card even through it’s disallowed by the application. This may or may not work, and is not a supported configuration, but you are welcome to try, if so inclined.

How do I exit AquaMail?

By pressing Back or Home. There is no concept of Exiting an application in Android.

There are settings (under “Look and feel”) to exit the app when Back is pressed in the message list… a setting for the popular “long press Back to exit” is there too.

New account setup - manual or automatic?

There are two ways to set up a new account: manual and automatic.
Pressing Next after entering your email and password will cause AquaMail to either apply presets for a certain number of popular email services, or to try to guess incoming and outgoing server names based on your email address. This works most of the time, but there may be exceptions requiring manual setup.
Pressing Manual in the account setup window lets you enter all server settings by hand, and the application will use them exactly as entered.

Using the app with Shaw.ca

The app has an automatic account setup preset for @shaw.ca.

If you experience login errors — please log into your @shaw.ca web mail, go to “Preferences” then “General”, then select “Login” using “Standard (AJAX)” instead of “Basic (HTML)”.

Yahoo and 'login error OCF12', error code 999, error code 1213

Error message: NO Please verify your account by going to (yahoo login page) (#MBR1213).

Please open the link in this message and follow Yahoo’s instructions (to make them happy again).

Error message: “[UNAVAILABLE] LOGIN failure. Server error–please try again after some time. Error code OCF12″ or similar with “error code 999″.

This is an issue with Yahoo’s servers, maybe a specific one (or several) since they are load balanced (there are tons and tons of servers referred to by the same name).

The error message is returned by the server, it just isn’t letting the app log into the account.

It only affects some accounts from time to time, and seems to correct itself.

Searching the web brings up the same issue with K-9 Mail and other mail apps (Outlook on the Mac, to pick a really different example):

https://groups.google.com/forum/?fromgroups=#!topic/k-9-mail/5rYV6LbBWeY

https://groups.google.com/forum/?fromgroups=#!topic/k-9-mail/NCd8USGwvqM

http://answers.yahoo.com/question/index?qid=20120628042141AAGnejE

Yahoo does not seem interested in (or capable of) fixing this, or providing any info on what the error code means.

Second issue that can occur with Yahoo is an “authentication error 999″. Again, different mail apps on different platforms are affected.

A workaround I discovered is going to Yahoo Mail website, logging out, restarting the web browser, then opening Yahoo Mail web site and logging back in. This fixed the issue when both my app and stock Android Email on my Galaxy Nexus were affected.

Another thing to try is to long press the account in Aqua Mail, choose “Account setup”, then press Manual, and change “android.imap.mail.yahoo.com” to just “imap.mail.yahoo.com” (removing the “android.” part). Stock Android email uses “android.imap.mail.yahoo.com”, while K-9 uses “imap.mail.yahoo.com”; I’m not sure about the difference, but this should get you a different server on Yahoo’s side.

Finally, status bar error notifications in AquaMail can be turned off, then it’ll be just like K-9 (which silently ignores these errors, not checking mail when they happen of course).

Folders in Hotmail / Outlook.com accounts

Outlook.com has IMAP (with folders and cross-device read state sync), but the app’s preset is POP3 (no folders and no cross-device read state sync) because of some server side issues. Myself and others have reported it to MS multiple times, but the fixes are slow to come.

You can use IMAP if you do Manual account setup, the settings are below.

http://blogs.office.com/b/microsoft-outlook/archive/2013/09/12/outlook-com-now-with-imap.aspx

Incoming IMAP
Server: imap-mail.outlook.com
Server port: 993
Encryption: SSL

Outgoing SMTP
Server: smtp-mail.outlook.com
Server port: 587
Encryption: TLS

What if I run into a crash or an issue?

Crashes are automatically recorded in a crash log, called log-AquaMail-crash.txt and located at the root of your device’s memory card. Please send it as an attachment to aquamail.help / at sign / gmail / dot-com.

Providing information when something doesn’t work right:
In the application’s settings, enable “Debug logging” (very bottom). Set “Log output location” to “Root of memory card”. You will need to enable “Include raw data” most of the time, if the issue is related to specific message(s) or account(s).
Once logging is enabled, please repeat whatever was causing the issue.
After having done this, you can disable logging and send the log file, stored at the root of your device’s memory card and called log-AquaMail.txt, to aquamail.help / at sign / gmail / dot com.
The log does not contain your email account passwords.

How can I specify an account as default for sending?

Starting with version 1.1.0.7, there is an app setting (under Composing and sending) to specify the default account/alias for new messages.

Other than that, AquaMail remembers the account most recently used for composing mail until the next time. You can always change the account for the current message using a popup/dropdown list.

Replying and forwarding offers to use the same account where the replied / forwarded message was received (can be changed with the drop-down, too).

Is there support for multitouch zoom when viewing messages?

Sure, please see the app’s settings, enable “Browzer-like zoom” under “Message display”.

How do I download an attachment without opening it?

Long press on an attachment.

Linked pictures (images) in incoming messages

With the default settings, the app will not show linked pictures (images) right away, because linked images are often used by spammers to track you.

There is a panel/button just between the message header and its text content. Tap it once to show images, tap again to save the sender’s address as “known” (safe) for future use. The panel/button has help prompts.

You can turn the whole feature off by pressing the settings icon on the right side of the panel, and disabling “Show only from known”.

There is a second level check for this, too – linked images are turned off for mobile data (and enabled for WiFi). You can change this on the same settings screen as in previous point.

Blank entries for Skype contacts

If you have Skype for Android installed, you may see ghosted entries when autocompleting addresses in the compose window, which are same as your Skype contacts and yet have no emails when you pick them.

This is an issue with how Skype syncs its contacts to Android devices:

http://community.skype.com/t5/Android/Contacts-provider-bug-empty-e-mail-field/td-p/432935

http://community.skype.com/t5/Android/Some-annoying-side-effects-of-syncing-phone-contacts-with-Skype/td-p/143978

It’s been reported for about two years now, and not fixed yet, so it may never be fixed.

A confirmed workaround is to go into Skype settings on Android and to turn off its contact sync setting.

Can't confirm deleting a message from the notification bar

On Android 4.1 and higher, a single message notification has a button to delete the message. When you tap it, the notification changes, asking for a confirmation “using the button below”. Sometimes that “button below” is not visible.

The app requests the confirmation button, but the final decision is out of my control (in the system).

When / if this happens, you can make the “two finger zoom out gesture” on the collapsed confirmation notification, horizontally, to expand it and reveal the confirm / cancel buttons.

May not be easy to do, but that’s how the folks at Google designed it…

http://developer.android.com/design/patterns/notifications.html

The app's notifications are not showing

On Android 4.1 and above, please check the device’s system settings -> apps management -> AquaMail -> details -> make sure that “notifications” is checked (enabled).

This is a system level setting that my app doesn’t control. When off, it suppresses notifications for the respective app.

Apparently this setting has a mind of its own, and can magically become enabled (by the system). It also disables in-app toast messages, this was reported to Google just recently, in July of 2012 (</irony>).

Gmail and 'too many simultaneous connections'

This is a server-side limitation (counting all devices / mail apps, excluding the native GMail Android app).

Each folder in push mode requires its own connection. In addition, every time the device loses connectivity (which does happen with mobile devices), it takes the server a few minutes to notice and cross out the now dead connections.

To resolve – consider reducing the number of folders in push mode (e.g. Drafts, Deleted, etc.)

Since IMAP push is fairly expensive battery-wise, this will improve battery life as well.

If you’re only using 1-3 folders already, then the error might be caused by the phone’s unstable network connectivity.

Some manufacturers have an “energy saving” mode that disconnects the network when the screen switches off, that sort of thing. This will disconnect all current push connections as well.