Pimlical Android Help


Menu Items - 

Note - if you upgrade to a new version of Pimlical/Android that has new menu commands not previously defined, you may need to go into Menu | Preferences | Commands/Functions | MenuCommandsAndOrder and select any new menu commands as by default, the existing user preferences are never changed when a new version of Pimlical/Android is installed. In most cases, new menu items will be added to the existing list when first launched. But if you update and skip some interim versions, some new items may not be displayed by default.

 GoTo

Displays the Date Picker so you can select a date that the current view will display. A gesture can also be used to quickly go to Today's Date (a vertical stroke in the left-side of the screen goes to today - stroke upwards to stay in the same view, stroke downwards to move to today in the Day View).

 Views

Displays View selection dialog so you can go directly to one of the main views.  You can also set the default Startup View in the drop-down list. Since there is no real concept of 'startup' in Android (once an application has been launched, it remains in memory, even if only in the background), this is applied whenever you explicitly leave Pimlical (either by hitting the Home button or using Menu | Exit Pimlical or by using a long press on the Back Button). Setting Current View/Date will preserve both the current view and date when Pimlical next appears. Selecting any specific view will invoke that view and also change the date to Today's date. The normal, default setting for this preference is the Day View, so that when you return to Pimlical, it will go today's date in the Day View.

Some Views have a + button - a long press will change the number of days/weeks/months that are displayed in that view. The List View is limited by the amount of available memory for the scrolling region - setting this value to much above 10 days on most Android devices may result in the number of displayed days being reduced to whatever fits in memory. In the special case of the Day+ view, a long-press will set the number of days for that view when the device is in the same orientation as it is when you long-press the button (i.e. if it's in landscape mode, then it's the number of days in landscape mode that gets changed).

You can also switch views quickly with a gesture. A horizontal stroke in top half of the screen cycles through the views - Day -> Day+ -> Week -> Month -> Month+ -> List - forwards or backwards, depending on the direction of the stroke. There is also a preference (View-Related Items | ViewsToCycleThrough) which determines which views are cycled through and the order in which those views appear.

Not all options in the List View are available on all Android devices. How many days can be displayed in the scrollable region is a function of available memory and how memory is managed on the device. The setting of 366 days is only usable if there are very few events in that year (either because it is a past/future year being looked at, or because a custom filter has been imported from Pimlical/desktop that only displays a subset of events, such as birthdays, etc.).

  Filters

Displays the Filter Selection Dialog. See the section on Using Filters for details on how filters are managed. Filters are used to determine which events are displayed in a view based upon extensive selection criteria. Filters can also be used as the target of a find function to locate items.

  Voice

Displays Google's Voice Input dialog which makes it easy to enter appointments by speaking them. You can start out by saying something like 5pm optionally followed by Tomorrow or This Tuesday or Next Thursday. Start with Now to set event time to current time, otherwise the default is to enter it as an untimed event on the current day. Start with Floating Event or Task (or /Todo) to set a floating event or todo/task item. Voice input can also be invoked with a long press on the Find button. Not all Android devices support Google Voice.

 Toggle Untimed

Provides a quick way of toggling the display of untimed events on and off. If you have the Day or Day+ views displayed and there are a large number of untimed events or floating events, the actual schedule for the day may be hidden below the screen. Although you can scroll up to see it, it may be easier to just temporarily hide untimed events to review actual timed events on those days.


By default, the following items appear in the menu when the MORE button is pressed in the first menu list. Note that the order of items in the menu and which menu items are displayed is controlled by a preference setting: Commands/Functions | MenuCommandsAndOrder. You can also display all menu items in one screen or choose how many menu rows are displayed with the preference: NumberOfMenuRows, and also choose whether the menu icons are displayed above the text or to the left of the text.

 Find

Displays the Find Dialog. This allows you to select items from the database based upon text string, icon, event type, status and an optional date range. To exclude items from the display, uncheck the corresponding box (i.e. to skip display of Floating events, uncheck the Float checkbox. Matching items are then displayed in a list. This list is just like the Event Selection List in that items can be selected for edit (long press) or have an operation performed on them (brief tap). The only way it differs is that for repeat items, any modification always applies to the entire series (since there is no concept of which day an exception might be applied to).

Leading and trailing spaces are always stripped off the find string (because on-screen intelligent keyboards frequently add a trailing space if you pick a word from the suggestion list).

The Filter button allows you to perform a search based upon the selected Filter. When using this function, any search parameters that you had entered into the dialog will be ignored, as it is the selected filter and that alone which controls the display of items.

Most Android devices have a Find button available on all screens, and this button invokes the Find function here.

 Preferences

Displays the Preferences Dialog. Preferences are divided into several sections - tap the button corresponding to the section that has those preference settings. You can then select individual preference items in the scrolling list. A long tap will display the full text of the comment describing the preference, and a brief tap will display a dialog that allows you to change the value of that preference. You can also use the Find button to find a preference by name (just type in enough of the preference name to uniquely locate it).

When returning to the preference dialog, Pimlical will display the section most recently accessed in red, and will also scroll the display when that section is selected to display the most recently accessed preference item. See the help section on Preferences for further information on individual preference sections.

 Select Calendars -    Select Categories

Select Calendars displays a list of all calendars that you have access to in the main calendar database and (if present) the local calendar. Select Categories displays a list of all categories in the Local Calendar (Categories are only supported in Pimlical's local calendar that is stored on the SD card (or virtual SD card if the device has no physical SD card).

Do a long press on the entry to toggle the display on or off for that calendar (Select Calendars) or category (Select Categories) (a green check mark indicates it will be displayed, a red Cross indicates it will be hidden.

The All and None buttons select all calendars (or categories for Select Categories) or unselect them all.

The Export button exports the currently selected calendar(s) as separate iCalendar files with an ICS extension. All exported calendars are placed in the folder: Pimlical/ExportedCalendars. These calendars can be imported back into Google calendar at a later time, or used to transfer information to other calendar systems that are not available by syncing.

The Import button imports an iCalendar type file (which must be located in the Pimlical/ExportedCalendars folder) into the currently selected local calendar (if there is no local calendar, the import function is not available - you can of course import iCalendar files into the google calendar associated with an Android calendar). If you have never exported any calendars, the ExportedCalendars folder may not exist in which case you will need to manually create it to put the import file into (or export any calendar which will create it).

A short tap on the calendar entry brings up the Edit Calendar dialog, where you can set the foreground and background color for the calendar (or local category), set a default icon to appear on all items in that category, or change the selection and (calendars only) sync settings. The Sync setting can only be changed for Android calendars - and due to a limitation in most (all?) Android calendars, you can not have an item display and not be synced (as if sync is turned off for a calendar, the Android calendar sync routine will remove items in that calendar from the database (of course they are still in google). The Sync button is not displayed for Select Categories. A short tap on the local calendar in Select Calendars has no effect (other than to display an informative message) as the attributes are set for individual categories within that local calendar.

In the Edit Calendar dialog, you can set the foreground and background (if GoogleCalendarColors preferences is set to false) colors for the category, set a default icon and also optionally set it for display and syncing (Note: with most Android devices, you must allow a device to sync in order for it to display). 

The Edit Calendar dialog has a Remove button which will remove that category, provided that it is empty. You can not remove a category that has items in it. You can set Pimlical to display all items in that category to find them. Remember that items might also be in a template or a filter.

The Edit Calendar dialog also has a Rename button which will rename that category. All other attributes remain the same.  

If the calendar was not previously selected and is an Android calendar, Pimlical will tell the Android OS to invoke a sync on that calendar (you may want to wait a minute or two and refresh the calendar again if it has not been visible recently). The Android sync routine (Google's software)  for the calendar database does not read older, non-recurring events. To force a sync of all events in the calendar, Use the Pimlical/Desktop to update all the modification dates (use Advanced Find to select all items in the calendar, click Find, then use Shift in Display Results dialog, but just click on OK button without changing anything, and then refresh that calendar with CTRL/H. Remember to make sure that the DaysBackToRead preference in Pimlical/Android is set to -1 to read all events in the calendar database.

If the preference UseGoogleCalendarColors is set to true, the foreground and background colors for a local category are always set to the same value as having different values is not compatible with the way that Google calendar colors are handled. If you set that preference to false, you can then change the color settings independently (see section on colors in Event Attributes in help for further information on setting default calendar/category colors).

 Select Local Calendar

Pimlical/Android allow for any number of local calendars, although only one of them can be open at any time. You can use this menu item to select OTHER local calendars in the PimlicalCalendars folder. Usually the easiest way to create other local calendars is to just duplicate an existing calendar in that folder using an Android File manager, or windows explorer (after phone is connected to a PC).

This menu option also allows you to create a backup copy of the selected local calendar (keep in mind that the currently displayed local calendar is backed up automatically by P/A), and also to restore a local calendar. If for any reason, you find that your local calendar is corrupt or missing a lot of items, etc. , you can always use the RESTORE button to restore an earlier version of the calendar.

 Refresh Calendars

Pimlical will re-read the entire calendar database and redisplay all items. The display can also be set to automatically re-read the database after a set period of time by adjusting the preference GoogleRefreshInterval - a value of 0 turns off the automatic re-read, while any other value specifies that after that number of seconds, the database should be re-read the very next time the display is touched or changed in any way - for example, a value of 600 would indicate that it should be re-read any time the display is refreshed and more than ten minutes has passed since it was last re-read.

 Add Daily Journal Entry

Opens up a text window so you can add a new item to the Daily Journal (in Pimlical/Android, the daily journal is called Android Journal to avoid clashing with P/D if syncing). The item is automatically date and time-stamped and will be added to the note field (Google's "description" field) of an untimed event in the current day's schedule with the name Android Journal. A template can be used to preset the attributes of the Daily Journal - it can, for example, be made a floating event so that there is just one journal that floats from day to day. To have Pimlical use the template, you just have to set up the description field to be Android Journal (in Pimlical/Desktop, you would use Daily Journal). Some users then mark the journal as complete on the last day of the month so that Pimlical will open up a new journal on the first day of the following month. That way, the last day of every month has a consolidated list of all the journal entries for that month.

 View Upcoming Alarms

Displays a list of all upcoming alarms in chronological order from the present time forwards. The list will include all alarms for the number of days defined in the Preference [Alarm Related Items]HideAlarmsMoreThanXDaysOut. This works just like the Event Selection List in that items can be selected for edit (long press) or have an operation performed on them (brief tap). The only way it differs is that for repeat items, any modification always applies to the entire series (since there is no concept of which day an exception might be applied to).

 Help & Usage Tips

This item displays a list of help topics (with the number of items in each topic displayed in parentheses). Select a particular topic and you will then see all the items listed under that topic. Requires Internet access as the help files are stored on the Pimlico Website and are constantly updated.

 About Pimlical...

Displays the About Dialog which includes the Pimlical version number, number of records (total and deleted), the screen size, and also includes buttons to go directly to the Pimlico Software Home Page and also display the Complete Revision History for the program. The latter is useful as whenever you install a new release, you can quickly review all the new features and corrections in that version. The Upgrade button checks to see if a more recent version of Pimlical/Android is available and prompts you to download and install it at that time.

 Find Items linking to Contact

Pimlical displays the full contact list at which point a single contact can be selected. Pimlical will then search the calendar database for all events or tasks which link to this contact and will display them in an Event Selection List. To find items linking to memos, use Menu | View/Edit Memos and long press the memo that you want to use as the target for linked events.

 GSync Now

Pimlical initiates an immediate sync of the Android calendar and contacts databases with Google by telling the Android Sync routine to proceed immediately (this is Google's Android sync software that performs the sync operation). Normally, the sync occurs at regular intervals as new items are added, deleted or modified, but the delay can be anywhere from 20 seconds to a minute or more before the sync actually occurs. This is mainly useful for testing, or when an item must be immediately uploaded to the calendar server (Google, exchange, etc.). Note that this has nothing to do with Pimlical's DirectSync operation (see DirectSync menu item below).

 Cancel GSync

Any sync of the Android databases to Google Calendars in progress will be canceled.

 Undelete

Displays a list of all deleted items that are still in the database in reverse chronological order of when they were deleted (so the most recently deleted item is at the top of the list). As with the Event Selection List, an item can be selected for edit (long press) at which point clicking on the Ok button will undelete the item. Undeleted items are always put in the Unfiled Category, since the original category may no longer exist.  A brief tap on this list is not supported unless the preference DebugMode is set (mainly because such commands will not undelete the item so it is not normally something that would ever be needed).

 Undo Edit

This command will undo the last edit operation in the current session (i.e. if you are going to use this command, you should use it reasonably soon after making the edit correction, as eventually it will be forgotten. All the changes made in the Edit dialog are reversed.

 Exit Pimlical

This menu command can be used on devices that do not support a long press on the back button. Since Android does not support the concept of exiting an application, what this menu command does is ensure that any current preference settings are written out (the calendar is always written in real time) and then moves Pimlical to the background and sets a flag so that on the next activation, the database is re-read - all of which gives the impression of exiting Pimlical, although it is in fact still running in the background.

 Archive Older Events

This menu command will purge old events in the local calendar database and move them into an archive calendar with the name PimlicalArchiveCalendar (Pimlical/PimlicalCalendars/PimlicalArchiveCalendar.dat). If the archive already exists, the newly purged items are added to the existing database. Both tasks and events are purged. When invoked, an informative message first appears. This is followed by the Date Picker so the purge date can be picked (Default is the first day of the same month in the prior year). 

All items prior to (but not including the archive date) are then purged.  This includes items whose end date is on a day prior to the archive date, or repeat items with an explicit repeat end date that ends on a day prior to the archive date.

The purged items are marked as deleted in the current database, so a subsequent DirectSync will also remove those items from the desktop local calendar as well. If this behavior is not wanted, you should make sure you set the preference: DoNotSyncEventsPriorToDate  (in 3.4.11 and later) to the same date you chose as the archive date in P/A as then those events will be ignored and can be left in the desktop database without affecting the local calendar in Pimlical/Android. You can always look at the archive database by going into menu | Select Local Calendar and selecting the archive database for display. You can restore items from the archive to the current local calendar with the set of four popup commands (Copy Selected Item, Copy All Items In List etc.).

  DirectSync

This menu command is used after you have launched DirectSync in Pimlical/Desktop with the local HTTP Option by pressing the button to initiate the sync. It confirms the sync and starts sending files over to Pimlical/Desktop where the sync actually takes place. If you need to cancel the sync, just hit the back button. The Wait dialog will be removed when DirectSync completes.

  AutoSync Now

This menu command is used to initiate an immediate AutoSync (normally AutoSync is invoked automatically by Pimlical based upon the preference AutoSyncFrequency).

  Recent Updates

This menu command is used to display a list of all events and tasks that have been modified or created recently. Only those items more recent than the cutoff date/time (as specified in the preference RecentUpdatesCutoff) will be included in the list. The list is sorted in reverse chronological order so the most recently modified/created item is at the top. This can be useful when a change has just been made and you don't remember what it was, or when a new item is updated or inserted into the database by AutoSync.

 Debug

The debug menu item is only displayed if the preference DebugMode is set to True. The Debug dialog is primarily used by Pimlico Software to diagnose issues within the calendar database and used under direction of Pimlico's Tech Support.

However, there are also some useful functions there as well. For example, if you are no longer going to be using Pimlical, you may want to use the function to automatically strip all of the tags in the note field from Android calendars, or to strip the date/time stamps from all your memos. There are also useful functions to check for and fix duplicate ID's. if you are unable to restore the contacts calendar because you can not invoke the contacts screen, you can recover by using a function in the debug menu to access the routine to restore the contacts database directly.