gsettings

GNOME desktop configuration command-line interface

TLDR

Set the value of a key

$ gsettings set [org.example.schema] [example-key] [value]

Get the value of a key

$ gsettings get [org.example.schema] [example-key]

Reset a key to its schema default value

$ gsettings reset [org.example.schema] [example-key]

Display all schemas, keys, and values recursively

$ gsettings list-recursively

Display keys and values from one schema

$ gsettings list-recursively [org.example.schema]

Display allowed values for a key

$ gsettings range [org.example.schema] [example-key]

Display the description of a key

$ gsettings describe [org.example.schema] [example-key]

gsettings is the command-line interface for GSettings, GNOME's configuration system. It provides schema-validated access to dconf settings, ensuring type safety and valid values.Settings are organized in schemas (like org.gnome.desktop.interface) containing typed keys. Unlike direct dconf access, gsettings validates values against the schema before applying them.

PARAMETERS

get SCHEMA KEY

Get the value of a key

set SCHEMA KEY VALUE

Set a key's value (must match schema type)

reset SCHEMA KEY

Reset key to schema default

list-schemas

List installed schemas

list-keys SCHEMA

List keys in a schema

list-recursively [SCHEMA]

List all settings (optionally filtered by schema)

range SCHEMA KEY

Show valid values for a key

describe SCHEMA KEY

Show human-readable description

monitor SCHEMA [KEY]

Watch for changes

COMMON SCHEMAS

org.gnome.desktop.interface - Desktop appearance settingsorg.gnome.desktop.wm.preferences - Window manager preferencesorg.gnome.shell - GNOME Shell settings

INSTALL

sudo apt install libglib2.0-bin

sudo dnf install glib

sudo apk add glib

brew install glib

nix profile install nixpkgs#glib

CAVEATS

Only works with applications using GSettings (primarily GNOME). Some settings require logout or restart to take effect. Schema must be installed for settings to work.

HISTORY

GSettings was introduced in GLib 2.26 (2010) as a replacement for GConf. It uses dconf as its backend while providing schema validation, making configuration more robust and introspectable.