Support Companion v1
SupportCompanion
Support Companion settings
Configuration Keys (33)
| Key | Type | Title |
|---|---|---|
PFC_SegmentedControl_0required | string | — |
BrandNameConfigures the name shown in the navigation menu. | string | Brand Name |
BrandColorConfigures 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 | string | Brand Color |
BrandLogoConfigures the brand logo shown in the apps side menu. Specify a local path or Base64 string. | string | Brand Logo |
SupportUrlConfigures the URL to open when the user clicks on the Get Support button. | string | Support Page URL |
ChangePasswordUrlConfigures the URL to open when the user clicks on the Change Password button. | string | Change Password URL |
ChangePasswordModeConfigures 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) | string | Change Password Mode |
SupportEmailConfigures the email address shown when the user clicks on the Support Info button. | string | Support Email |
SupportPhoneConfigures the phone number shown when the user clicks on the Support Info button. | string | Support Phone |
ShowMenuToggleConfigures whether to show the menu toggle button in the apps side menu. Default: false | boolean | Show Menu Toggle |
HiddenWidgetsConfigures which widgets to hide, available widgets are: DeviceInfo, MunkiPendingApps, MunkiUpdates, IntunePendingApps, IntuneUpdates, Storage, MdmStatus, Actions, Battery, EvergreenInfo. | array | Hidden Widgets |
HiddenActionsConfigures which actions to hide, available actions are: Support, ManagedSoftwareCenter, ChangePassword, Reboot, KillAgent, SoftwareUpdates, GatherLogs. | array | Hidden Actions |
NotificationIntervalConfigures the interval for notifications in hours for Application Updates and Software Updates notifications. Range: 1 – 24 | integer | Notification Interval |
NotificationTitleConfigures the title for notifications for notifications. Defaults to Support Companion if not configured. | string | Notification Title |
NotificationImageConfigures an image to add to notifications. Local path should be specified. | string | Notification Image |
SoftwareUpdateNotificationMessageConfigures the message for notifications for Software Updates notifications. Defaults to "You have software updates available. Take action now! \ud83c\udf89" if not configured. | string | Software Update Notification Message |
SoftwareUpdateNotificationButtonTextConfigures the button text for notifications for Software Updates notifications. Defaults to "Details \ud83d\udc40" if not configured. | string | Software Update Notification Button Text |
AppUpdateNotificationMessageConfigures the message for notifications for App Updates notifications. Defaults to "You have app updates available. Take action now! \ud83c\udf89" if not configured. | string | App Update Notification Message |
AppUpdateNotificationButtonTextConfigures the button text for notifications for App Updates notifications. Defaults to "Details \ud83d\udc40" if not configured. | string | App Update Notification Button Text |
CustomColorsConfigures custom colors for the app, should be specified in hex format, see example below. Do not use BrandColor in conjunction with this key. | array | Custom Colors |
IntuneModeConfigures the app to use Intune for application information. Only supports PKG and DMG type apps, not LOB. Default: false | boolean | Intune Mode |
SystemProfilerAppsConfigures the app to list all applications installed under /Applications and their versions. Useful if Munki or Intune is not used. Default: false | boolean | System Profiler |
LogFoldersConfigures the log folders to gather logs from. Only used when gathering logs. Defaults to "/Library/Logs/Microsoft" if not configured. | array | Log Folders |
ActionsConfigures custom actions to add to the tray menu. See example below. | array | Actions |
ShowDesktopInfoConfigures the desktop info widget. Default: false | boolean | Show Desktop Info |
DesktopPositionConfigures the position of the desktop info. Defaults to TopRight. Default: "TopRight" Range: Top Left (TopLeft), Top Right (TopRight), Bottom Left (BottomLeft), Bottom Right (BottomRight) | string | Desktop Position |
DesktopInfoLevelConfigures the level of information to show on the desktop. Defaults to Full. Range: Full, Minimal, Hardware, Custom | string | Desktop Info Level |
DesktopInfoCustomItemsIf 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. | array | Desktop Info Custom Items |
DesktopInfoBackgroundColorConfigures the background color for the desktop info. Configure using Hex format. Defaults to Transparent | string | Desktop Info Background Color |
DesktopInfoBackgroundOpacityConfigures 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) | real | Desktop Info Background Opacity |
DesktopInfoColorHighlightConfigures whether to highlight the text in the desktop info. Defaults to true. Default: true | boolean | Desktop Info Color Highlight |
DesktopInfoFontSizeConfigures the font size for the desktop info. Defaults to 17. Default: 17 Range: 8 – 24 | integer | Desktop Info Font Size |
CustomWidgetsPathConfigures a path to a JSON file containing custom widgets to show on the Home view. | string | Custom Widgets Path |
| string | — |
| string | — |
| dict | — |
PrimaryColorConfigures the Primary Color for the app. | string | Primary Color |
AccentColorConfigures the Accent Color for the app. | string | Accent Color |
| string | — |
| dict | — |
NameName of the action to show in the menu. | string | Name |
CommandCommand to run when to item is clicked. | string | Command |
IconIcon to show in the Self Service page in the UI. | string | Icon |
| string | — |