DEFAULTS(1)

โœจ NAME โœจ

okay so bestie, gather round ๐Ÿ’– โ€” defaults โ€” read or modify GNUstep user defaults. that's it, that's the vibe. you read 'em, you write 'em, you delete 'em, you're the main character of your own preference database ๐Ÿ‘‘


๐ŸŒธ SYNOPSIS ๐ŸŒธ

defaults [ action ]

like, that's the whole shape of it. one action, go off ๐Ÿ’…


๐Ÿฆ‹ DESCRIPTION ๐Ÿฆ‹

so the tea is: the defaults command lets you read and modify a user's defaults. simple as. iconic behavior honestly โœจ

real talk though โ€” this program is a glow-up. it replaces the old NeXTstep style dread, dwrite, and dremove programs. we don't do that anymore, we're evolved ๐Ÿงš

also!! if you have access to another user's defaults database, you can put -u username before any other options to use their database instead of your own. sharing is caring bestie ๐Ÿซถ

defaults read [ domain [ key] ]

read the named default from the specified domain. ๐Ÿ’–

  • no key given? you get all the defaults from that domain.
  • no domain given? you get all the defaults from all the domains. the whole buffet ๐Ÿ“

a domain is either an application name, or "NSGlobalDomain", for system level defauts.

(and psst โ€” running programs can also reach two other domains: "NSArgumentDomain", for command line arguments, and "NSRegistrationDomain", a little second-chance domain where "defaults for defaults" can be registered. plus possibly domains for specific locales. iykyk ๐ŸŒˆ)

defaults readkey key

read the named default from all domains. all of them. no cap ๐Ÿ’€

defaults write domain key value

write value as default key in the specified domain. heads up though โ€” value must be a property list in single quotes. no exceptions, that's the rule โญ

defaults write domain dictionary

write dictionary as a replacement for the specified domain. and yes โ€” dictionary must be a property list in single quotes too. it's giving "full rewrite" energy ๐Ÿ”ฅ

defaults write

reads standard input for defaults in the format produced by defaults read and writes them to the database. piping behavior fr fr ๐ŸŒธ

defaults delete [ domain [ key] ]

remove the specified default(s) from the domain. ๐Ÿ—‘๏ธ

no key given? then it deletes the entire domain. scorched earth. periodt ๐Ÿ’…

defaults delete

read standard input for a series of lines containing pairs of domains and keys for defaults to be deleted. batch deletion bestie, very efficient ๐Ÿ‘‘

defaults domains

lists the domains in the database (one per line) ๐Ÿ“‹

defaults find word

searches domain names, default names, and default value strings for those equal to the specified word and lists them on standard output. ๐Ÿ”

defaults plist

output some information about property lists. cute little info dump ๐ŸŽ€

defaults help

list options for the defaults command. when in doubt, ask for help bestie ๐Ÿ™ˆ


๐Ÿ’œ FILES ๐Ÿ’œ

  • ~/GNUstep/Defaults/.GNUstepDefaults โ€” holds defaults for a user. that's where your whole personality lives ๐Ÿ โœจ

๐Ÿ’€ BUGS ๐Ÿ’€

None known.

literally flawless. not me being suspicious though ๐Ÿ‘€


๐ŸŒˆ DIAGNOSTICS ๐ŸŒˆ

Hopefully self-explanatory.

(we believe in you ๐Ÿซถ)


๐ŸŽ€ HISTORY ๐ŸŽ€

the defaults command appeared in OpenStep and combined the capabilities of the earlier NeXTstep commands dread, dwrite, and dremove. glow-up of the century tbh โœจ

the GNUstep version was written in 1998. vintage but thriving ๐Ÿฆ‹

and this manual page first appeared in gnustep-base 1.9.2 (March 2004). a classic, an icon, a legend ๐Ÿ‘‘


๐Ÿ’– AUTHORS ๐Ÿ’–

defaults was written by Richard Frith-Macdonald <rfm@gnu.org> โ€” thank you king, we owe you everything ๐Ÿซถ๐ŸŒธ


so yeah bestie, that's the page! from the GNUstep System Manual, dated February 2004, filed under DEFAULTS(1). go forth and configure responsibly ๐Ÿ’…โœจ

๐Ÿ“ฆ where this page comes from