GTK-BUILDER-TOOL(1)

💖 gtk-builder-tool — the GtkBuilder file utility, bestie edition 💖

okay so real quick, this is page GTK-BUILDER-TOOL(1) from the User Commands manual — and it's literally the little tool that does stuff to your GtkBuilder files. she's small. she's mighty. she's giving utility icon energy. 🛠️✨

---

🌸 SYNOPSIS 🌸

gtk-builder-tool [COMMAND] [OPTION...] FILE

that's it. that's the whole vibe. a command, some options, and a file. 🎀

---

🦋 DESCRIPTION 🦋

okay so <purple>gtk-builder-tool</purple> can perform various operations on GtkBuilder .ui files. that's the whole job description and honestly? iconic. 💅

⚠️ BESTIE LISTEN. You should always test the modified .ui files produced by gtk-builder-tool before using them in production. no cap. always. fr fr. 😭

---

👑 COMMANDS 👑

here's what she can actually do — the following commands are understood:

• validate — Validates the .ui file and reports errors to stderr. she's the vibe check. if something's off, she WILL tell you, and she tells stderr, not stdout. 🩷
• simplify — Simplifies the .ui file by removing properties that are set to their default values, then writes the resulting XML to stdout, or back to the input file. glow-down for the sake of cleanliness, we love a decluttered queen. 🧹✨
• enumerate — Lists all the named objects that are created in the .ui file. roll call!! everybody say present 📋🫶
• preview — Preview the .ui file. This command accepts options to specify the ID of an object and a .css file to use. it's the "show me" of the group chat. 👀🎨

---

🎀 SIMPLIFY OPTIONS 🎀

the simplify command accepts the following options:

• --replace — Write the content back to the .ui file instead of stdout. ⚠️ yes she will actually overwrite your file. no undo button. proceed with main character confidence but maybe back it up first. 💀

---

🌈 PREVIEW OPTIONS 🌈

the preview command accepts the following options:

• --id=ID — The ID of the object to preview. If not specified, <purple>gtk-builder-tool</purple> will choose a suitable object on its own. she's got taste, she'll pick a good one. 🍓
• --css=FILE — Load style information from the given .css file. dress her up!! 💄👑

---

lowkey the whole tool is just: point it at a .ui file, pick a command, and let her cook. highkey slay. 🔥

---

and that's the page, bestie!! this lil doc came to you from GTK+ — the source and version right there in the footer, and the manual page name is GTK-BUILDER-TOOL(1), the one and only. 💜✨ go forth and validate your .ui files before shipping them, i'm begging. mwah. 🫶🌸