GSETTINGS(1)

✨ gsettings ✨

okay bestie, welcome to the gsettings(1) page — yes it's the gsettings manual, she's iconic, she's giving configuration tool energy 👑

---

💖 NAME 💖

gsettings — the GSettings configuration tool. that's her. that's the whole name. short, sweet, slays 💅

---

🎀 SYNOPSIS 🎀

like, here's every single way you can call her, no cap:

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 [--print-paths]
gsettings list-relocatable-schemas
gsettings list-keys SCHEMA[:PATH]
gsettings list-children SCHEMA[:PATH]
gsettings list-recursively [SCHEMA[:PATH]]
gsettings help [COMMAND]

---

🦋 DESCRIPTION 🦋

so basically, gsettings is your little command-line bestie for GSettings. she lets you get, set, or monitor one single key for changes. that's the vibe 🌸

the SCHEMA and KEY arguments? yeah, most commands literally require them, because they gotta know the schema ID and the name of the key you're messing with. the schema ID can optionally have a :PATH suffix — and you only need to specify that path if the schema doesn't have a fixed path. if it has a fixed path she already knows where she's going, she's not lost, she's arriving ✨

when you're setting a key, you also have to specify a VALUE. and the format for that value is the format of a serialized GVariant — so like, a string has to include explicit quotes: 'foo'. yes bestie, the quotes are mandatory, don't fight it. this same format is also what gets used when printing out values. consistency, queen 💅

⚠️ important tea: gsettings needs a D-Bus session bus connection to write changes to the dconf database. no session bus, no writing. periodt.

---

🌈 COMMANDS 🌈

🍓 get

Gets the value of KEY. the value gets printed out as a serialized GVariant. she's just reading, not judging 🫶

👑 monitor

Monitors KEY for changes and prints the changed values. and if no KEY is specified? she monitors all keys in the schema. monitoring continues until the process is terminated — she's not leaving, you're leaving 😭

🧚 writable

Finds out whether KEY is writable. yes or no. vibe check on your permissions 🔥

💜 range

Queries the range of valid values for KEY. she'll tell you what's allowed. stay in your lane, but like, lovingly ✨

🌸 describe

Queries the description of valid values for KEY. the lore behind the values, iykyk 📖

💖 set

Sets the value of KEY to VALUE. the value is specified as a serialized GVariant. remember your quotes bestie, 'foo' not foo 🙈

🎀 reset

Resets KEY to its default value. back to factory settings, we love a fresh start 🌱

⭐ reset-recursively

Reset all keys under the given SCHEMA. all of them. every single one. it's giving spring cleaning 🧹

🦋 list-schemas

Lists the installed, non-relocatable schemas. and if you're interested in relocatable schemas, go see list-relocatable-schemas. also — if --print-paths is given, the path where each schema is mapped is also printed. so many paths, so much main character energy 🛣️

💀 list-relocatable-schemas

Lists the installed, relocatable schemas. and if you're interested in non-relocatable schemas, go see list-schemas. they're sisters, they complete each other 🫶

🌺 list-keys

Lists the keys in SCHEMA. all the keys. the whole keyring 🔑

🐚 list-children

Lists the children of SCHEMA. yes she has children. she's a mother 💅

🎉 list-recursively

Lists keys and values, recursively. and if no SCHEMA is given, she lists keys in all schemas. go big or go home, no cap 🔥

🩷 help

Prints help and exits. she's helpful AND she knows when to leave. the healthiest communication ✨

---

💌 a little note from me to you: every single flag, every path, every format rule up there is real and matters, so don't skip the :PATH and don't skip the quotes. slay responsibly 👑

---

and that's the page, bestie! this was the gsettings manual — gsettings() in section 1 of the manual, brought to you by the fine folks behind GSettings. thanks for reading, you ate that 💅✨💖