Master Preference List
Pimlical/Android features a large number (needless to say, an often overwhelmingly large number for the new user!) of preference settings that control the display of items or the way in which the program operates. It is not necessary to know all these preferences as default values are picked that suit the needs of most users. But for power users, it's likely worthwhile to scan through all the preference settings quickly to get some measure of what items can be changed in the program. Note that the Find button can be used to quickly locate a preference by name.
As the program is updated, the Default values for SOME preference settings may change from what is listed below. If you long press a preference in the preference list, it will always show you the DEFAULT setting for that preference for the specific version of Pimlical/Android you have installed on your phone.
View Related
Preference Name | Type | Default | Description |
StartupFilter | string | default | Specify which filter is used when the program starts up (by name) |
ListViewSkipEmptyHeaders | boolean | false | If true, days that have no items will not display a header date |
ShowAllTimeSlots | boolean | false | set to true to display all timeslots for the day. If false, only time slots from the day start time to the day end time are displayed (although they will be extended to include the first and last event on the day if necessary). |
TimesFromFirstToLastOnly | boolean | false | If true, only time slots from the first appointment on the day to the last appointment on the day are displayed. |
ShowTimesInMonthView | boolean | true | If True, the time of appointments is displayed in the month and Multi-Month views. |
ShowEndTimesInMonthView | boolean | false | Set to true to display end times in the month and Month+ views. |
SlotInterval | int 5-480 | 60 | Set how long each time slot is in the Day and Multi-Day views - in minutes |
UseShortDescriptions | boolean | true | If true, Pimlical will substitute the text in the Short Description field for the regular description when displaying this item in the Month and Multi-Month views. Use this to provide more informative descriptions when the space for text is very tight. |
IncludeNote | boolean | true | If there is room, include the text of the note in the day and multi-day views |
IncludeLocation | boolean | true | If there is room, include the location field for this item as well as the description (and possibly note). |
IncludeCategory | boolean | false | If there is room, include the category for this item as well as the description (and possibly note/location). |
IncludeContactLink | boolean | true | If there is room and a link present, include the name of the contact link in the day and multi-day views |
shadedDates | shadeddates | 1 7 | Select days that will be shaded. RGB (Red-Green-Blue) specification is now defined by preference: ShadedDatesColor. This preference has either explicit days of the week (a single digit from 1-7, 1=Sun, 2=Mon...) and/or a range of days in a given month which consists of MMDD-MMDD, and/or a single MMDD setting to pick a single day of a month (in each year), and/or an explicit date in YYYYMMDD format, and/or an explicit date range in the form YYYYMMDD-YYYYMMDD. As an example: 1 7 0405-0420 0727 20150620-20150625 |
ShowInstanceDates | boolean | true | If True, use instance date rather than start date for repeat events when displaying items in the Event Selection list |
ShowAllRepeatsOnTasks | boolean | false | If True, all future repeats of Tasks are displayed (normally only the next occurrence is displayed for tasks). |
ShowDaysFromDueDate | boolean | true | If True, tasks and floats will show the number of days to the Due date when the item is displayed. |
InsertDaysFromDueDate | boolean | false | If True, tasks and floats will have the number of days to the Due Date INSERTED into the start of the description field (this is useful if you want to see that information in Google calendar, etc.). |
HideRepeatIcon | boolean | false | Set true to hide this system icon from display (default is to display this icon) |
HideAlarmIcon | boolean | false | Set true to hide this system icon from display (default is to display this icon) |
HideNoteIcon | boolean | false | Set true to hide this system icon from display (default is to display this icon) |
HideLocationIcon | boolean | false | Set true to hide this system icon from display (default is to display this icon) |
HideMeetingIcon | boolean | false | Set true to hide this system icon from display (default is to display this icon) |
HideLinkIcon | boolean | false | Set true to hide this system icon from display (default is to display this icon) |
HideFloatIcon | boolean | false | Set true to hide this system icon from display (default is to display this icon) |
HideStatusIcon | boolean | false | Set true to hide this system icon from display (default is to display this icon) |
HideGroupIcon | boolean | false | Set true to hide this system icon from display (default is to display this icon) |
HideWeblinkIcon | boolean | false | Set true to hide this system icon from display (default is to display this icon) |
HideTypeIcon | boolean | false | Set true to hide this system icon from display (default is to display this icon) |
HideLockIcon | boolean | false | Set true to hide this system icon from display (default is to display this icon) |
HideTemplateIcon | boolean | false | Set true to hide this system icon from display (default is to display this icon) |
StrikethroughCompletedItems | boolean | true | Set to false to avoid striking through completed items |
ForceTasksToBeUntimed | boolean | false | Set to true to make all tasks display as untimed and sort to top of list. |
AlwaysShowTaskAdvances | boolean | true | If true, all task advances are displayed. If false, they are only displayed in Today's schedule (when today comes in range of the advance). |
UseShortTimeFormat | boolean | true | Set to false to always displays hours and minutes in the Month and Month+ Views |
ListViewHeaderPosition | int | -1 | Position of List View Date header. -1 means center, otherwise positive value indents that number of pixels (0 = flush left). |
HideUndefinedIcons | boolean | false | Set true to hide undefined icons (which will display a question mark otherwise) |
MaximumUserIconsToDisplay | int 0-10 | 4 | limits the number of icons displayed that are attached to an event to this number. 0 will hide all user icons. |
OmitTimesInDayView | boolean | false | Set to true to omit start times in the Day, Day+ and Weekly Views. |
OmitEndTimesInDayView | boolean | false | Set to true to omit end times in the Day View. |
OmitEndTimesInWeekView | boolean | false | Set to True to omit end times in the Weekly View |
LockWeeklyViewToWeekStart | boolean | true | Set to false to allow the start date in the weekly view to move by one day with [<], [>], Today and Tomorrow buttons |
ShowIconsOnlyInMonthlyViews | boolean | false | Set to true to hide all description text in the month view and only display icons (usually would only be used in very tight displays to just show icons instead). |
StripEOLsForDisplay | boolean | true | Set to false to preserve End Of Lines in description and note text when displaying in main views (if true - they are stripped out ). |
IncludeDuration | boolean | false | Set to true to include the duration of events in the Day/Day+ and List Views. |
;ShowTasksInSeparateView | boolean | false | Set to true to only display tasks in separate Tasks View (Future use) |
DisplayNativeTimes | boolean | true | set to false to avoid the display of the native time of an event in brackets after the display of the adjusted times (i.e. when handling timezone shifts). |
HideItemsInDifferentMonth | boolean | false | Set to true to hide items outside of the main month in the Month View. |
LightenGoogleColor | int | -1 | Amount to lighten the Google Calendar Colors by for use as a background color (0 = no lightening, 100+ is probably too much, -1 is auto-adjust and makes Pastel colors darker, -2 to -100 makes color darker) |
UseBlackOnColorBackground | boolean | false | Set to true to use Black text on the colored background (assumes that the background colors are very light and the normal White text gets washed out) |
IconsOnWhiteBackground | boolean | false | Set to True to have icons drawn on a white background in the main views. |
AutoCapitalizeEventTitle | boolean | true | Set to True to have the event title (Pimlico's Description field) auto-capitalize the first letter of each word. |
ViewsToCycleThrough | stringslist | DayView| Day+View| WeekView| MonthView| Month+View| FreeTime View| ListView |
Specify which views the left<->right gesture cycles through and the order in which those views appear. Tap Up/Down in selection list to select one item and move it up or down. At least two items must be selected to press the OK button. |
ShowUrgencyFirst | boolean | false | Set to true to display urgency before priority |
;CustomFontScaleFactor | int 10-1000 | 167 |
Percent Rescale factor for custom font-sizes coming from Pimlical
Desktop - 12 point becomes 20 point for Android by default. A value of
100% would leave the pointsize unchanged. This preference not used at this time. |
ShortTimesInDayView | boolean | false | If set true and timeslots start on hour boundary and have an integral number of hours as length, only the hour will be displayed, leaving more room for the display of text in the Day and Day+ views |
DefaultSlotHeight | int 0-500 | 0 | Set to a value other than zero to fix the time slot height in pixels in the Day and Day+ views. A value of 0 tells Pimlical to dynamically adjust the slot height to avoid scrolling if at all possible. |
MaxLinesInListView | int 1-100 | 1 | Maximum # of lines to display per entry in the list view - set to 100 to effectively display all lines for all items. |
UseAlternateWeekView | boolean | false | Set to true to use the alternate week view (7 equal days vertical) when only one week is selected. Overrides setting of UseThirdAlternateWeekView if true. |
UseThirdAlternateWeekView | boolean | false | Set to true to use third alternate week view (Mo-Tu | We-Th | Fr-ss instead of Mo-Th | Tu-Fr | We-ss ). |
FreeTypeIndentsEvents | boolean | true | Set to false to have free type events NOT indent overlapping events above it |
ShowDownArrowInMonthViews | boolean | true | Set to false to hide the small down arrow (indicating more events on that day) in the month and month+ views |
ShowIconsOnlyInMultidayView | boolean | false | if set to true, then only icons (no text) are displayed in the multi-day view. |
FixNumberOfIconRows | int 0-100 | 0 | Override the number of displayed icon rows in portrait mode with this value. If set to 0, Pimlical calculates the number of rows based upon the screen height |
FixNumberOfIconRowsLandscape | int 0-100 | 0 | Override the number of displayed icon rows in landscape mode with this value. If set to 0, Pimlical calculates the number of rows based upon the screen height |
IconStartWithRecentList | Boolean | false | Set to True to start display of icons with the recent list rather than page 1 (when no icon is selected). |
SetDefaultTimedUntimed | stringslist | choose timed untimed | In the Day/Day+ view a tap on a timeslot can either make all items timed ("timed") or untimed ("untimed") - or you can use "choose" in which case a tap on the timeslot in the Day/Day+ view forces an item to be preset to that time, while a tap outside of the timeslot sets the item to be untimed (in Day+ view, a tap anywhere on the timeslot makes item timed, while tap on untimed slot will make an event untimed). |
IncludeDayOfWeekInEditDialog | boolean | false | Set to true to have day of week inserted ahead of date in Edit Dialog. |
SelectionListIconSize | (int 5-200) | 80 | Default size of icons displayed in the Event SelectionList |
SelectionListIconStatusSize | (int 5-200) | 120 | Default size for left-most status icon in Event Selection List |
IconDisplayWidth | (int 5-400) | 90 | Default width of icons to display in icon selection dialog |
IconDisplayHeight | (int 5-400) | 90 | Default height of icons to display in icon selection dialog |
ItemBorderThickness | (int 0-100) | 4 | Default thickness for the border used around items in day/day+ views (larger value will make separation of overlapping items clearer). |
FindUsesReverseOrder | boolean | false | Set to True to display results of Find in reverse chronological order. |
AutoScrollDayView | (int 0-100) | 0 | A value of 0 disables autoscroll (normal behavior). Otherwise, a non-zero value automatically scrolls the display so if Today is being displayed, the current or NEXT item on the current day display will be displayed. A value of 1 puts it near the top of the screen, a value of 50 (percent) of the screen height would put it near the middle, while a value of 100% would put it at the bottom. |
AutoScrollListView | (int 0-100) | 0 | A value of 0 disables autoscroll (normal behavior). Otherwise, a non-zero value automatically scrolls the display so if Today is being displayed, the current or NEXT item on the current day display will be displayed. A value of 1 puts it near the top of the screen, a value of 50 (percent) of the screen height would put it near the middle, while a value of 100% would put it at the bottom. |
MonthNumbersAtTop | Boolean | true | Set to true to put month numbers at top right, rather than bottom right. Note that when placed at top right, every cell loses space for text, so it's less efficient (but may be more familiar to have it there). |
GridBorderThickness | (int 0-100) | 2 | Default thickness for the grid border used in day+/week/month views (larger value will create thicker borders. |
WidgetTransparency | (int 0-100) | 20 | Transparency of background for Widget |
WidgetTextRows | (int 0-100) | 0 | Specify number of text rows to use in widget. 0 = try and calculate best value. If rows are clipped or another row might fit, you can force Pimlical to set that number of rows. |
DefaultTasksViewFilter | (Filter) | Tasks_Only | Specify which filter is used for the Tasks View |
MaxLinesInTasksView | (Int 1-100) | 1 | Maximum Number of lines to display in the Tasks View |
MaxLinesInSelectionList | (int 1-100) | 1 | Maximum Number of lines to display in the Event Selection List |
HidePriorityUrgencyButtonsIfNotSet | (boolean) | true | Set to false to always show Priority/Urgency buttons in tasks View even if the priority or urgency of item is not set. |
AnimateTodaysDate | Integer | 40 | Set to 0 to turn off animation of locating today's date in a view other than the day View, otherwise the value is the number of animation steps in the fade-in sequence. |
EMsInTabStops | Integer | 8 | Number of EMs in a tab field (for aesthetic spacing of tables in the Note field when using tab characters, for example). |
FreeTimeStart | time | 540 | Start Time for Free Time (saved as minutes) |
FreeTimeEnd | time | 1020 | End Time for Free Time (saved as minutes) |
FreeTimeWanted | duration | 1h | Free time to loo for in hours and minutes |
OnlyUseContiguousFreeTime | boolean | True | Set to False to look at total free time available on that day |
ShowIconsInFreeTimeView | boolean | True | Set to False to hide the pie chart icons in the Free Time View. |
WidgetDateWidth | (int + ) | 0 | Force Widget Date Width to this value in pixels (in case heuristics are not providing the correct value). Set to 0 (default value) to ignore this setting. |
Display Fonts
Preference Name | Type | Default | Description |
DayViewBannerFont | font | Arial_bold_24 | This font is used for the date banner in the Day View |
DayPlusViewBannerFont | font | Arial-Bold-18 | This font is used for the date banner in the Day+ view. |
DefaultReferenceFont | font | Arial-Plain-20 | This font is what Pimlical considers to be the "default font" - if set on an item, it will be overridden by the current view's default font (except the style attribute which will be maintained). |
NoteFont | font | Arial-Plain-18 | The default text size for display of Note in Edit Dialog and memo text etc. |
MonthHeaderFont | font | Arial-Bold-28 | The default text size for Pimlical's display of the Month Headers |
ListHeaderFont | font | Arial-BoldItalic-24 | The default text size for Pimlical's display of the Date headers in the List View |
DayViewFont | font | Arial-Plain-20 | The default text size for Pimlical's display for text in the Day View only |
MultiDayViewFont | font | Arial-Plain-18 | The default text size for Pimlical's display for text in the MultiDay View only |
WeekViewFont | font | Arial-Plain-18 | The default text size for Pimlical's display for text in the Week View only |
MonthViewFont | font | Arial-Plain-16 | The default text size for Pimlical's display for text in the Month View only |
MultiMonthViewFont | font | Arial-Plain-18 | The default text size for Pimlical's display for text in the MultiMonth View only |
WeekViewDayScreenFont | font | Arial-Bold-20 | Font to use for displaying Date Header in the Weekly View |
MonthViewDayScreenFont | font | Arial-Plain-20 | Font to use for displaying days of month numbers in month and Multi-Month Views |
ListViewFont | font | Arial-Plain-20 | The default text size for Pimlical's display for text in the List View only |
DetailsScreenFont | font | Arial-Plain-24 | Default font to use in the Details dialog |
TimeScreenFont | font | Arial-Bold-20 | Font to use for displaying time fields in day/multi-day views on screen |
DescriptionFont | font | Arial-Bold-14 | Default font to use in the Description field of the main Edit Dialog |
DialogFont | font | Arial-Plain-11 | Default font to use in other dialogs which display the text of items |
ListOfFontSizes | string | 10|12|13|14|16..... | List of available font sizes in Pimlical Android matches Pimlical/Desktop but scales to appropriate size on Most Android devices. |
EventListTimeFont | font | Arial-Bold-16 | Font for time field in Event Selection List |
EventListDescriptionFont | font | Arial-Bold-20 | Font for description field in Event Selection List |
DatePickerFont | font | Arial-Bold-16 | Sets default font/size for Date Picker (Android font metrics are very inaccurate so tweak this value downwards if day values are getting truncated) |
TimePickerFont | font | Arial-Bold-16 | Sets default font/size for Time Picker (Android font metrics are sometimes inaccurate so tweak this value downwards if hour values are getting truncated) |
DisplayTemplateScaleFactor | int | 100 | Adjust all font sizes in display template by this percentage. If low-rez screen, try 50 (50%) - for ultra-hi-rez screens try 200 or more. |
CommandBarFont | font | Arial-Bold-14 | Font for characters in Command bar - 15 or even 16 may work on some Android phones. |
WidgetFontSize | (int) | 12 | Font Size for characters in the description area of events in the widget |
FreeTimeViewFont | font | Arial-Plain-48 | Default font to use in the Free Time View (The bold version is used in the current month, so this should be the plain version). |
Alarm Related
Preference Name | Type | Default | Description |
ApplyAlarmPresetToAppts | Boolean | false | If true, an alarm preset is applied to every newly created appointment, using the ApptAlarmPreset value. |
ApptAlarmPreset | duration | 0s | The preset for the primary alarm expressed as a duration string (such as 30m or 4d 8h). Negative value means BEFORE (normal case) and positive value means AFTER. Only applied to timed events (see below for workaround). |
ApplySecondaryAlarmPresetToAppts | boolean | false | If true, a secondary alarm preset is applied to every appointment, using the ApptSecondaryAlarmPreset value. |
ApptSecondaryAlarmPreset | duration | 0s | The preset for the secondary alarm expressed as a duration string (such as 30m or 4d 8h). If there is no primary alarm preset, and there IS a Secondary Alarm preset then the preset will be applied to untimed events. |
ApplyAlarmPresetToFloats | boolean | false | If true, an alarm preset is applied to every timed Floating event, using the FloatAlarmPreset value. |
FloatAlarmPreset | duration | 0s | The preset for the primary alarm expressed as a duration string (such as 30m or 4d 8h). Only applied to timed events. |
ApplySecondaryAlarmPresetToFloats | boolean | false | If true, an alarm preset is applied to every Floating event, using the FloatSecondaryAlarmPreset value |
FloatSecondaryAlarmPreset | duration | 0s | The preset for the secondary alarm expressed as a duration string (such as 30m or 4d 8h). If there is no primary alarm preset, and there IS a Secondary Alarm preset then the preset will be applied to untimed floating events. |
AlarmSoundRepeatCount | int + | 100000 | Full Page Alarm Dialog: Indicates the number of additional times the alarm sequence will be repeated if not acknowledged (default value of 100,000 means it effectively repeats forever). When exhausted, the Pimlical Alarm notification will still be left in the Android notification area to show that an alarm had triggered and that can be invoked to manage the alarms that went off at a later time. |
AlarmSoundRepeatInterval | duration + | 10m | Full Page Alarm Dialog: Indicates how much time should pass between repeating the alarm if the alarm is not acknowledged (sets up auto snooze if/when display times out from SecondsToSnooze preference). Make CERTAIN that this value is greater than the preference SecondsToAutoSnooze preference as both preferences are timed from when the alarm triggers). |
AlarmSoundPlayTimesCount | int + | 5 | Full Page Alarm Dialog: Indicates how many consecutive times the alarm sound should be played. A value of zero indicates the alarm will be silent. |
AlarmDefaultSound | ringtone | Full Page Alarm Dialog: The default alarm sound for appointments | |
AlarmFloatDefaultSound | ringtone | The default alarm sound for Floating events/TasksFull Page Alarm Dialog: | |
AlarmSnoozeDefaultSound | ringtone | Full Page Alarm Dialog: The default alarm sound to play when a snoozed event triggers (or if multiple alarms, when all are snoozed) | |
AlarmSnoozeButton1 | duration + | 10m | The first alarm button - appears in the Snooze dialog |
AlarmSnoozeButton2 | duration + | 20m | The second alarm button - appears in the Snooze dialog |
AlarmSnoozeButton3 | duration + | 30m | The third alarm button - appears in the Snooze dialog |
AlarmSnoozeButton4 | duration + | 1h | The fourth alarm button - appears in the Snooze dialog |
AlarmSnoozeButton5 | duration + | 5m | The fifth alarm button - appears in Alarm dialog |
SnoozeStrings | durationlist | 5m|10m|20m|..... | The list of durations to display in the popup list when snoozing an event. |
HideAlarmsMoreThanXDaysOut | int 0-9999 | 90 | Ignore any alarms set more than this number of days in the future. |
UntimedAlarmTime | time | 540 | Time at which untimed alarms are to go off (If editing preference file with a text editor, 0 = midnight, otherwise value is in minutes, 540=9am). |
SpeakAlarms | boolean | false | Full Page Alarm Dialog: Set to true to have Pimlical speak out all alarm descriptions before sounding alarm sound (Only applicable when Pimlical is handling alarms directly and Android device supports Google Voice). |
VibrateOnAlarm | boolean | false | Full Page Alarm Dialog: Set to true to have Pimlical vibrate while alarm is sounding (Android may not permit if device locked). |
VibrationDuration | int + | 0 | Full Page Alarm Dialog: If zero, device vibrates on and off until alarm is silenced or alarm dismissed/snoozed. If non-zero, device vibrates continuously for this specified number of seconds |
PitchForSpeakingAlarm | int 1-1000 | 100 | Pitch for speaking alarm, 100 = 100%, 50 = 50% or 1/2 the normal pitch |
SpeedForSpeakingAlarm | int 1-1000 | 100 | Speed for speaking alarm, 100 = 100%, 50 = 50% or 1/2 the normal speaking speed (slowing down the speaking rate may make it more intelligible) |
AlarmPreamble | string | Calendar Alarm | What text is spoken before a spoken calendar alarm goes off. |
PimlicalAlarmHandling | stringlist | local | All = Pimlical will set alarms for items in both the local and the Android calendar database (you would need to shut off alarm handling in the native Android calendar app to avoid duplication), local = Pimlical only sets alarms for items in the local Pimlical calendar database, none = Pimlical does not set any alarms (but alarms will still sound for items in the Android calendar if they are enabled there). |
UnlockScreenOnAlarm | boolean | true | Default is to unlock the screen when an alarm goes off. Switch this to false, and the lockscreen will pop upfirst. Note: some Android devices do not properly implement the Android OS feature that allows this to work. |
SecondsToAutoSnooze | duration + | 2m | DFull Page Alarm Dialog: etermines how long the alarm dialog is displayed before being automatically dismissed (a value of 0 means the alarm dialog is never dismissed but this might also mean that subsequent alarms will not be displayed). This value MUST be smaller than the preference AlarmSoundRepeatInterval as both preferences are measured from the time the alarm triggers. |
IgnoreAlarmsOnHiddenItems | boolean | false | Set to TRUE to ignore the alarms on items that are specifically hidden because all categories assigned to the item are not selected for display. |
UseRingtoneVolumeForAlarms | boolean | false | If there is no ALARM Volume setting on your device (for example, Samsung Galaxy S3/4), set this to TRUE to use the Ringtone Volume setting instead. |
NoAlarmsOnTheseCategories | ApptCategory | List of categories for which there are no alarms (default is all categories/calendars have alarms). | |
MaxDisplayedUpcomingAlarms | (int+) | 50 | Maximum # of upcoming alarms to display in the list of upcoming alarms (if you pick a larger value, it will take longer to build the list). |
ReleaseWakeLockOnAlarmComplete | (boolean) | false | Some Android devices will not autosnooze when the screen powers off, so P/A leaves the wake lock set to keep the device awake until it autosnoozes or user manually dismisses/snoozes alarm. You can set this to True to reduce battery usage if your device is not one of those devices. |
PlayNotificationSound | (boolean) | true | Set to false to avoid playing the notification sound on alarms |
UseNotificationWhenAlarmTriggers | (boolean) | false | On all Android OS PRIOR to Android 10 you can optionally use the Android notification system when an alarm triggers by setting this preference to True (notification then displays the Alarm and Snooze Dialogs).For Android-10, this preference should be set to False if you are using the full-screen Alarm dialog. This preference should be set to the same value as the preference: AlwaysShowNotificationForAlarm. |
AlarmLEDColor | (color) | 0,0,255 | Color for LED status light when alarm notification is posted (Note: Not all Android devices will support this option). Default is blue. |
AutoSnoozeDuringPhoneCall | boolean | false | Set to TRUE to automatically snooze any alarms that trigger during a telephone call. (NOte: Android-12 appears to no longer permit Apps to determine status of telephone). |
AlarmsIgnoreDoNotDisturb | boolean | false | Set to TRUE to have Pimlical's alarms ignore the DO NOT DISTURB setting and sound/vibrate anyway...(note that the Android DND feature to allow "Alarms" is obeyed by Pimlical unless you are using the RingTone volume to set the Alarm volume via the UseRingtoneVolumeForAlarms preference). |
UseAlarmClockForAlarms | boolean | true | Set to False to use the older RTC Clock alarm (less reliable, but does not generate Alarm icon in status bar). |
UseInsistentAlarmForNotification | boolean | true | (Using Notifications For Alarms) True to allow persistent notification sound for Alarms. Set to false to just have a single ding sound for notification (Android 10). |
InsistentAlarmNotificationDuration | (int _ ) | 20 | (Using Notifications For Alarms) Duration to use for the insistent alarm in seconds (Android 10) |
InsistentAlarmSnoozeDuration | (duration + ) | 10m | (Using Notifications For Alarms) Time to snooze the notification alarm to. (Android 10) |
MaximumAlarmNotifications | (int + ) | 5 | (Using Notifications For Alarms) Maximum number of times to snooze alarm notifications (Android 10). Setting this to zero will disable autosnoo |
AlwaysShowNotificationForAlarm | (boolean) | true | (Using Notifications For Alarms) Set to True if you always want to see notifications when alarm triggers. if False, Pimlical will display the full screen Alarm dialog. Note that you must grant Pimlical special permission (Android System Settings) to display over other Apps in order to bring up the full-screen display when its not in the foreground! Also, this preference should be set to the same value as UseNotificationWhenAlarmTriggers. |
ShowAllFutureAlarmsForFloats | (boolean) | true | Set to False to only show the next occurrence of an alarm on a floating event (default of True displays all future occurrences assuming status remains Normal. |
CustomNotificationSound | (ringtone) | (Using Notifications For Alarms) The notification sound to use for custom notification sounds (event has the Action Tag: CustomNotificationSound - Android-10 and later only). | |
SnoozeNotificationSound | (ringtone) | (Using Notifications For Alarms) The notification sound to use for snoozed notification sounds (Android-10 and later only). | |
ApptNotificationSound | (ringtone) | (Using Notifications For Alarms) The notification sound to use for Appointment (and float/tasks if FloatNotificationSOund not set) notification sounds (Android-10 and later only). | |
FloatNotificationSound | (ringtone) | (Using Notifications For Alarms) The notification sound to use for Floating Events and Tasks (Android-10 and later only) |
Appt/Float Settings
Preference Name | Type | Default | Description |
DefaultLocation | String | Sets a default location value that will be applied to all newly-created items | |
DefaultApptDuration | duration + | 1h | Sets the default duration for appointments |
DefaultApptCategory | ApptCategory | Unfiled | Sets the default category (Android Calendar) in which all newly created appointments should be placed. REMEMBER TO PREFIX ANDROID CALENDAR NAME WITH 'A_' ! |
DefaultApptPriority | int 1-10 | 10 | Sets the default priority level for all newly created appointments. A value of 10 means "No Priority" |
DefaultApptUrgency | char ABCD[ | [ | Sets the default urgency level for all newly created appointments. A value of [ means "No Urgency" |
DefaultApptType | recordtype | Busy | Sets the default appointment type for all newly created appointments |
DefaultApptStatus | recordstatus | Normal | Sets the default status type for all newly created appointments |
DefaultFloatDuration | duration + | 10m | Sets the default duration for floats/tasks, in minutes |
DefaultFloatCategory | ApptCategory | Unfiled | Sets the default category (Android Calendar) in which all newly created floats/tasks should be placed. REMEMBER TO PREFIX ANDROID CALENDAR NAME WITH 'A_' ! |
DefaultFloatPriority | int 1-10 | 5 | Sets the default priority level for all newly created floats/tasks. A value of 10 means "No Priority" |
DefaultFloatUrgency | char ABCD[ | [ | Sets the default urgency level for all newly created floats/tasks. A value of [ means "No Urgency" |
DefaultFloatType | recordtype | Busy | Sets the default appointment type for all newly created floats/tasks |
DefaultFloatStatus | recordstatus | Normal | Sets the default status type for all newly created floats/tasks |
DefaultTaskCategory | TaskCategory | Unfiled | Default category (Android Calendar) for Task Creation. REMEMBER TO PREFIX ANDROID CALENDAR NAME WITH 'A_' ! |
DefaultAdvanceForTasks | int 0-10000 | 0 | Default Advance setting in days for tasks created in Pimlical. A value of 10,000 (maximum value) is about 28 years which basically will advance all Tasks). |
PutAdvanceInDifferentCategory | ApptCategory | If this preference is blank, advances are put in the same category as the target event. Otherwise, you can force advances into one or more separate categories. | |
FloatTaskDueDate | stringslist |
undated default dated | Undated = all floats/tasks have no due date set; default = No Due date if created on today's date, otherwise Due date is set; dated = all floats/tasks created with explicit due date. |
Commands and Functions
Preference Name | Type | Default | Description |
AlwaysShowNewDay | Boolean | false | If true, when the date of an item is changed in the Details dialog, the view, on return will be adjusted to ensure that this item is still displayed (useful for confirming that you moved it to where you expected, but annoying if you regularly move large numbers of individual items) |
MultipleCategorySelection | boolean | false | If true, you can assign more than one category to an appointment. When using a foreign database that does not support this capability (such as the Palm OS database) set this preference ot false so this restricts Pimlical to just assigning one category at a time. |
WarnOnDelete | boolean | true | If false, do not warn the user when deleting items |
PutDeletedRecordsInHistoryDB | boolean | false | if True, deleted records are automatically put into the history database when they are purged (future) |
ArchiveDeletedRecords | boolean | true | If true, deleted records will be archived. Archive status is a potential feature of the foreign database that Pimlical is using to get its data from, so this feature exists in case that database is subsequently purged in that application. |
PopupListCommandsForEvent | stringslist | Display Details| Duplicate Item|..... | Select from one to all of these commands to appear when you do a long press in the Event Selection List. Tap Up/Down in selection list to select one item and move it up or down. At least two items must be selected to press the OK button. |
PopupListCommandsForMultiSelect | stringslist | (large list) | Select from one to all of these commands to appear when you do a long press in the Event Selection List AND multiple items are selected. Tap Up/Down in selection list to select one item and move it up or down. At least two items must be selected to press the OK button. |
DoubleClickOnApptOpensDetails | boolean | false | Change to true to have the Details dialog appear (false causes Edit Dialog to appear) when you long press on a selected item in the Day or Day+ views. |
SetZeroDurationIfCanceled | boolean | false | If true, items that are canceled will also be set to a zero duration (so they no longer block out any time in the display). |
LogCompletion | boolean | false | Set to True to log completion of floats & Tasks into a Daily Journal |
AlwaysSelectAllOccurrences | boolean | true | When editing a repeat item, Set this to true to default to selecting All Occurrences. Set to false to default to Just This Occurrence |
ShowSoftInputKeyboard | int 0-3 | 1 | Determines whether soft input keyboard is automatically displayed in a dialog that has an edit field: 0=never, 1=sometimes, 2=always, 3=Ignore. 1 (Sometimes) will show the soft input keyboard in the Edit dialog on creating a new event, but not editing an existing event. Ignore avoids having Pimlical change the keyboard state automatically |
MenuCommandsAndOrder | stringslist | Go To|Views|Filters| Voice|Toggle Untimed|Find|...... | Select from one to all of these menu items to appear when you do press the menu button. Tap Up/Down in selection list to select one item and move it up or down. At least two items must be selected to press the OK button.. You will need to exit Pimlical with long press on back button and relaunch Pimlical in order to see the changes to the menu. |
AlternateSelectionInterface | boolean | false | If set to true, uses a different selection interface( Short tap edits item if item tapped, otherwise displays event Selection List; long tap does popup Command functions on selected item, else brings up event selection list). Some users with larger screens where selection is less of an issue may find this preferable. |
AllowSwipeToChangeFontSize | boolean | true | Set this to false if you want to disable this feature. If false, the region for scrolling the screen then extends to the right margin. |
ShowCustomFieldsInDialogs | boolean | false | Set to true to always display custom fields in the Edit/Find Dialogs (if an event has explicit custom fields, then the fields are shown anyway). |
NumberOfMenuRows | integer | 2 | Set number of menu Rows to display in first menu list. If you set it to say 20 it will display all menu items when the menu button is pressed. Put a minus sign in front of the number of rows to put the menu icon on the left rather than above the text. |
MenuButtonTextSize | integer | 0 | Size of text in main menu. A value of 0 uses the default menu text size, otherwise a non-zero value sets the text size. Change this if the menu text size on your Android device is too large or too small for your taste. |
ShowCommandBar | boolean | true | Set to false to hide the command bar (you can still use swipe gestures to navigate!) |
CommandBarViewButton0 | stringslist | Pr - Previous Day/Week/Month|Ne - Next Day/Week/Month|Cr - Create New Event|Fl - Create New Floating Event|Tk - Create New Task|Fi - Find|L - List View|T+ - Today/Day View|D - Day View|D# - DayPlus View|W - Week View|M - Month View|M# - MonthPlus View|C - Contacts|N - Notes/Memos|J - Journal|Q - Quick Entry Templates|F - Filters|V1 - View Filter #1|V2 - View Filter #2|V3 - View Filter #3|V4 - View Filter #4|F1 - Find Filter #1|F2 - Find Filter #2|F3 - Find Filter #3|F4 - Find Filter #4|Me - Main Menu|Hide | Select Action for this Command Bar View button or use 'Hide' to hide the button |
CommandBarViewButton1 | stringslist | Select Action for this Command Bar View button | |
CommandBarViewButton2 | stringslist | Select Action for this Command Bar View button | |
CommandBarViewButton3 | stringslist | Select Action for this Command Bar View button | |
CommandBarViewButton4 | stringslist | Select Action for this Command Bar View button | |
CommandBarViewButton5 | stringslist | Select Action for this Command Bar View button | |
CommandBarViewButton6 | stringslist | Select Action for this Command Bar View button | |
CommandBarViewButton7 | stringslist | Select Action for this Command Bar View button | |
UserDefinedGestureTLBR | stringslist | Select Action for this user defined Diagonal gesture. TLBR = T-op L-eft TO B-ottom R-ight | |
UserDefinedGestureTRBL | stringslist | Select Action for this user defined Diagonal gesture. TRBL = T-op R-ight TO B-ottom L-eft | |
UserDefinedGestureBLTR | stringslist | Select Action for this user defined Diagonal gesture. BLTR = B-ottom L-eft TO T-op R-ight | |
UserDefinedGestureBRTL | stringslist | Select Action for this user defined Diagonal gesture. BRTL = B-ottom R-ight To T-op L-eft | |
FilterNamesForCommandBar | String | Default | Specifies up to FOUR filter names separated by commas to use with the eight commands (F1 - View Filter #1, F2 - View Filter #2 etc.). |
TemplateNamesForCommandBar | String | Specifies up to FOUR Template names separated by commas to use with the four commands (T1 - Invoke Template #1, T2 - Invoke Template #2...) etc.). | |
UseTemplateButtonInWidget | Boolean | false | Set to true to display the quick entry template button in Widget. |
HideAllWidgetButtons | Boolean | false | Set to True to hide all the top row buttons in the Widget. |
EditDialogQuickReturn | Boolean | false | Set to true to quickly return to the main view on Ok/Cancel in Edit dialog, bypassing the normal return to the Event Selection List. If set to true, this also returns to the main view after executing a popup command on an item in the event selection list (such as deleting an item). And it also applies to the Find function and other selection lists (view upcoming alarms, etc.). |
LockDueStartDateOnTasks | Boolean | true | Set to false to unlink the due date and start date on tasks - if true, the due date and start date are always forced to the same value. |
DaysToShiftBy | 0 | Days to shift by in list/day+/Weekly views, with 0 disabling this feature. moves by # of days in view, or weeks if more than one week. | |
MaxLinesForNoteDisplay | 4 | Maximum number of lines for the display of the Note field in the Edit Dialog | |
HidePriorityOnAppts | Boolean | true | True to hide the priority field in the EDIT Dialog when handling appointments |
HideUrgencyOnAppts | Boolean | true | True to hide the urgency field in the EDIT Dialog when handling appointments |
HideApptTypeOnAppts | Boolean | false | True to hide the Appointment type field in the EDIT Dialog when handling appointments |
HidePriorityOnFloats | Boolean | false | True to hide the priority field in the EDIT Dialog when handling Floating events or Tasks |
HideUrgencyOnFloats | Boolean | false | True to hide the urgency field in the EDIT Dialog when handling Floating events or Tasks |
HideApptTypeOnFloats | Boolean | false | True to hide the Appointment type field in the EDIT Dialog when handling Floating events |
RecentUpdatesCutoff | 30d | Normal cutoff for the display of recently updated/accessed items (contacts, calendar items, etc.) (default = 30 days). In Contacts screen, note that a Long Press on the REC. button includes all days. | |
HideIconFieldInEditDialog | Boolean | false | True to hide the Icon field in the EDIT Dialog |
HideGroupFieldInEditDialog | Boolean | false | True to hide the Group field in the EDIT Dialog |
HideMeetingFieldInEditDialog | Boolean | false | True to hide the Meeting field in the EDIT Dialog |
HideCustomAlarmFieldInEditDialog | Boolean | false | True to hide the Custom Alarm field in the EDIT Dialog |
HideFontFieldInEditDialog | Boolean | false | True to hide the Font field in the EDIT Dialog |
IgnoreUniqueLocations | Boolean | false | Set to True to ignore unique location names when building location list. |
LastNonDefaultFilterName | String | Default | Last non-default filter name seen - normally this is maintained by Pimlical when switching to a filter other than the Default filter and not set by the user. |
UseFileNavigatorForImages | Boolean | False | Set to True to use a File Navigator dialog to select images, rather than an image picker with your default Image App for selecting images. |
AndroidDeletesToUndelete | Boolean | false | Set to True to put deleted Android calendar items in the local calendar as deleted (So you can Undelete them later on). |
Date/Time Items
Preference Name | Type | Default | Description |
DayStartMinute | time | 540 | Set the starting time for the day. Unless all time slots are being displayed, the first time slot to be displayed on the day will be the earlier of either this time, or the first appointment on the day. |
DayEndMinute | time | 1020 | Set the ending time for the day. Unless all time slots are being displayed, the last time slot to be displayed on the day will be the later of either this time, or the last appointment on the day. |
FirstWeekOfThisYear | date | If a date is set, this determines the first week of the Current year as used to compute custom week numbers for display. | |
FirstWeekOfNextYear | date | If a date is set, this determines the first week of the Next year as used to compute custom week numbers for display. | |
AdvanceFloatingEventsTime | time | 120 | Set to exactly 12:00a (00:00) to avoid advancing floating events. Any other time will cause floating events to be advanced on the first occasion that Pimlical runs in the new day (the specific time is not relevant). In most cases, either Pimlical Desktop OR Pimlical/Android should be set to advance floating events, but not both. |
DisplayWeekNumbers | boolean | true | If true, week numbers are displayed along with the month selection panel |
HomeTimeZone | timezone | Defines the home time zone. Items which have no explicit timezone assigned to them are assumed to be in this timezone | |
CurrentTimeZone | timezone | Home Timezone | Defines the current time zone. As a person moves from one timezone to another, this is the preference setting that gets changed. Be sure to set the preference AutoSetTimeZoneFromPhone to false if you want to change this setting manually! |
CreateTimeZone | timezone | Home Timezone | Defines the default timezone in which new items will be created. Normally this is the same as the current time zone but can be set to a different, explicit value. Be sure to set the preference AutoSetTimeZoneFromPhone to false if you want to change this setting manually! |
StartOfWeek | dayofweek | 0 | Defines the starting day of the week to be used throughout Pimlical with the sole exception of the 7-day display in the Multi-Day view. |
WeekViewStartOfWeek | dayofweek | 1 | Defines the starting day of the week to be used in the 7-day display in the Multi-Day View only. |
IncludePmIndicator | boolean | true | When true, the US style Am/Pm indicator is used for times. |
TwelveHourClock | boolean | true | When true, times are displayed on a standard US style 12 hour clock (otherwise world-wide 24 hr standard is used |
TimeSeparatorString | char :. | /|;- | : , The character to use to separate the components of a time (i.e. hour | minute | second) |
DateSeparatorString | char :. | /|;- | / , The character to use to separate the components of a date (i.e. day | month | year ) |
LetterForWeek | char a-z | w | the letter to use for a weeks (when displaying a duration value); |
LetterForDay | char a-z | d | the Letter to use for a day (when displaying a duration value) |
LetterForHour | char a-z | h | the Letter to use for an hour (when displaying a duration value) |
LetterForMinute | char a-z | m | the Letter to use for a minute (when displaying a duration value) |
LetterForSecond | char a-z | s | the Letter to use for a second(when displaying a duration value) |
DateOrder | stringlist | mdy | The order in which dates should be displayed (mdy is US default, dmy ymd are general defaults in rest of the world, iso = ISO standard for date formats) |
IncludeTimeZoneSupport | boolean | true | If true, timezone support is enabled in Pimlical. **WARNING** DO NOT SET TO FALSE UNLESS YOU KNOW EXACTLY WHAT YOU ARE DOING AS OTHERWISE, PIMLICAL/ANDROID WILL CRASH ON TRYING TO READ GOOGLE CALENDARS, ETC. |
DefaultIsUntimedAdvances | boolean | true | If true, advances on events are generated as untimed events (if false advances are generated with the same time as their target event. |
MultiDayViewAlternateTimezone | timezone | All Timezones | Timezone to use for the display of the background times in all columns of the Day+ View (All Timezones will always display the same time, while Home Timezone would display your home time zone in the background while displaying your current timezone in the leftmost column). |
UsePimlicalDateTimePicker | boolean | true | Set to false to use the standard Android Date and Time Pickers |
UseAlternateTimePicker | Boolean | true | Set to false to use the original Pimlical Time Picker which matched more closely how Pimlical/Android's predecessor used to work. If True, overrides the preference UsePimlicalDateTimePicker vis-a-vis setting times..... |
AltTimePickerAutoClose | Boolean | true | Set to false if you want the alternate Time Picker dialog to stay open when the last digit is typed (only an issue if you use a 12-hour clock and like to tap Am/Pm button after entering the digits). |
AutoSetTimeZoneFromPhone | boolean | true | Set to false to always manually set the current & Create timezones. Useful if you have a device that does not present the current timezone in the proper Olson database format. |
Colors
Preference Name | Type | Default | Description |
DefaultBackgroundColor | color | 255,255,255 | Default background color to use in all views. Default value is white. |
DayViewShadeColor | color | 240,240,240 | Color to use to shade appointments in the Day and Multi-Day Views |
TimeSlotBackgroundColor | color | 225, 255, 225 | Color to use for background of timeslots in day and day+ views - default is a very light green. |
TodayColor | color | 255,255,225 | The color to shade the background for Today with (default is light-beige) |
ViewSeparatorLineColor | color | 0,0,0 | The color to use for drawing the separator lines in the week and monthly views |
MonthNumberColor | color | 0,0,0 | Color to draw the days of the month in the Month and Month+ views |
TodayMonthNumberColor | color | 160,0,0 | Color to draw the days of the month when the day number = today in Month and Month+ views. |
ListViewHeaderBackground | color | 255,255,225 | Background color for date headers in list view. |
ListViewHeaderForeground | color | 160,0,0 | Foreground color for date headers in list view. |
MultiDayViewTimeColor | color | 192,192,192 | Sets the color to be used in the multi-day view on blank time lines in columns other than the first column. Set a value of 0,0,0 to avoid drawing the times alltogether |
OtherMonthBackgroundColor | color | 180,180,180 | Sets the color background to be used for months outside of the current month |
ShadedDatesColor | color | 240,255,240 | Default color to use for the ShadedDates preference (previously this was specified in hexadecimal as part of the ShadedDates Preference |
PastDaysColor | color | 255,255,255 | Default color to use for background of past Days (i.e. days prior to today) in calendar views. |
ReverseHeaderColor | color | 180,90,90 | Sets the background color used to draw the week number or Month name in the Week and Month+ Views - text will be drawn in white if all three components are less than 190, otherwise text is drawn in black |
UseGoogleCalendarColors | boolean | true | Set this to false to ignore Google Calendar colors and use Pimlical's category color scheme |
UseWhiteTextInWidget | Boolean | false | Set this to true to use white text in the widget (default is black). |
WidgetUsesEventCategoryColors | Boolean | true | Set to TRUE to use the event colors in the widget display. |
ForeColor1 | color | 0,0,0 | Red, Green and Blue component values for the color at this position in the color palette |
ForeColor2 | color | 255,0,0 | Red, Green and Blue component values for the color at this position in the color palette |
ForeColor3 | color | 0,255,0 | Red, Green and Blue component values for the color at this position in the color palette |
ForeColor4 | color | 0,0,255 | Red, Green and Blue component values for the color at this position in the color palette |
ForeColor5 | color | 192,192,192 | Red, Green and Blue component values for the color at this position in the color palette |
ForeColor6 | color | 235,235,235 | Red, Green and Blue component values for the color at this position in the color palette |
ForeColor7 | color | 255,255,255 | Red, Green and Blue component values for the color at this position in the color palette |
ForeColor8 | color | 255,255,0 | Red, Green and Blue component values for the color at this position in the color palette |
ForeColor9 | color | 128,0,0 | Red, Green and Blue component values for the color at this position in the color palette |
ForeColor10 | color | 255,140,0 | Red, Green and Blue component values for the color at this position in the color palette |
ForeColor11 | color | 0,255,255 | Red, Green and Blue component values for the color at this position in the color palette |
ForeColor12 | color | 139,69,20 | Red, Green and Blue component values for the color at this position in the color palette |
ForeColor13 | color | 255,20,150 | Red, Green and Blue component values for the color at this position in the color palette |
ForeColor14 | color | 0,155,155 | Red, Green and Blue component values for the color at this position in the color palette |
ForeColor15 | color | 0,0,155 | Red, Green and Blue component values for the color at this position in the color palette |
ForeColor16 | color | 128,0,128 | Red, Green and Blue component values for the color at this position in the color palette |
BackColor1 | color | 255,255,255 | Red, Green and Blue component values for the color at this position in the color palette |
BackColor2 | color | 0,0,0 | Red, Green and Blue component values for the color at this position in the color palette |
BackColor3 | color | 255,0,0 | Red, Green and Blue component values for the color at this position in the color palette |
BackColor4 | color | 0,255,0 | Red, Green and Blue component values for the color at this position in the color palette |
BackColor5 | color | 0,0,255 | Red, Green and Blue component values for the color at this position in the color palette |
BackColor6 | color | 255,255,0 | Red, Green and Blue component values for the color at this position in the color palette |
BackColor7 | color | 235,235,235 | Red, Green and Blue component values for the color at this position in the color palette |
BackColor8 | color | 0,255,255 | Red, Green and Blue component values for the color at this position in the color palette |
BackColor9 | color | 128,0,0 | Red, Green and Blue component values for the color at this position in the color palette |
BackColor10 | color | 255,140,0 | Red, Green and Blue component values for the color at this position in the color palette |
BackColor11 | color | 0,255,255 | Red, Green and Blue component values for the color at this position in the color palette |
BackColor12 | color | 139,69,20 | Red, Green and Blue component values for the color at this position in the color palette |
BackColor13 | color | 255,20,150 | Red, Green and Blue component values for the color at this position in the color palette |
BackColor14 | color | 0,155,155 | Red, Green and Blue component values for the color at this position in the color palette |
BackColor15 | color | 0,0,155 | Red, Green and Blue component values for the color at this position in the color palette |
BackColor16 | color | 128,0,128 | Red, Green and Blue component values for the color at this position in the color palette |
Memos
Preference Name | Type | Default | Description |
MemoSort | stringlist | alphanumeric- ascending | The order in which memos should be displayed: alphanumeric, category display or date in either ascending or descending order. For the date sort: descending order (date = newest memo at top) or ascending order (date-ascending = oldest memo at top). |
MemoTextLines | int | 3 | Number of text lines to display in memo view |
MemoTitleFont | font | Arial-Bold-18 | Default font for the title in the memo Selection list |
MemoTitleColor | color | 0,0,128 | Red, Green and Blue component values for the color of memo titles in the Memo Selection List (unprotected memo) |
MemoProtectedTitleColor | color | 128,0,0 | Red, Green and Blue component values for the color of memo titles in the Memo Selection List for protected memos |
MemoTextFont | font | Arial-Plain-12 | Default font for the text displayed in the memo selection list |
MemoCategoryFont | font | Arial-Plain-10 | Default font for displaying the category name and date in the memo selection list |
MemoEditFont | font | Arial-Plain-16 | Default font for displaying text in the memo edit dialog |
DefaultMemoCategory | string | Unfiled | Default category to put memos in |
MemosStartupView | stringlist | All | Sets default startup view for memos (All, Favorites or Recent) |
BackupLocalMemos | Int | 1 | Number of days between backing up local memos database if there is a local memos database and it was accessed (1 = daily, 2 = every other day, etc.). Set to 0 to avoid backing up local memos database completely. |
Contacts
Preference Name | Type | Default | Description |
ContactSort | stringlist | Last Name Ascending | The order in which contacts should be displayed. The sort can be in ascending or descending order by first name, last name or company name. |
DefaultContactsCategory | String | Unfiled | Default category to put contacts in. |
ContactPhotoEditSize | integer | 180 | Size in pixels for the contact photo in the Edit dialog |
ContactPhotoListSize | integer | 120 | Size in pixels for the contact photo in the contacts list |
BackupLocalContacts | integer | 1 | Number of days between backing up Local Contacts database if there is a local contacts database and it was accessed (1 = daily, 2 = every other day, etc.). Set to 0 to avoid backing up local contacts database completely |
ContactsViewNoteFont | font | Arial-Plain-14 | Default font for displaying the text of the note field in the Contacts View Dialog |
AlwaysShowCompanyName | boolean | true | Set to false to hide the company name on first/last name sorts. |
ContactPictureDisplay | stringlist | always| only if present| never | Contact picture is either ALWAYS displayed, displayed ONLY IF PRESENT, or is NEVER displayed in the Contact Selection List and also the View dialog. It is always displayed in the Edit dialog |
ContactStartupView | stringlist | All|Favorites|Recent | Sets default startup view for contacts (default is Favorite contacts) |
SetNumbersOnlyOnZip | boolean | false | Set to true to only allow numbers in zip codes (US Style) - this presets numeric keyboard when field is entered |
HideAddressInContactsList | boolean | false | Set to true to hide the address field in the contacts list display. If you set this to true, you may also want to reduce the pixel size or hide the contact Image. |
SortByCompanyNameIfNameBlank | boolean | false | Set to True to sort company names inline with first/last name sort if first/last name is blank. Set to False to sort blank names last. |
BlankPrimaryKeySortsFirst | boolean | false | Set to TRUE to sort contacts with blank primary keys BEFORE contacts that have an explicit primary key. |
SkipUniqueCustomLabels | boolean | false | Set to TRUE to skip custom labels that were only used once in the database (reduces size of the pick list for labels). |
DefaultPreferredPhoneLabel | String | Set default for the preferred Phone Label | |
DefaultPreferredAddressLabel | String | Set default for the preferred Address Label |
System Settings
Preference Name | Type | Default | Description |
GoogleRefreshInterval | int | 0 | Refresh interval for re-reading Google/Android Calendar (on next screen redraw) in seconds (for example 900 = 15 minutes). Set this to 0 to turn off the automatic refresh completely. Avoid problem values like 5 seconds as that won't work well. |
GenerateTagsForExceptions | boolean | true | Android only handles one ExDate command, so Pimlical has to put any additional exception dates in a tag if true. When this bug is fixed in Android, this can be set back to false. |
UseGoogleExtendedProperties | boolean | false | (Note: this preference is always considered false as there is no support yet for extended properties in Android). If true, Pimlical will use Google's extended properties to preserve special items. If false, tags are created in the note field (Google's 'description' field). If other programs are accessing and updating Google Calendar, it's possible they may trash or not properly preserve the extended proprties field, in which case it's safer to set this to false and have the properties saved in the note field. |
IgnoreTentativeStatusInGC | boolean | true | Some updates of GC (such as from Android devices) mark everything as Tentative (!), so you can set this preference to true to avoid having that happen. |
RegisteredUserName | string | PimlicalUser | Set your registered name in Pimlical/Desktop here if you sync with the desktop, so that Pimlical knows you are the same person who is using the desktop version (helps avoid unnecessary creator tags). |
DebugMode | boolean | false | When set to true, several debug routines are enabled in Pimlical. Some may impact performance to a slight degree, but if you are experiencing some unusual problems, turning on Debug mode may enable a test which will show why a problem is occurring. Turning on Debug mode also enables Crash Reporting where a stack trace of where any crashes that occur are sent to Pimlico for analysis. The only item other than the stack trace that is sent includes Android version, Android device model, P/A version and primary email address of user (so crash report can be linked to a user). No personal data is sent. |
DaysBackToRead | int | -1 | The Number of days to go back for reading events on Android calendars only. Non-recurring events more than this number of days old (or recurring events that end before this number of days in the past) will not be displayed - this will speed up the refresh significantly if you have a lot of old events. A value of -1 indicates that all non-recurring events are to be read. |
MayHaveFloatingEvents | boolean | true | An internal flag maintained by Pimlical to determine if there are any floating events in the database. If false, there is no point in scanning the database for them. If true, there MIGHT be some floating events, so the database should be scanned (but a setting of true does not GUARANTEE that there are some floating events present). |
FloatAdvanceSetsDirtyFlag | boolean | false | If false, the dirty flag is not set by Pimlical when advancing floating events in a local database. Depending on the foreign database being used, this allows control over how the synching strategy on that database operates. This preference has no affect if the item is in an Android calendar, syncing with google. If you are using DirectSync, set this preference to TRUE on both platforms. If syncing through Google, typically, this would only be set on the one platform that is updating Google calendar. |
LastFloatingUpdate | date | 20071214T183004Z | Remembers the date on which the last floating update was performed (this is only used in standalone mode and normally managed by Pimlical). |
NumberOfBackups | int 0-10 | 5 | specifies how many backup copies are to be retained of the various databases that Pimlical modifies |
WeeklyMonthlyBackups | stringlist |
weekly monthly weekly & monthly neither | Takes weekly and/or monthly backups of all PIM databases and system files so you have an older version to go back to if needed. Weekly = weekly only, monthly = monthly only, weekly&monthly = weekly and monthly, neither = no weekly nor monthly backup. |
MaintainAuditTrail | boolean | false | If True (default setting) an audit trail of every change to the calendar and tasks databases is maintained in PimlicalAuditTrail.txt file |
AuditDescriptionLength | int | 40 | Always truncate description/note/location field of record to be no longer than this number of characters (use a very large value to always include the entire description). |
CurrencyDelimiter | string | . | Currency delimiter to use in export function (4.25 etc.) |
RepeatTasksHaveNoExceptionList | boolean | true | set false if they do have exceptions list. |
LastPurgeOfDeletedRecords | date | 20090101T000000Z | Remembers the date on which deleted records were last removed from the PIM databases (this is only used in standalone mode, and normally managed by pimlical). |
CheckForNewSoftwareRelease | int + | 14 | Check for new software release every number of days specified here. Set to 0 to completely disable this feature. |
ShowHelpOnStartup | boolean | true | Set to false to avoid having Pimlical display the HELP file on startup (Pimlical automatically sets this to false after displaying the Help dialog one time). |
CalendarNamesAreUnique | boolean | true | Set to false to allow the reading of calendars with the same name. If true, calendar names, even across multiple accounts, must be unique. |
NoMeetingIconIfOnlyOneAttendee | boolean | true | Set to false to include meeting information when I am the only attendee (based upon match of primary mail account with meeting account email). |
CalendarIsNotSynced | boolean | false | Only set this to true if you never sync the Android calendar |
CalendarIsNotCached | boolean | false | Only set this to true if you are having a problem with Pimlical/Android reading the cached calendar file. |
CurrentLocalCalendar | string | PimlicalLocalCalendar | Name of the current local calendar being read by Pimlical |
IgnoreAndroidCalendarTimeZone | boolean | false | If the Android calendar has the wrong timezone and is screwing up the times of events, set this to true, and Pimlical/Android will then force the timezone to match the Home Time Zone. |
SaveCreationModificationInfo | boolean | true | Set to false if you want to avoid saving the creation date/modification date, modifier and creator info in the Android calendar database's tagged note field/extended attributes. However, setting this to false may interfere with syncing with some other calendars. If Pimlical/Desktop also syncs information to other platforms, be sure to leave this set to true as otherwise that could interfere with DirectSync to Pimlical/Android. |
LocalCalendarSelected | boolean | false | Set to true to select the local calendar - this is normally done automatically by Pimlical from the Menu | Select Calendars dialog - but you can also preset this value in different filters, etc. |
HideAllAndroidCalendars | boolean | false | Set to true if using local calendar and you don't want to see any Android calendars at all in selection list, etc. |
DaysToKeepDeletedRecords | int + | 7 | Set how long to keep deleted records in the Pimlical Local Calendar (deleted records are needed in syncing to remove corresponding record from other platform, so be sure you don't end up removing deleted records before they get synced) |
BackupLocalCalendar | int + | 1 | Number of days between backing up Local Calendar if there is a local calendar (1 = daily, 2 = every other day, etc.). Set to 0 to avoid backing up local calendar completely |
IgnorePrivateEventSetting | boolean | false | Set to TRUE to have Pimlical completely ignore the PRIVATE event setting flag in the Android database. Note that if you set this preference to TRUE and modify an event, it won't be marked as a private event when synced back to Android/Google calendar. |
StartTagChar | string | [ | Determines which character is used at the START of an embedded tag in the note field and the [xx] downcount field in floating events. Caution: use care in changing this preference. If you sync through google, it's very important that these characters match up with the same preference in Pimlical/Desktop (that also just gained these same two preference settings). If they are out of sync with each other, all that custom information can be lost and that could cause major headaches in trying to restore everything. This would only be needed in special cases where some other application was also trying to put tags in the note field and was using the same delimiting characters. |
EndTagChar | string | ] | Determines which character is used at the END of an embedded tag in the note field and the [xx] downcount field in floating events. Caution: use care in changing this preference. If you sync through google, it's very important that these characters match up with the same preference in Pimlical/Desktop (that also just gained these same two preference settings). If they are out of sync with each other, all that custom information can be lost and that could cause major headaches in trying to restore everything. This would only be needed in special cases where some other application was also trying to put tags in the note field and was using the same delimiting characters. |
FastStartup | boolean | true | Set to false to disable fast startup. There would never be a reason to set this to false unless some specific problem with the Fast Startup was suspected. |
ViewType | int 0-6 | 1 | Specifies the startup view - normally maintained by Pimlical - if you change this value it's setting is not likely to be preserved. 0=preserve, 1 = Day, 2 = Day+, 3 = Week, 4 = Month, 5 = Month+, 6 = list |
CustomAutoCompleteText | boolean | false | Set to true to use a custom auto-complete text function rather than standard autocomplete Function |
EnableDebugLog | boolean | false | Set to true to enable debug logging - not recommended that Pimlical be left with this set for too long as it does cause some performance impact and the log file will get very large very quickly. Primarily for use only under advice/analysis by Pimlico Software. |
JavaDefaultEncoding | string | Default encoding for reading Ascii Text etc. In theory, Android should use UTF-8 everywhere, but it doesn't. Setting encoding to UTF-8 may help with non-Roman languages, but may cause issues with Accented characters entered in different encodings. If left blank, the default encoding for the operating system is used. The value here should match any platform you sync Pimlical to. | |
CurrentPimlicalVersion | string | Set to current version on startup - may be used to insert new menu functions/features when upgrading version - normally just for information | |
HttpAddressesForSync | String | Http Network address(es) of your PC running P/D to use for DirectSync. Enter a value like 192.168.1.4. You can have multiple Http adddresses separated by a comma or vertical bar. Pimlical will always move the most recent connection that worked to the top of this list. | |
InternetTimeout | int 100-1000000 | 5000 | Timeout in Milliseconds for testing to see if IP Address is reachable in DirectSync. |
LastAndroidReadDate | Date | Intended for System use Only - remembers the last date/time on which Android native contacts were read into Pimlical local contacts | |
iCalendarImportCategory | ApptCategory | When importing iCalendar events, you can specify one or more categories into which all newly imported events will be placed. Otherwise, if nothing is specified here, the item will be placed in the designationed category (if there is an iCalendar field for the category) and if not, then it will be put in the Unfiled Category. | |
WidgetRefreshInterval | (int +) | 2 | Refresh widget interval in minutes. Widget is only refreshed while device is awake. |
CurrentActiveFilter | (Filter) | default | The currently active filter when Pimlical exited - normally this is ONLY changed by the system and not something you as a user would normally change. |
LongDurationForMessages | boolean | false | Set to True to have ALL popup messages ("toasts") stay on the screen for a longer period of time. |
FingerSlipThreshold | int | -1 | Defines the threshold in pixels for inadvertently slipping finger on screen so as to discriminate between a fling or scroll and a brief tap or long press that the finger slipped while performing. Set this to -1 to allow Pimlical to pick an appropriate value for your screen size/resolution. Or you can manually set a value for this preference - the default of -1 is changed to a value that corresponds to about 1/10th of an inch (2.5mm). |
AutoSyncFilePath | String | CloudRail/Dropbox/ PimlicalAutoSync/ | Sets the path to use for AutoSync (If it begins with 'CloudRail' this supports cloud-based servers via CloudRail, otherwise it is assumed to be a valid path in the file system (possibly a networked drive, mapped WebDAV server, etc.). |
AutoSyncFrequency | Duration | 0s | Specifies how often AutoSync runs (reasonable value might be something like 30m) |
AutoSyncName | String | (none) | Specifies the unique Name for AutoSync - will be automatically assigned by Pimlical if left blank - but you can enter a more meaningful name (like Home Laptop). |
AutoSyncThreshold | Duration | 5m | Maximum duration for AutoSync to run (after this time, the task will be killed if still running and the lock flag removed). |
DisplayMessageWhenAutosyncCompletes | Boolean | true | Set this to false to prevent a brief 'toast' appearing at the conclusion of every AutoSync. |
LocalCalendarSyncThreshold | Integer | 10 | If the difference in modification date/times of two items is LESS than this threshhold value (in seconds), then the two items are considered to be identical. Normally, there would be no reason to change this value. |
DirectSyncOptions | StringsList | calendar,tasks | Determines which checkboxes are checked in DirectSync, use calendar,tasks,contacts,memos to sync everything. |
AutoSyncOptions | StringsList | calendar,tasks | Determines which Databases are synced in AutoSync. |
AutoSyncAction | StringList | Synchronize | Select default synchronization modefor AutoSync. Normal Setting is Synchronize, but on very FIRST sync, you should overwrite from good platform to the one that has no/old data. |
ApptCategoriesToSync | ApptCategory | (All) | Specifies which Appointment categories are to be synced with AutoSync and/or DirectSync. |
TaskCategoriesToSync | TaskCategory | (All) | Specifies which Task categories are to be synced with AutoSync and/or DirectSync. |
ContactCategoriesToSync | ContactCategory | (All) | Specifies which Contact categories are to be synced with AutoSync and/or DirectSync. |
MemoCategoriesToSync | MemoCategory | (All) | Specifies which Memo categories are to be synced with AutoSync and/or DirectSync. |
LatestUpdateAlwaysPrevails | Boolean | true | Set to true to automatically have the latest update made in Pimlical OR Server Calendar (Google/Drive/Dropbox, etc.) prevail if the item has been modified on both platforms. If false, updates are written to both platforms for you to manually resolve. |
AutoSyncNotificationVibrates | Boolean | True | Set to false to turn off vibration for the notification that AutoSync is taking place |
TimeOfDayForAutoSync | Time | 00:00 | Set to a specific time of day to guarantee that an AutoSync has taken place by this time on that day. Set to midnight (12:00 or 00:00) to disable this feature. |
PortNumberForNetworkSync | Integer | 8391 | Port number to use for Network Sync (DirectSync, AutoSync) - MUST MATCH the port number you have assigned for other devices using DirectSync to this device! Permitted range is 1024-49151. |
ShowSyncChangesOnly | Boolean | true | Set to False to show item-by-item sync comparisons (AutoSync). |
DisplaySyncLog | Boolean | false | Set to True to display Sync log at end of sync. |
WarnOnSettingUpCategories | Boolean | true | Warning is only given once about setting up Default ApptCategory, etc. - automatically set to false after the warning has been given. |