gsettings
TLDR
Set the value of a key
SYNOPSIS
gsettings command [arguments]
DESCRIPTION
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.
Common uses include customizing GNOME desktop settings, scripting configuration changes, and debugging application preferences.
PARAMETERS
get SCHEMA KEY
Get the value of a keyset SCHEMA KEY VALUE
Set a key's value (must match schema type)reset SCHEMA KEY
Reset key to schema defaultlist-schemas
List installed schemaslist-keys SCHEMA
List keys in a schemalist-recursively [SCHEMA]
List all settings (optionally filtered by schema)range SCHEMA KEY
Show valid values for a keydescribe SCHEMA KEY
Show human-readable descriptionmonitor SCHEMA [KEY]
Watch for changes
COMMON SCHEMAS
org.gnome.desktop.interface - Desktop appearance settings
org.gnome.desktop.wm.preferences - Window manager preferences
org.gnome.shell - GNOME Shell settings
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.


