The topic of this article may not meet Wikipedia's general notability guideline. (December 2016) (Learn how and when to remove this template message)
This article relies too much on references to primary sources. (December 2016) (Learn how and when to remove this template message)
defaults is a command line utility that manipulates plist files. defaults is present in the macOS and GNUstep operating systems, and first appeared in the NeXTSTEP operating system upon which both aforementioned systems are based. The system stores each user's preferences set in a .plist file for each program stored at ~/Library/Preferences for user-specific preferences, and /Library/Preferences/ for global preferences. defaults writes to or reads from these plist files depending on the domain given.
An advantage of the defaults system is its ability to store data in a variety of formats: integer, character string, floating point, binary data, dates, so-called dictionaries, or arrays of the same.
Previous versions also offered the opportunity of direct disk access.[clarification needed]
Common uses of defaults:
$ defaults read DOMAIN # gets all $ defaults read DOMAIN PROPERTY_NAME # gets $ defaults write DOMAIN PROPERTY_NAME $VALUE # sets $ defaults delete DOMAIN PROPERTY_NAME # resets a property $ defaults delete DOMAIN # resets preferences
DOMAIN should be replaced by the plist file sans extension ('.plist'). plist files are named with reverse domain name notation. For example:
$ defaults read com.apple.iTunes # prints all iTunes preference values
$ defaults write com.apple.Safari AddressBarIncludesGoogle 0
$ defaults write com.apple.Safari AddressBarIncludesGoogle -bool NO # case-sensitive!
Replacing 0 with 1 or NO with YES or FALSE with TRUE returns the search bar to normal.
Preferences can at times corrupt applications. To reset Address Book's preferences, either the file ~/Library/Preferences/com.apple.AddressBook.plist must be removed or the following command issued:
$ defaults delete com.apple.AddressBook
Some example settings configurable with defaults.
|Domain||Value||OSX Version||Legal Values||Default Values|
|NSGlobalDomain||AppleHighlightColor||10.8||3 floats range 0-1.0||"0.780400 0.815700 0.858800"|
|NSGlobalDomain||AppleShowScrollBars||10.8||Automatic, WhenScrolling, Always||Automatic|
|NSGlobalDomain||NSWindowResizeTime||10.8||float:time in seconds||.2|
- NSUserDefaults documentation Apple Inc
|This Macintosh-related article is a stub. You can help Wikipedia by expanding it.|