Support Companion
com.github.macadmins.SupportCompanion
Support Companion settings
Configuration Keys (49)
| Key | Type | Title |
|---|---|---|
PFC_SegmentedControl_0required | string | — |
KnowledgeBaseUrlIf configured, a menu item "Knowledge base" will show up where the user can browse the page from the UI. | string | Knowledge Base Url |
MenuShowIdentityConfigures whether to show the Identity menu item. Defaults to true Default: true | boolean | Show Identity Menu Item |
MenuShowAppsConfigures whether to show the Apps menu item. Defaults to true Default: true | boolean | Show Apps Menu Item |
MenuShowSelfServiceConfigures whether to show the Self Service menu item. Defaults to true Default: true | boolean | Show Self Service Menu Item |
MenuShowCompanyPortalConfigures whether to show the Company Portal menu item. Defaults to true Default: true | boolean | Show Company Portal Menu Item |
MenuShowKnowledgeBaseConfigures whether to show the Knowledge Base menu item. Defaults to true Default: true | boolean | Show Knowledge Base Menu Item |
BrandNameConfigures the name shown in the navigation menu. | string | Brand Name |
AccentColorConfigures the brand color shown in the app, specify in hex format. | string | Accent Color |
BrandLogoConfigures the brand logo shown in the apps side menu. Specify a Base64 string. | string | Brand Logo |
BrandLogoLightConfigures the brand logo shown in the apps side menu when light theme is used. Specify a base64 string | string | Brand Logo Light |
SupportPageUrlConfigures 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 |
HiddenCardsConfigures which cards to hide, available cards are: DeviceInformation, Evergreen, Battery, Actions, ApplicationInstallProgress, Storage, DeviceManagement, PendingAppUpdates. | array | Hidden Cards |
HiddenActionsConfigures which actions to hide, available actions are: ChangePassword, Reboot, OpenManagementApp, GetSupport, GatherLogs, SoftwareUpdates, RestartIntuneAgent. | 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 "Software Updates Available. Please update your device to the latest version." if not configured. Default: "Software Updates Available. Please update your device to the latest version." | string | Software Update Notification Message |
SoftwareUpdateNotificationButtonTextConfigures the button text for notifications for Software Updates notifications. Defaults to "Update Now 🚀" if not configured. Default: "Update Now 🚀" | string | Software Update Notification Button Text |
AppUpdateNotificationMessageConfigures the message for notifications for App Updates notifications. Defaults to "App Updates Available. Please update your apps to the latest version." if not configured. Default: "App Updates Available. Please update your apps to the latest version." | string | App Update Notification Message |
AppUpdateNotificationButtonTextConfigures the button text for notifications for App Updates notifications. Defaults to "Update Now 🚀" if not configured. Default: "Update Now 🚀" | string | App Update Notification Button Text |
ModeConfigures the app to show application info for either Munki, Intune or to use System profiler for app info. The app tries to dynamically detect which mode to use. Range: Munki, Intune, SystemProfiler | string | Mode |
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 |
DesktopInfoWindowPositionConfigures the position of the desktop info. Defaults to Lower Right. Default: "LowerRight" Range: Upper Left (UpperLeft), Upper Right (UpperRight), Lower Left (LowerLeft), Lower Right (LowerRight) | string | Desktop Position |
DesktopInfoLevelConfigures the level of information to show on the desktop. Defaults to 4. Range: 1, 2, 3, 4, 5 | integer | Desktop Info Level |
DesktopInfoHideItemsUse this array to determine which information to hide. Available items are: HostName, Model, SerialNumber, Processor, IPAddress, Memory, OSBuild, OSVersion, LastRestart, FileVault, StorageName, SupportPhone, SupportEmail. It is also possible to hide entire sections: Hardware Specifications, System Information, Network Information, Storage, Support. | array | Desktop Info Hide Items |
DesktopInfoBackgroundOpacityConfigures the opacity of the desktop info. Defaults to 0%. 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 |
DesktopInfoBackgroundFrostedEnables a frosted glass look on the desktop info when set to true. | boolean | Desktop Info Background Frosted |
DesktopInfoFontSizeConfigures the font size for the desktop info. Defaults to 14. Default: 14 Range: 8 – 24 | integer | Desktop Info Font Size |
CustomCardPathConfigures a path to a JSON file containing custom widgets to show on the Home view. | string | Custom Card Path |
EnableElevationWhen set to true allows the user to elevate to admin during a set time frame. Defaults to false. Default: false | boolean | Enable Elevation |
RequireResonForElevationRequires the user to enter a reason for the elevation. Defaults to false. Default: false | boolean | Require Reason For Elevation |
ReasonMinLengthSet a minimum amount of characters the user must enter as the reason. Defaults to 10. Default: 10 | integer | Reason Min Length |
MaxElevationTimeThe amount of time (in minutes) the user is elevated. Defaults to 5. Default: 5 | integer | Max Elevation Time |
ElevationWebhookUrlWhen configured, sends the entered elevation reason to a webhook instead of saving to disk. | string | Elevation Webhook Url |
ShowElevateTrayCardConfigure wether to show the elevate button in the tray menu or not. Defaults to false. Default: false | boolean | Show Elevate Tray Card |
ElevationSeverityConfigure the elevation severity. Defaults to 6 (Informational). Default: 6 | integer | Elevation Severity |
MarkdownFilePathConfigure a path to a Markdown file to show in the menu. | string | Markdown File Path |
MarkdownMenuLabelConfigure the menu label for the custom Markdown view. | string | Markdown Menu Label |
MarkdownMenuIconConfigure the icon for the custom Markdown menu item. | string | Markdown Menu Icon |
CustomCardsMenuLabelConfigure the menu label for the custom cards view. | string | Custom Cards Menu Label |
CustomCardsMenuIconConfigure the icon for the custom cards menu item. | string | Custom Cards Menu Icon |
RequirePrivilegedActionAuthenticationDisables the requirement for the user to enter their credentials when running privileged actions via the CLI. Default: true | boolean | Require Privileged Action Authentication |
| string | — |
| string | — |
| string | — |
| dict | — |
NameName of the action to show in the menu. | string | Name |
CommandCommand to run when to item is clicked. | string | Command |
IconSF Symbol to show in the Self Service page in the UI. | string | Icon |
IsPrivilegedSF Symbol to show in the Self Service page in the UI. | boolean | Is Privileged |
DescriptionDescription to show in the Self Service page in the UI. | string | Description |
ButtonLabelConfigures the button label for the action. | string | Button Label |
Range: Host Name (HostName), Model (Model), Serial Number (SerialNumber), Processor (Processor), IP Address (IPAddress), Memory (Memory), OS Build (OSBuild), OS Version (OSVersion), Last Restart (LastRestart), FileVault (FileVault), Storage Name (StorageName), Support Phone (SupportPhone), Support Email (SupportEmail), Hardware Specifications (Hardware Specifications), System Information (System Information), Network Information (Network Information), Storage (Storage), Support (Support), Category (Category), Divider (Divider) | string | — |