Boutique Software

K-9 Mail Locale Plug-in help

Requirements

K-9 Mail Locale Plug-in requires both Locale and K-9 Mail for operation. It will work with Locale version 0.695 or later, and K-9 Mail 2.4 or later.

Both Locale and K-9 Mail are available on the Android Market. K-9 Mail is also available at the K-9 Mail project page.

Capabilities

K-9 Mail Locale Plug-in provides "settings" that can be used from within Locale. These settings control the behavior of K-9 Mail. There are controls for both account level and global settings in K-9 Mail.

Installation and use

The easiest way to install K-9 Mail Locale Plug-in is to purchase it from the Android Market. This is the only supported installation approach. In order to use the plug-in, both Locale and K-9 Mail must also be installed.

Once all three pieces of software are installed, K-9 Mail Locale Plug-in automatically becomes available in Locale in the "Settings" section of the Edit Situation screen. When adding a new "Setting" to a Situation, both a "K-9 Account Settings" and "K-9 Global Settings" selection will be available.

In each setting is a Do not change choice. When Do not change is chosen, then this setting is not affected when this situation is activated. Leave a setting as Do not change when the situation does not require changing that particular setting.

K-9 Account Settings

These are settings that are applied to either a single account or to all accounts in K-9 Mail. It is possible to add multiple K-9 Account Settings to a single Locale Condition by long-pressing the "Add Setting" button in Locale.

Account

First choose whether this setting will apply to a single account or to all accounts in K-9. If the All checkbox is unselected, then chose an individual account to affect. If the All checkbox is selected, no account may be chosen, because the configuration will be applied to all accounts in K-9

Notification enabled

Determines whether K-9 Mail will put up a notification in the notification bar when new unread mail is available.

Ring enabled

Determines whether K-9 Mail will sound the account's ringtone when a notification for new unread mail is put into the notification bar. Requires K-9 Mail to have notifications enabled for the selected account. Consider using this setting to reduce the chance of being woken up by K-9 Mail during sleep time.

Vibrate enabled

Determines whether K-9 Mail will activate the device's vibrator when a notification for new unread mail is put into the notification bar. Requires K-9 Mail to have notifications enabled for the selected account.

Folders to check with poll

Controls which folders, by class, are checked during polling operations. One use this setting is to manage power consumption, by reducing K-9 Mail's power use at certain times of day, or based on battery level. The more folders which are polled, the more power is consumed. It is possible to have a core set of folders as 1st class that will be polled when power is low, but have more folders as 2nd class which are additionally polled when power is sufficient. When power gets critically low, consider turning off all polling by setting the Folders to check with poll to None.

Folder poll check frequency

Controls the frequency with which folders are polled. A use of this setting is manage power consumption, by reducing the frequency with which K-9 Mail polls folders. It is possible to reduce polling frequency based on the time of day, knowing that email receipt is less critical at certain times, or by reducing the frequency when the battery is low, in order to conserve remaining power. When power gets critically low, consider turning off all polling by setting the Folder poll check frequency to Never.

Folders to check with push

Control which folders, by class, are continuously monitored using push mail technology. As push mail can impose additional power requirements, controlling which folders are checked with push can help to reduce battery consumption. It is possible to have a core set of folders as 1st Class that will be checked with push when power is low, but have more folders as 2nd Class which are additionally checked with push when power is sufficient. When power gets critically low, consider turning off all push mail operations by setting the Folders to check with push to None.

K-9 Global Settings

These are settings that are applied globally to K-9 Mail, and are not account specific.

Background sync

Controls all background operations in K-9 Mail. When set to Always K-9 Mail performs normal background operations, independent of the Android device-wide "Background data" setting. When set to Never, K-9 Mail disables all background operations. When set to When 'Background data' is checked, K-9 Mail will only perform background operations when the Android device-wide "Background data" setting is checked. Setting Background sync to Never minimizes K-9 Mail power usage by preventing all periodic polling and push mail operations.

Theme

Controls whether K-9 Mail will use a light or dark theme. Can be used to show a light theme during the day and dark theme at night, or to visually indicate the application of a set of settings to K-9 Mail.

Source code access

K-9 Mail Locale Plug-in is free software, the source code for which can be acquired from our source access page


Home Contact Us About Us