PayloadKit

Particulars

net.glencode.Particulars

Particulars settings

macOS

Configuration Keys (39)

KeyTypeTitle
labMode

Lab Mode eases the deployment of Particulars in a computer lab or other mass deployment. See the documentation for more information.

Default: false

booleanLab Mode
showOnDesktop

The default mode of Particulars is to present system information on the desktop. This can be disabled, usually in favor of showing Particulars in the menu bar.

Default: true

booleanShow Particulars on the Desktop
showMenuBarExtra

Adds an item to the macOS menu bar that allows quick access to system information. Secondary-clicking on the menu bar item shows a menu with settings, copying, and other functions.

Default: false

booleanShow Particulars in the Menu Bar
detailLevel

Adjust detail level options. See documentation URL for instructions.

integerDetail Level
preferredDisplay

Sets the display (or monitor) on which Particulars will show desktop system information. If the display is later unavailable, Particulars will default back to the primary display. The value is an integer, taking 2 for the 2nd display, for example.

integerPreferred Display
desktopPosition

Sets the relative position of desktop system information.

Default: 6

Range: Top Left (0), Top Center (1), Top Right (2), Middle Left (3), Middle Center (4), Middle Right (5), Bottom Left (6), Bottom Center (7), Bottom Right (8)

integerDesktop Position
desktopMargin

When displaying system information on the desktop, Particulars uses all available screen size, inset by a default margin of 21pt. Margins can be adjusted.

Default: 21

integerDesktop Margin
desktopTopMargin

Overrides desktopMargin for the top desktop margin

integerDesktop Top Margin
desktopBottomMargin

Overrides desktopMargin for the bottom desktop margin

integerDesktop Bottom Margin
desktopLeftMargin

Overrides desktopMargin for the left desktop margin

integerDesktop Left Margin
desktopRightMargin

Overrides desktopMargin for the right desktop margin

integerDesktop Right Margin
textTheme

Sets the theme of desktop system information. Each theme has a corresponding number.

Default: 1

Range: System (1), Classic (Lato) (0), Mono (2), Custom (255)

integerText Theme
lightDarkText

Particulars has 3 options for the shade of the desktop system information: automatic, light text, or dark text. The automatic setting scans the current desktop picture to determine what setting to use. If battery life or performance is a concern, use light or dark.

Default: 1

Range: Automatic (0), Light text (default) (1), Dark text (2)

integerLight or Dark Text
textSize

Sets the preferred text size for the desktop system information in points. The default is 18. Values between 12 and 24 are typical. (Value may be scaled down to fit.)

Default: 18

integerText Size
dropShadow

Determines whether the desktop system information has a drop shadow behind it.

Default: true

booleanDrop Shadow
labelCase

Sets the letter case of the labels. Each case option has a corresponding number.

Default: 1

Range: Unaltered (0), lower (default) (1), UPPER (2)

integerLabel Case
menuBarWidgetAppearance

Sets the appearance of the menu bar widget.

Default: 0

Range: System appearance (default) (0), Vibrant Light (1), Vibrant Dark (2), Light (3), Dark (4)

integerMenu Bar Widget Appearance
menuBarWidgetTextSize

Sets the preferred text size in the menu bar widget in points. The default is 12. Values below 9 and above 24 are ignored. (Value may be scaled down to fit.)

Default: 12

integerMenu Bar Widget Text Size
detachableMenuBarWidget

Allows the menu bar widget to be drug away from the menu bar and appear in a floating window.

Default: true

booleanDetachable Menu Bar Widget
menuBarIcon

Specifies an alternative menu bar icon. Valid values are: classic, quatrefoil, quatrefoil.fill, and any valid SF Symbol.

Default: "classic"

stringMenu Bar Icon
allNetworkInterfaces

When enabled in the detail level, Particulars displays information about the primary active network interface. This setting expands that to include information about all active network interfaces.

Default: false

booleanShow All Active Network Interfaces
dhcpLeaseRemaining

In the default network information, Particulars shows the DHCP server address and the length of the DHCP lease. This setting adds the remaining lease time.

Default: false

booleanShow DHCP Lease Time Remaining
macAddressFormat

By default, MAC (Media Access Control) addresses are formatted with colon separators and in lowercase. Use this setting to select another MAC address format.

Default: 1

Range: Plain (example: 0123456789ab) (0), Unix (default, example: 01:23:45:67:89:ab) (1), Cisco (example: 0123.4567.89ab) (2), Windows/IEEE (example: 01-23-45-67-89-AB) (3)

integerMAC Address Format
networkDetailLevel

By default, all network information is displayed except the Wi-Fi SSID. It is possible to construct a custom set of network information. Use this preference to create a custom network detail level. See documentation URL for instructions.

integerNetwork Detail Level
networkNotifications

When enabled, Particulars will post system notifications when it detects a change in the primary IPv4 address or the public IP address. Notifications are also governed by settings in the Notifications pane of System Settings.

Default: false

booleanNetwork Notifications
subnetMaskCIDRNotation

This setting displays subnet masks in the short CIDR (Classless Inter-domain Routing) notation. For example, 255.255.254.0 will show as /23.

Default: false

booleanUse CIDR Notation for Subnet Mask
explicitNoNetworkConfiguration

Displays an error message if no active network interfaces are found (assuming network is enabled in 'detailLevel').

Default: false

booleanExplicit No Networks Detected message
appStoreVersionCheck

Particulars checks for new Particulars versions in the Mac App Store. This check can be disabled.

Default: true

booleanChecking for new version in the Mac App Store
coreCount

Adds a count of CPU cores to the CPU particular. Changing this setting requires a restart of the application to take effect.

Default: false

booleanCPU Core Count
dateFormat

This modifies the format of the date and time for the Boot Time particular. Follows a Unicode standard https://www.unicode.org/reports/tr35/tr35-31/tr35-dates.html#Date_Format_Patterns

stringDate Format
disableCrashManager

Organizations can disable all reporting of crashes to the developer by setting this to true using Managed Preferences.

Default: false

booleanDisable Crash Manager
diskFreeSpace

Free/available disk space can be displayed in multiple ways. See documentation URL for options.

Default: 0

Range: Free (0), All available (including purgeable) (1), Free and purgeable (2)

integerDisk Free Space Format
diskFreeSpaceNonBootVolumes

By default, Particulars only shows disk space for the boot disk. Enable this setting to show disk space for other disks.

Default: false

booleanShow Disk Free Space for Non-Boot Volumes
firstRunDone

On first run, Particulars displays a welcome window that describes how it runs on the desktop and then hides all other apps and opens the settings window. To skip this first run experience, enable this setting. (Enabling labMode implies this setting.)

Default: false

booleanSkip the First Run Experience
headerText

Header text is displayed in a separate paragraph above all particulars. Any leading or trailing whitespace is removed when displayed.

stringHeader
footerText

Footer text is displayed in a separate paragraph below all particulars. Any leading or trailing whitespace is removed when displayed.

stringFooter
hideDockIcon

Enabling this setting removes Particulars from the macOS Dock. Changing this setting while Particulars is running will automatically restart Particulars and open the Settings window.

Default: false

booleanHide Dock Icon
ignoreHiding

When Particulars is running with the Dock icon shown, it will be hidden along with all other apps when you select Hide Others from another application's menu. This preference allows you to keep Particulars visible.

Default: false

booleanIgnore Hiding
operatingSystemVersionName

This setting adds the operating system version's marketing name (e.g., Big Sur, Catalina, etc) to the Operating System particular.

Default: false

booleanOperating System Version Name