Back to main site | Back to man page index

GSETTINGS(1)                                        User Commands                                        GSETTINGS(1)



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



GIO                                                                                                      GSETTINGS(1)