PayloadKit

Particulars

net.glencode.Particulars

Particulars settings

macOS

Configuration Keys (39)

Showing 39 of 39 keys

KeyTypeDescriptionDefaultRange
labModeboolean

Lab Mode

booleanLab Mode eases the deployment of Particulars in a computer lab or other mass deployment. See the documentation for more information.Default: falseRange: —

Show Particulars on the Desktop

booleanThe 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: trueRange: —

Show Particulars in the Menu Bar

booleanAdds 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: falseRange: —

Detail Level

integerAdjust detail level options. See documentation URL for instructions.Default: —Range: —

Preferred Display

integerSets 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.Default: —Range: —

Desktop Position

integerSets the relative position of desktop system information.Default: 6Range: 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)

Desktop Margin

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

Desktop Top Margin

integerOverrides desktopMargin for the top desktop marginDefault: —Range: —

Desktop Bottom Margin

integerOverrides desktopMargin for the bottom desktop marginDefault: —Range: —

Desktop Left Margin

integerOverrides desktopMargin for the left desktop marginDefault: —Range: —

Desktop Right Margin

integerOverrides desktopMargin for the right desktop marginDefault: —Range: —
textThemeinteger

Text Theme

integerSets the theme of desktop system information. Each theme has a corresponding number.Default: 1Range: System (1), Classic (Lato) (0), Mono (2), Custom (255)

Light or Dark Text

integerParticulars 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: 1Range: Automatic (0), Light text (default) (1), Dark text (2)
textSizeinteger

Text Size

integerSets 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: 18Range: —
dropShadowboolean

Drop Shadow

booleanDetermines whether the desktop system information has a drop shadow behind it.Default: trueRange: —
labelCaseinteger

Label Case

integerSets the letter case of the labels. Each case option has a corresponding number.Default: 1Range: Unaltered (0), lower (default) (1), UPPER (2)

Detachable Menu Bar Widget

booleanAllows the menu bar widget to be drug away from the menu bar and appear in a floating window.Default: trueRange: —

Show All Active Network Interfaces

booleanWhen 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: falseRange: —

Show DHCP Lease Time Remaining

booleanIn 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: falseRange: —

MAC Address Format

integerBy default, MAC (Media Access Control) addresses are formatted with colon separators and in lowercase. Use this setting to select another MAC address format.Default: 1Range: 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)

Network Detail Level

integerBy 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.Default: —Range: —

Network Notifications

booleanWhen 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: falseRange: —

Use CIDR Notation for Subnet Mask

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

Explicit No Networks Detected message

booleanDisplays an error message if no active network interfaces are found (assuming network is enabled in 'detailLevel').Default: falseRange: —

Checking for new version in the Mac App Store

booleanParticulars checks for new Particulars versions in the Mac App Store. This check can be disabled.Default: trueRange: —
coreCountboolean

CPU Core Count

booleanAdds a count of CPU cores to the CPU particular. Changing this setting requires a restart of the application to take effect.Default: falseRange: —

Date Format

stringThis 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_PatternsDefault: —Range: —

Disable Crash Manager

booleanOrganizations can disable all reporting of crashes to the developer by setting this to true using Managed Preferences.Default: falseRange: —

Disk Free Space Format

integerFree/available disk space can be displayed in multiple ways. See documentation URL for options.Default: 0Range: Free (0), All available (including purgeable) (1), Free and purgeable (2)

Show Disk Free Space for Non-Boot Volumes

booleanBy default, Particulars only shows disk space for the boot disk. Enable this setting to show disk space for other disks.Default: falseRange: —

Skip the First Run Experience

booleanOn 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: falseRange: —

Header

stringHeader text is displayed in a separate paragraph above all particulars. Any leading or trailing whitespace is removed when displayed.Default: —Range: —

Footer

stringFooter text is displayed in a separate paragraph below all particulars. Any leading or trailing whitespace is removed when displayed.Default: —Range: —

Hide Dock Icon

booleanEnabling 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: falseRange: —

Ignore Hiding

booleanWhen 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: falseRange: —

Operating System Version Name

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