PayloadKit

Support Companion v1

SupportCompanion

Support Companion settings

macOS

Configuration Keys (33)

Showing 33 of 33 keys

KeyTypeDescriptionDefaultRange
string—Default: —Range: —
BrandNamestring

Brand Name

stringConfigures the name shown in the navigation menu.Default: —Range: —

Brand Color

stringConfigures the brand color shown in the app, available colors are: Blue, Green, Red, Orange. Defaults to Blue if not configured.Default: —Range: Blue, Green, Red, Orange

Support Page URL

stringConfigures the URL to open when the user clicks on the Get Support button.Default: —Range: —

Change Password URL

stringConfigures the URL to open when the user clicks on the Change Password button.Default: —Range: —

Change Password Mode

stringConfigures the mode for the Change Password button, available modes are: local, SSOExtension, url. Defaults to local if not configured.Default: —Range: Local (local), SSO Extension (SSOExtension), URL (url)

Support Email

stringConfigures the email address shown when the user clicks on the Support Info button.Default: —Range: —

Support Phone

stringConfigures the phone number shown when the user clicks on the Support Info button.Default: —Range: —

Show Menu Toggle

booleanConfigures whether to show the menu toggle button in the apps side menu.Default: falseRange: —

Hidden Widgets

arrayConfigures which widgets to hide, available widgets are: DeviceInfo, MunkiPendingApps, MunkiUpdates, IntunePendingApps, IntuneUpdates, Storage, MdmStatus, Actions, Battery, EvergreenInfo.Default: —Range: —
string
string—Default: —Range: —

Hidden Actions

arrayConfigures which actions to hide, available actions are: Support, ManagedSoftwareCenter, ChangePassword, Reboot, KillAgent, SoftwareUpdates, GatherLogs.Default: —Range: —
string
string—Default: —Range: —

Notification Interval

integerConfigures the interval for notifications in hours for Application Updates and Software Updates notifications.Default: —Range: 1 – 24

Notification Title

stringConfigures the title for notifications for notifications. Defaults to Support Companion if not configured.Default: —Range: —

Notification Image

stringConfigures an image to add to notifications. Local path should be specified.Default: —Range: —

Software Update Notification Message

stringConfigures the message for notifications for Software Updates notifications. Defaults to "You have software updates available. Take action now! \ud83c\udf89" if not configured.Default: —Range: —

Software Update Notification Button Text

stringConfigures the button text for notifications for Software Updates notifications. Defaults to "Details \ud83d\udc40" if not configured.Default: —Range: —

App Update Notification Message

stringConfigures the message for notifications for App Updates notifications. Defaults to "You have app updates available. Take action now! \ud83c\udf89" if not configured.Default: —Range: —

App Update Notification Button Text

stringConfigures the button text for notifications for App Updates notifications. Defaults to "Details \ud83d\udc40" if not configured.Default: —Range: —

Custom Colors

arrayConfigures custom colors for the app, should be specified in hex format, see example below. Do not use BrandColor in conjunction with this key.Default: —Range: —
dict
dict—Default: —Range: —

Primary Color

stringConfigures the Primary Color for the app.Default: —Range: —

Accent Color

stringConfigures the Accent Color for the app.Default: —Range: —
IntuneModeboolean

Intune Mode

booleanConfigures the app to use Intune for application information. Only supports PKG and DMG type apps, not LOB.Default: falseRange: —

System Profiler

booleanConfigures the app to list all applications installed under /Applications and their versions. Useful if Munki or Intune is not used.Default: falseRange: —

Log Folders

arrayConfigures the log folders to gather logs from. Only used when gathering logs. Defaults to "/Library/Logs/Microsoft" if not configured.Default: —Range: —
string
string—Default: —Range: —
Actionsarray

Actions

arrayConfigures custom actions to add to the tray menu. See example below.Default: —Range: —
dict
dict—Default: —Range: —
Namestring

Name

stringName of the action to show in the menu.Default: —Range: —
Commandstring

Command

stringCommand to run when to item is clicked.Default: —Range: —
Iconstring

Icon

stringIcon to show in the Self Service page in the UI.Default: —Range: —

Show Desktop Info

booleanConfigures the desktop info widget.Default: falseRange: —

Desktop Position

stringConfigures the position of the desktop info. Defaults to TopRight.Default: "TopRight"Range: Top Left (TopLeft), Top Right (TopRight), Bottom Left (BottomLeft), Bottom Right (BottomRight)

Desktop Info Level

stringConfigures the level of information to show on the desktop. Defaults to Full.Default: —Range: Full, Minimal, Hardware, Custom

Desktop Info Custom Items

arrayIf DesktopInfoLevel is set to Custom, use this array to determine which information to show. Available info are: HostName, Model, SerialNumber, Processor, IpAddress, MemSize, OsBuild, OsVersion, LastBootTime, StorageInfo, SupportPhone, SupportEmail, Separator.Default: —Range: —
string
string—Default: —Range: —

Desktop Info Background Color

stringConfigures the background color for the desktop info. Configure using Hex format. Defaults to TransparentDefault: —Range: —

Desktop Info Background Opacity

realConfigures the position of the desktop info. Defaults to 100%.Default: 1Range: 10% (0.1), 20% (0.2), 30% (0.3), 40% (0.4), 50% (0.5), 60% (0.6), 70% (0.7), 80% (0.8), 90% (0.9), 100% (1)

Desktop Info Color Highlight

booleanConfigures whether to highlight the text in the desktop info. Defaults to true.Default: trueRange: —

Desktop Info Font Size

integerConfigures the font size for the desktop info. Defaults to 17.Default: 17Range: 8 – 24

Custom Widgets Path

stringConfigures a path to a JSON file containing custom widgets to show on the Home view.Default: —Range: —