GSETTINGS-DATA-CON(1)

💖 GSETTINGS-DATA-CON(1) 💖

okay bestie, gather round, because this is the manual page for gsettings-data-convert, a lil User Commands girlie who is literally here to do your GConf → GSettings glow-up. ✨

---

🌸 NAME 🌸

gsettings-data-convert — GConf to GSettings data migration. that's it, that's the whole job, and she ATE. 💅

---

🦋 SYNOPSIS 🦋

gsettings-data-convert [option...]

---

✨ DESCRIPTION ✨

so here's the tea: gsettings-data-convert reads values out of the user's GConf database and stores them in GSettings. like, it goes and gets your old stuff and moves it into the new place. moving day, but make it seamless. 🚚💖

the info about the mapping from GConf keys to GSettings keys is taken from files in /usr/share/GConf/gsettings. every single file in that directory gets read as a key file, and it has sections for each GSettings schema that is being converted. the entries in each section map GSettings keys to paths in the GConf database. and ngl, currently gsettings-data-convert supports all basic GConf types as well as lists of strings and lists of integers. she's versatile like that. 👑

a simple example might look like this:

[org.gnome.fonts]
antialiasing = /desktop/gnome/font_rendering/antialiasing
dpi = /desktop/gnome/font_rendering/dpi
hinting = /desktop/gnome/font_rendering/hinting
rgba_order = /desktop/gnome/font_rendering/rgba_order

cute right? but wait — if the GSettings schema does not have a fixed path, you must specify the path in the group name, separated by a colon character. so like:

[org.gnome.fonts:/desktop/gnome/font-rendering/]

the way that gsettings-data-convert keeps a list of the key files it has already converted?? iconic. that means it's safe to run it repeatedly to handle newly appeared key files. no drama, no double-converting, no chaos. 🧚

the expected use of this utility is to make each application install a key file for the GConf keys that it wants to be migrated, and run gsettings-data-convert every time a user logs in. that's the whole vibe. set it and forget it, fr fr.

---

🎀 Options 🎀

• -h, --help — print help and exit. your girl explains herself. 🫶
• --dry-run — do not make any changes, just report what would be done. a little dress rehearsal, no commitment, we love a preview. 👀
• --verbose — show verbose messages. she will tell you everything. 🗣️💬

---

🌈 SEE ALSO 🌈

gsettings-schema-convert(1) is a related command that helps with the conversion of schemas from GConf to GSettings. basically her cousin. same family, same mission. 💜

---

that's the page bestie!! 💖 this was User Commands realness from 01/21/2013, living under the name GSETTINGS-DATA-CON(1) — mwah, slay, go convert your data, ily. ✨🎀🦋