DDM OS Reminder

org.churchofjesuschrist.dorm

Configures DDM OS Reminder message preferences

macOS

Configuration Keys (36)

Key	Type	Title	Description	Default	Range
`ScriptLog`	string	Script Log Path	Path to the log file for the DDM reminder script.	"/var/log/org.churchofjesuschrist.log"	—
`DaysBeforeDeadlineDisplayReminder`	integer	Days Before Deadline: Display Reminder	Number of days before the deadline when reminders start being displayed.	60	—
`DaysBeforeDeadlineBlurscreen`	integer	Days Before Deadline: Blur Screen	Number of days before the deadline when blur-screen enforcement starts.	45	—
`DaysBeforeDeadlineHidingButton2`	integer	Days Before Deadline: Hide Defer Button	Number of days before the deadline when the secondary button is hidden.	21	—
`DaysOfExcessiveUptimeWarning`	integer	Days of Excessive Uptime Warning	Number of days of excessive uptime before warning the user.	0	—
`DaysPastDeadlineRestartWorkflow`	integer	Days Past Deadline: Restart Workflow	Number of days past deadline before activating restart workflow behavior.	2	—
`PastDeadlineRestartBehavior`	string	Past Deadline Restart Behavior	Controls restart workflow behavior after deadline. Valid values: Off \| Prompt \| Force.	"Off"
`MinimumDiskFreePercentage`	integer	Minimum Disk Free Percentage	Percent of free disk space required before warning the user.	99	—
`MeetingDelay`	integer	Meeting Delay (Minutes)	Delay in minutes before enforcing reminders around meetings.	75	—
`AcceptableAssertionApplicationNames`	string	Acceptable Assertion Application Names	Space-delimited list of application name substrings used to allowlist display sleep assertions; matching assertions defer reminders up to the Meeting Delay.	"MSTeams zoom.us Webex"	—
`OrganizationOverlayIconURL`	string	Organization Overlay Icon URL	URL to the organization overlay icon image.	"https://use2.ics.services.jamfcloud.com/icon/hash_2d64ce7f0042ad68234a2515211adb067ad6714703dd8ebd6f33c1ab30354b1d"	—
`OrganizationOverlayIconURLdark`	string	Organization Overlay Icon URL (Dark Mode)	URL to the organization overlay icon image used when the interface is in Dark Mode. Falls back to OrganizationOverlayIconURL when unset.	"https://use2.ics.services.jamfcloud.com/icon/hash_d3a3bc5e06d2db5f9697f9b4fa095bfecb2dc0d22c71aadea525eb38ff981d39"	—
`SwapOverlayAndLogo`	boolean	Swap Overlay And Logo	Whether to swap the overlay icon and primary logo positions.	false	—
`DateFormatDeadlineHumanReadable`	string	Deadline Date Format (Human Readable)	strftime format string used to render the deadline date for users.	"+%a, %d-%b-%Y, %-l:%M %p"	—
`SupportTeamName`	string	Support Team Name	Display name of the support team.	"IT Support"	—
`SupportTeamPhone`	string	Support Team Phone	Phone number for support.	"+1 (801) 555-1212"	—
`SupportTeamEmail`	string	Support Team Email	Email address for support.	"rescue@domain.org"	—
`SupportTeamWebsite`	string	Support Team Website	Website URL for support.	"https://support.domain.org"	—
`SupportKB`	string	Support KB Identifier	Knowledge base article identifier.	"Update macOS on Mac"	—
`InfoButtonAction`	string	Info Button Action URL	URL opened when the info button is clicked.	"https://support.apple.com/108382"	—
`SupportKBURL`	string	Support KB Markdown Link	Markdown-formatted link to the support knowledge base article.	"[Update macOS on Mac](https://support.apple.com/108382)"	—
`SupportAssistanceMessage`	string	Support Assistance Message	Optional support sentence appended to message body.	"<br><br>For assistance, please contact {supportTeamName} by clicking the (?) button in the bottom right-hand corner."	—
`Title`	string	Dialog Title	Title text displayed at the top of the DDM dialog.	"macOS {titleMessageUpdateOrUpgrade} Required"	—
`Button1Text`	string	Primary Button Text	Label for the primary action button.	"Open Software Update"	—
`Button2Text`	string	Secondary Button Text	Label for the secondary (remind later) button.	"Remind Me Later"	—
`InfoButtonText`	string	Info Button Text	Label for the info button.	"Update macOS on Mac"	—
`ExcessiveUptimeWarningMessage`	string	Excessive Uptime Warning Message	Markdown-formatted text displayed in the dialog.	"<br><br>Note: Your Mac has been powered-on for {uptimeHumanReadable}. For more reliable results, please manually restart your Mac before proceeding."	—
`DiskSpaceWarningMessage`	string	Disk Space Warning Message	Markdown-formatted text displayed in the dialog.	"<br><br>Note: Your Mac has only {diskSpaceHumanReadable}, which may prevent this macOS {titleMessageUpdateOrUpgrade:l}."	—
`StagedUpdateMessage`	string	Staged Update Message	Markdown-formatted message displayed when the update is fully staged (downloaded and ready).	"<br><br>Good news! The macOS {ddmVersionString} update has already been downloaded to your Mac and is ready to install. Installation will proceed quickly when you click {button1text}."	—
`PartiallyStagedUpdateMessage`	string	Partially Staged Update Message	Markdown-formatted message displayed when the update is partially staged (preparing).	"<br><br>Your Mac has begun downloading and preparing required macOS update components. Installation will be quicker once all assets have finished staging."	—
`PendingDownloadMessage`	string	Pending Download Message	Markdown-formatted message displayed when the update download is pending.	"<br><br>Your Mac will begin downloading the update shortly."	—
`HideStagedUpdateInfo`	boolean	Hide Staged Update Info	Whether to hide staged update information (e.g., staged/partial/pending messages) in the UI.	false	—
`Message`	string	Dialog Message	Markdown-formatted message body displayed in the dialog.	"A required macOS {titleMessageUpdateOrUpgrade:l} is now available<br><br>Happy {weekday}, {loggedInUserFirstname}!<br><br>Please {titleMessageUpdateOrUpgrade:l} to macOS {ddmVersionString} to ensure your Mac remains secure and compliant with organizational policies.{updateReadyMessage}<br><br>To perform the {titleMessageUpdateOrUpgrade:l} now, click {button1text}, review the on-screen instructions, then click {softwareUpdateButtonText}.<br><br>If you are unable to perform this {titleMessageUpdateOrUpgrade:l} now, click {button2text} to be reminded again later (which is disabled when the deadline is imminent).<br><br>{deadlineEnforcementMessage}{excessiveUptimeWarningMessage}{diskSpaceWarningMessage}{supportAssistanceMessage}"	—
`InfoBox`	string	Info Box Content	Markdown-formatted info box content showing current and required versions and deadline.	"Current: macOS {installedmacOSVersion}<br><br>Required: macOS {ddmVersionString}<br><br>Deadline: {infoboxDeadlineDisplay}<br><br>Day(s) Remaining: {infoboxDaysRemainingDisplay}<br><br>Last Restart: {infoboxLastRestartDisplay}<br><br>Free Disk Space: {diskSpaceHumanReadable}"	—
`HelpMessage`	string	Help Message	Markdown-formatted help text including support, user, and computer information.	"For assistance, please contact: {supportTeamName}<br>- Telephone: {supportTeamPhone}<br>- Email: {supportTeamEmail}<br>- Website: {supportTeamWebsite}<br>- Knowledge Base Article: {supportKBURL}<br><br>User Information:<br>- Full Name: {userfullname}<br>- User Name: {username}<br><br>Computer Information:<br>- Computer Name: {computername}<br>- Serial Number: {serialnumber}<br>- macOS: {osversion}<br><br>Script Information:<br>- Dialog: {dialogVersion}<br>- Script: {scriptVersion}<br>"	—
`HelpImage`	string	Help Image	Help image configuration, such as QR code pointing to the info button action.	"qr={infobuttonaction}"	—