PayloadKit

Support Companion v1

SupportCompanion

Support Companion settings

macOS

Configuration Keys (33)

KeyTypeTitle
PFC_SegmentedControl_0required
string
BrandName

Configures the name shown in the navigation menu.

stringBrand Name
BrandColor

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

Range: Blue, Green, Red, Orange

stringBrand Color
BrandLogo

Configures the brand logo shown in the apps side menu. Specify a local path or Base64 string.

stringBrand Logo
SupportUrl

Configures the URL to open when the user clicks on the Get Support button.

stringSupport Page URL
ChangePasswordUrl

Configures the URL to open when the user clicks on the Change Password button.

stringChange Password URL
ChangePasswordMode

Configures the mode for the Change Password button, available modes are: local, SSOExtension, url. Defaults to local if not configured.

Range: Local (local), SSO Extension (SSOExtension), URL (url)

stringChange Password Mode
SupportEmail

Configures the email address shown when the user clicks on the Support Info button.

stringSupport Email
SupportPhone

Configures the phone number shown when the user clicks on the Support Info button.

stringSupport Phone
ShowMenuToggle

Configures whether to show the menu toggle button in the apps side menu.

Default: false

booleanShow Menu Toggle
HiddenWidgets

Configures which widgets to hide, available widgets are: DeviceInfo, MunkiPendingApps, MunkiUpdates, IntunePendingApps, IntuneUpdates, Storage, MdmStatus, Actions, Battery, EvergreenInfo.

arrayHidden Widgets
HiddenActions

Configures which actions to hide, available actions are: Support, ManagedSoftwareCenter, ChangePassword, Reboot, KillAgent, SoftwareUpdates, GatherLogs.

arrayHidden Actions
NotificationInterval

Configures the interval for notifications in hours for Application Updates and Software Updates notifications.

Range: 1 – 24

integerNotification Interval
NotificationTitle

Configures the title for notifications for notifications. Defaults to Support Companion if not configured.

stringNotification Title
NotificationImage

Configures an image to add to notifications. Local path should be specified.

stringNotification Image
SoftwareUpdateNotificationMessage

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

stringSoftware Update Notification Message
SoftwareUpdateNotificationButtonText

Configures the button text for notifications for Software Updates notifications. Defaults to "Details \ud83d\udc40" if not configured.

stringSoftware Update Notification Button Text
AppUpdateNotificationMessage

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

stringApp Update Notification Message
AppUpdateNotificationButtonText

Configures the button text for notifications for App Updates notifications. Defaults to "Details \ud83d\udc40" if not configured.

stringApp Update Notification Button Text
CustomColors

Configures custom colors for the app, should be specified in hex format, see example below. Do not use BrandColor in conjunction with this key.

arrayCustom Colors
IntuneMode

Configures the app to use Intune for application information. Only supports PKG and DMG type apps, not LOB.

Default: false

booleanIntune Mode
SystemProfilerApps

Configures the app to list all applications installed under /Applications and their versions. Useful if Munki or Intune is not used.

Default: false

booleanSystem Profiler
LogFolders

Configures the log folders to gather logs from. Only used when gathering logs. Defaults to "/Library/Logs/Microsoft" if not configured.

arrayLog Folders
Actions

Configures custom actions to add to the tray menu. See example below.

arrayActions
ShowDesktopInfo

Configures the desktop info widget.

Default: false

booleanShow Desktop Info
DesktopPosition

Configures the position of the desktop info. Defaults to TopRight.

Default: "TopRight"

Range: Top Left (TopLeft), Top Right (TopRight), Bottom Left (BottomLeft), Bottom Right (BottomRight)

stringDesktop Position
DesktopInfoLevel

Configures the level of information to show on the desktop. Defaults to Full.

Range: Full, Minimal, Hardware, Custom

stringDesktop Info Level
DesktopInfoCustomItems

If 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.

arrayDesktop Info Custom Items
DesktopInfoBackgroundColor

Configures the background color for the desktop info. Configure using Hex format. Defaults to Transparent

stringDesktop Info Background Color
DesktopInfoBackgroundOpacity

Configures the position of the desktop info. Defaults to 100%.

Default: 1

Range: 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)

realDesktop Info Background Opacity
DesktopInfoColorHighlight

Configures whether to highlight the text in the desktop info. Defaults to true.

Default: true

booleanDesktop Info Color Highlight
DesktopInfoFontSize

Configures the font size for the desktop info. Defaults to 17.

Default: 17

Range: 8 – 24

integerDesktop Info Font Size
CustomWidgetsPath

Configures a path to a JSON file containing custom widgets to show on the Home view.

stringCustom Widgets Path
string
string
dict
PrimaryColor

Configures the Primary Color for the app.

stringPrimary Color
AccentColor

Configures the Accent Color for the app.

stringAccent Color
string
dict
Name

Name of the action to show in the menu.

stringName
Command

Command to run when to item is clicked.

stringCommand
Icon

Icon to show in the Self Service page in the UI.

stringIcon
string