Name

defaults

Synopsis

defaults [-currentHost | -host name] command
                  

Modifies the defaults system. When you customize your Mac using the System Preferences, all of those changes and settings are stored in the defaults system. Everything that you’ve done to make your Mac your own is stored as XML data in the form of a property list (or plist). This property list is, in turn, stored in ~/Library/Preferences.

Every time you change one of those settings, that particular property list is updated. For the initiated, there are two other ways to alter the property lists. The first is by using the Property List Editor application (/Developer/Applications) and the other is by using the defaults command in the Terminal. Whether you use System Preferences, Property List Editor, or the defaults command, any changes you make affect the current user.

Options

-currentHost

Performs operations on the local machine.

-host name

Performs operations on the specified host.

Commands

read

Prints out all of your current settings.

read domain

Prints out your settings for the specified domain, such as com.apple.dock.

read domain key

Prints out the value of the specified key. For example, to see the current Dock orientation, use:

defaults read com.apple.dock orientation
read-type domain key

Prints out the data type of the specified key. For example, defaults read-type com.apple.dock orientation tells you that the type of the orientation key is string.

write domain key value

Writes a value to the specified key. ...

Get Mac OS X in a Nutshell now with the O’Reilly learning platform.

O’Reilly members experience books, live events, courses curated by job role, and more from O’Reilly and nearly 200 top publishers.