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 set SCHEMA [:PATH] KEY VALUE

gsettings reset SCHEMA [:PATH] KEY

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.

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. Monitoring will continue until the process is terminated.

writable

Finds out whether KEY is writable.

range

Queries the range 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.

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.

help

Prints help and exits.