There are several preference settings for handling alarms - this help section only covers those alarm preference settings that have to do with Pimlical's management of the alarm and snooze dialogs. Note: there is a big difference between handling alarms with the full page alarm dialog and handling them as notifications, the latter being less obtrusive, but also less functional.

AlarmDefaultSound - The default alarm sound for appointments - full page alarm dialog only. Only applies to timed appointments

AlarmFloatDefaultSound - The default alarm sound for Floating events/Tasks - full page alarm dialog only. Only applies to timed floating events.

AlarmSnoozeDefaultSound - The default alarm sound to play when a snoozed event triggers (or if multiple alarms, when all are snoozed) - full page alarm dialog only.

AlarmSoundPlayTimesCount - Indicates how many consecutive times the alarm sound should be played. A value of zero indicates the alarm will be silent. - full page alarm dialog only.

AlarmSoundRepeatCount - Indicates how many times the alarm sequence should be played if the alarm is never acknowledged (i.e. how many times the autosnooze feature should be used for an alarm that the user ignores. The default value is 100000 which effectively means it will repeat indefinitely. Alternatively, a value of say 3 would mean that after the third time the alarm sequence triggers, no further alarms will occur. However, the notification that an alarm has triggered is left in the Android notification area (so at a later time you can pull down the notification and view  the alarms). Full page alarm dialog only.

AlarmSoundRepeatInterval - indicates the duration to elapse between redisplaying the alarm dialog and playing the alarm sound again (default is 10 minutes). Full page alarm dialog only.

SecondsToAutoSnooze - indicates for how long the Alarm dialog will be displayed before it is automatically dismissed and all iltems automatically snoozed (they will be snoozed for the duration specified in the preference: AlarmSoundRepeatInterval) - (default is 2 minutes). Full page alarm dialog only.

AlarmSnoozeButton1 - default snooze value for the first snooze button. This is specified as a Duration type value (1m = 1 minute, 2d = 2 days, 1h30m = 1 hour, 30 minutes etc.). Full page alarm dialog only.

AlarmSnoozeButton2 - The default snooze value for the second snooze button. Full page alarm dialog only

AlarmSnoozeButton3 - The default snooze value for the third snooze button. Full page alarm dialog only .

AlarmSnoozeButton4 - The default snooze value for the fourth snooze button. Full page alarm dialog only .

AlarmSnoozeButton5 - The default snooze value for the snooze button that appears in the Alarm Dialog. Full page alarm dialog only .

SnoozeStrings - specifies the list of durations to display in the popup list when snoozing an event (all Android OS versions)O. These are set as 'duration' type values, so something like 4d3h20m is quite legal. Each value should be separated with a vertical bar - for example, the default list is:  5m|10m|20m|30m|45m|1h|2h|4h

HideAlarmsMoreThanXDaysOut - Tells Pimlical to ignore any alarms set more than this number of days in the future (when handling the list of upcoming alarms)

UntimedAlarmTime - Specifies the time at which untimed alarms are to go off. Default value in newly loaded set of preferences is (9am) - you may have 0 set in previous preferences which would be midnight (so make sure you change this preference if you are an early-to-bed person!). Also, this feature only affects alarms set by Pimlical (local calendar, or PimlicalAlarmHandling is set to All).

SpeakAlarms - Set this to true to have Pimlical speak out all alarm descriptions before sounding the alarm sound (Only applicable when Pimlical is handling alarms directly and Android device supports Google Voice). This is very nice when you are driving or can't pull out the phone. Full page alarm dialog only .

VibrateOnAlarm - Set this to true to have Pimlical use vibration while the alarm is sounding. Full page alarm dialog only .

VibrationDuration - if zero, the device vibrates on and off until alarm is silenced or alarm dismissed/snoozed. If non-zero, the device vibrates continuously for this specified number of seconds. Full page alarm dialog only .

PitchForSpeakingAlarm - the default value for the pitch is 100% - you can adjust this over the range of 1 to 1,000 to change the pitch at which the alarm is spoken. This Android feature may not work on all Android devices. Full page alarm dialog only.

SpeedForSpeakingAlarm - the default value for the speed is 100% - you can adjust this over the range of 1 to 1,000 to change the speed at which the alarm is spoken. This Android feature may not work on all Android devices Full page alarm dialog only.

AlarmPreamble - This is a string of text that will be spoken prior to speaking the alarms. You may want to customize this so when your phone suddenly starts speaking to you, you know why. The default is Calendar Alarm. Full page alarm dialog only ..

UnlockScreenOnAlarm - the default setting is true to unlock the screen to present the alarm dialog. If set to false, the lockscreen will pop up first. Note: some Android devices do not properly implement the Android OS feature that allows this to work.

PimlicalAlarmHandling - specifies how Pimlical will handle alarms. 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).

UseRingtoneVolumeForAlarms - Some Android phones have no setting for controlling the Alarm Volume (Bug? DDD? (Dumb Design Decision). Although the standard Android OS has such a control,  many Samsung phones for example have no control over it. In that case, set the preference: UseRingtoneVolumeForAlarms to true and then you can control the Alarm volume by adjusting the Ringtone Volume. Full page alarm dialog only .. 

IgnoreAlarmsOnHiddenItems - set this to TRUE to ignore the alarms on items that are specifically hidden because all categories assigned to the item are not selected for display.  If false, alarms will sound even if all categories to which the item is assigned are hidden.

NoAlarmsOnTheseCategories - specifies aList of categories for which there are no alarms (the default is all categories/calendars have alarms). If an item is assigned to any category in this list, an alarm will not sound on that item.

MaxDisplayedUpcomingAlarms - specifies the maximum # of upcoming alarms to display in list (if you pick a larger value, it will take longer to build the list). The default value is to display the next 50 upcoming alarms. 

ReleaseWakeLockOnAlarmComplete - 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 the 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 - if true, Pimlical will play the default notification sound when snoozing items and posting a notification to the Android OS. Set to false to post silently. Full page alarm dialog only.

AlarmLEDColor - Sets the color of the LED status light on the Android device when a notification is posted. This may not work on All Android devices. Full page alarm dialog only.

AutoSnoozeDuringPhoneCall - Normally, an alarm will trigger during a telephone call (default: False), but if set to True, then Pimlical will automatically snooze any alarms that trigger during a telephone call.

AlarmsIgnoreDoNotDisturb - Normally, if DND (Do Not Disturbe) is enabled in System Settings, Pimlical's alarms and vibration will be suppressed. However, if this preference is set to True, Pimlical will ignore the DND setting and sound its alarms anyway. Note that the OS feature of filtering the DND feature for Alarms will apply to Pimlical's alarms (with the exception that if you are using the Ringtone volume for the Alarm Volume, the DND filter for Alarms will not allow the alarm through).'

UseAlarmClockForAlarms - Normally, you will want to have this set to True (default). Set to False to use the older RTC Clock alarm (less reliable, but does not generate Alarm icon in status bar).

UseInsistentAlarmForNotification - On Android 10, Pimlical must use notifications for alarms (due to new restrictions imposed by Google). This preference chooses the more insistent ALARM sound for notifications. Set to False to use the default NOTIFICATION sound (usually just a single 'ding' sound. Note that you can change the default Alarm and Notification sounds in the system settings of your Android device. Google lifted this restriction in subsequent versions of the Android OS, so you can choose to handle alarms in either manner.

InsistentAlarmNotificationDuration - specifies the duration of the insistent alarm on Android 10 in seconds (usually the default Alarm sound is continuous (i.e. plays repeatedly) - this preference allows you to silence the alarm after the specified time. The default value is 20 seconds.

InsistentAlarmSnoozeDuration  - if you do not respond to the notification on Android 10, Pimlical/Android will auto-snooze the notification for a period of time specified by this preference which is a Duration value. The default value is 10 minutes.

MaximumAlarmNotifications - specifies the maximum number of times the notification on Android 10 should be repeated. The default value is 5. You can disable the auto-snooze feature for notifications by setting this value to zero.

UseNotificationWhenAlarmTriggers - Set to True (default is False) to use the Android notification system when an alarm triggers (notification then displays the Alarm and Snooze Dialogs. Full page alarm dialog only. On Android-10, this should be set to False as Android-10 does not properly handle full-page alarms. This should be set to the same value as the next preference below:

AlwaysShowNotificationForAlarm - specifies that all alarms should be handled by the notification system. The default value for this is False, but it is the recommended setting for Android-10. Most users will prefer to use the full-page alarm/snooze dialogs with Android-11 and later. With Android-10, however,  the Android-OS will prevent Pimlical/Android from launching those dialogs unless Pimlical is already in the foreground. This should be set to the same value as the prior preference above.

ShowAllFutureAlarmsForFloats - When building the list of future alarms (Menu | Upcoming Alarms), this preference controls whether floating events with an alarm appear only on their next occurrence, or on ALL occurrences (i.e. if never crossed off, they will typically trigger an alarm every day until crossed off). The default setting for this preference is: True (which matches the prior behavior), but you may well wish to change this to False if that behavior is not what you prefer.

UseVolumeButtonsForAlarms - Can be set to Ignore (default), Dismiss, or Dismiss & Snooze. Allows the device's volume buttons in alarm dialog to either dismiss all alarms (on either button), or have Volume UP dismiss all and Volume Down snooze all alarms (regardless of whether they are checked or not). 

RestoreFBGrndAfterAlarm - If set to True (default), on dismissing the Alarm dialog, Pimlical will push itself back into the background if it was already in the background when the alarm triggered. False maintains older behavior of leaving Pimlical in the foreground after an alarm triggers and is handled.

AutoSnoozeDelayDuration -On older devices that have the AOS bug (in particular AOS-10) - this will delay the AutoSnoozing of alarms (normally triggered when onStop() callback is properly issued by AOS). You should be able to set this to just a bit less than your Screen display timeout in the Android system settings. Default is 30s (thirty seconds). If you see the alarm dialog closing within 30s to autosnooze, you can set this to a higher value to leave it on the screen longer.

Making Certain that the Android OS Properly Sees the Sounds You Choose for Notifications 

After setting or changing any or all of the four following preferences, you must then clear Pimlical's data as otherwise the Android OS will ignore the change. This Android OS bug has been around since Version 8 (0reo) and it does not look like Google intends to fix it as it is still present on Android-11. So after setting or changing a sound, long-press the Pimlical/Android Icon, select APP INFO | Storage & cache | Clear Storage. Ignore the ominous warning about "All this app's data will be deleted" - as this does not apply to any Pimlical local databases or preference settings (but it DOES clear out the notification sounds, so that on the next launch of Pimlical, the custom sounds you set should now be incorporated into those various channels). You will have to do this every time you change the notification sound, or the change will be ignored. You can also set these sounds by directly updating the CHANNEL specification in the OS panel on notifications for PimlicalApp. However, an uninstall will remove those associations (so it's far better to set them with these preferences as they will then be automatically restored).

ApptNotificationSound - for Android-10specifies the sound to use as the default notification sound for appointments. If the preference FloatNotificationSound is not set, then this sound will also be used for Floating Events and Tasks. See important note above about changing this setting!

FloatNotificationSound - for Android-10specifies the sound to use as the notification sound for Floating Events and Tasks.

SnoozeNotificationSound - for Android-10specifies the sound to use when a prior alarm notification re-triggers after being snoozed in the Android Notification system.

CustomNotificationSound - for Android-10specifies the sound to use as the notification sound for any event that has the Action Tag: CustomNotificationSound set. This overrides the ApptNotificationSound and FloatNotificationSound settings.