Lab Mode and Deployment

The preferences described below are modified by the defaults command in the Terminal application or through 3rd party deployment tools. This documentation specifically describes how to make the changes using the defaults command but the information should be sufficient to use with a deployment tool. You should make these changes while Particulars is not running.

labMode

If you are deploying Particulars in a datacenter or computer lab, you can turn on Lab Mode to help ease your deployment. Lab mode changes the following about Particulars' behavior: it disables the first run experience, the global hotkey for preferences, removes the Dock icon, and enables launch at login. (You still must manually launch Particulars once to have it register to launch at login.) The value is boolean, meaning it will take YES or NO.

defaults write net.glencode.Particulars labMode -bool YES

Setting preferences in labMode

If you enable labMode, the preferences interface is effectively disabled, so you will have to configure following optional preferences in Terminal or through 3rd party deployment tools.

dropShadow

Determines whether the output has a drop shadow behind it. The value is boolean, meaning it will take YES or NO.

defaults write net.glencode.Particulars dropShadow -bool YES

lightDarkText

Particulars has 3 options for the shade of the output. The value is an integer and the options are as follows:

  1. Automatic
  2. Light text
  3. Dark text

The Automatic setting scans your desktop background image to determine what setting to use. If battery life or performance is a concern, use 1 or 2.

defaults write net.glencode.Particulars lightDarkText -int 2

textSize

Sets the text size. The default is 18. The values used in the preferences interface are Small - 12, Medium - 18, Large - 24.

defaults write net.glencode.Particulars textSize -int 24

Quitting in labMode

Since all user interface elements are disabled in labMode, how to quit Particulars is not immediately obvious. If you need to quit Particulars while in labMode, open the Terminal application and enter:

killall Particulars

Advanced Preferences

These additional preferences are available for power users.

detailLevel

In addition to the pre-defined detail levels, it possible to construct a custom detail level. To create a custom detail level, take the numeric value of each particular piece of information in the table below and sum them.

Computer name1
Model identifier2
Model name4
Serial number8
CPU16
RAM32
GPU64
Operating system128
Current user256
Uptime512
Disk free space1024
Primary network interface2048
All active network interfaces4096

For example, to only display Model name, Serial number, CPU, RAM, GPU and Operating system, the total is 252 (4+8+16+32+64+128).

This preference is also available in the Today Extension (Widget).

defaults write net.glencode.Particulars detailLevel -int 252

defaults write net.glencode.Particulars.Widget detailLevel -int 4095

dhcpLeaseRemaining

Particulars shows the DHCP server address and the length of the DHCP lease. Setting this preference, will also show the remaining lease time. The value is boolean, meaning it will take YES or NO.

This preference is also available in the Today Extension (Widget).

defaults write net.glencode.Particulars dhcpLeaseRemaining -bool YES

globalHotkey

While you cannot set the Shortcut to show preferences using the defaults command, you can reset it to the default value. This may be useful if you removed the shortcut, or changed it's value to something you no longer remember.

defaults delete net.glencode.Particulars globalHotkey

ignoreHiding

When Particulars is running with the Dock icon shown, it will be hidden along with all other apps, if you select Hide Others from another application's menu. This preference allows you to keep Particulars visible. The value is boolean, meaning it will take YES or NO.

defaults write net.glencode.Particulars ignoreHiding -bool YES

macAddressFormat

MAC (Media Access Control) addresses are formatted by default with colon separators and in lowercase. There are other MAC address formats available.

NumberNameDescriptionExample
0Plainlowercase, no separators0123456789ab
1Unixlowercase, colon separated01:23:45:67:89:ab
2Ciscolowercase, dot separated0123.4567.89ab
3Windowsuppercase, dash separated01-23-45-67-89-AB

The value is an integer. Values not documented in the table above are ignored and the default is used.

This preference is also available in the Today Extension (Widget).

defaults write net.glencode.Particulars macAddressFormat -int 2

defaults write net.glencode.Particulars.Widget macAddressFormat -int 3

subnetMaskCIDRNotation

Use this preference to have Particulars display subnet masks in the short CIDR (Classless Inter-domain Routing) notation. For example, 255.255.254.0 will show as /23. The value is boolean, meaning it will take YES or NO.

This preference is also available in the Today Extension (Widget).

defaults write net.glencode.Particulars subnetMaskCIDRNotation -bool YES


Help Home