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

`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.
`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.