gsettings: GIO Reference Manual

gsettings

gsettings — GSettings configuration tool

Synopsis

gsettings get SCHEMA [:PATH] KEY

gsettings monitor SCHEMA [:PATH] [KEY]

gsettings writable SCHEMA [:PATH] KEY

gsettings range SCHEMA [:PATH] KEY

gsettings describe SCHEMA [:PATH] KEY

gsettings set SCHEMA [:PATH] KEY VALUE

gsettings reset SCHEMA [:PATH] KEY

gsettings reset-recursively SCHEMA [:PATH]

gsettings list-schemas [--print-paths]

gsettings list-relocatable-schemas

gsettings list-keys SCHEMA [:PATH]

gsettings list-children SCHEMA [:PATH]

gsettings list-recursively [SCHEMA [:PATH]]

gsettings help [COMMAND]

Description

gsettings offers a simple commandline interface to GSettings. It lets you get, set or monitor an individual key for changes.

The SCHEMA and KEY arguments are required for most commands to specify the schema id and the name of the key to operate on. The schema id may optionally have a :PATH suffix. Specifying the path is only needed if the schema does not have a fixed path.

When setting a key, you also need specify a VALUE The format for the value is that of a serialized GVariant, so e.g. a string must include explicit quotes: "'foo'". This format is also used when printing out values.

Note that gsettings needs a D-Bus session bus connection to write changes to the dconf database.

Commands

`get`	Gets the value of `KEY`. The value is printed out as a serialised GVariant.
`monitor`	Monitors `KEY` for changes and prints the changed values. If no `KEY` is specified, all keys in the schema are monitored. Monitoring will continue until the process is terminated.
`writable`	Finds out whether `KEY` is writable.
`range`	Queries the range of valid values for `KEY`.
`describe`	Queries the description of valid values for `KEY`.
`set`	Sets the value of `KEY` to `VALUE`. The value is specified as a serialised GVariant.
`reset`	Resets `KEY` to its default value.
`reset-recursively`	Reset all keys under the given `SCHEMA`.
`list-schemas`	Lists the installed, non-relocatable schemas. See `list-relocatable-schemas` if you are interested in relocatable schemas. If [`--print-paths`] is given, the path where each schema is mapped is also printed.
`list-relocatable-schemas`	Lists the installed, relocatable schemas. See `list-schemas` if you are interested in non-relocatable schemas.
`list-keys`	Lists the keys in `SCHEMA`.
`list-children`	Lists the children of `SCHEMA`.
`list-recursively`	Lists keys and values, recursively. If no `SCHEMA` is given, list keys in all schemas.
`help`	Prints help and exits.