GTK-BUILDER-TOOL(1) User Commands GTK-BUILDER-TOOL(1)

# [NAME](#NAME)

gtk-builder-tool - GtkBuilder file utility

# [SYNOPSIS](#SYNOPSIS)

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

# [DESCRIPTION](#DESCRIPTION)

**gtk-builder-tool** can perform various operations on GtkBuilder .ui files.

You should always test the modified .ui files produced by gtk-builder-tool before using them in production.

# [COMMANDS](#COMMANDS)

.PP The following commands are understood:

.PP **validate**

Validates the .ui file and report errors to stderr.

.RE  
.PP **simplify**

Simplifies the .ui file by removing properties that are set to their default values and write the resulting XML to stdout, or back to the input file.

.RE  
.PP **enumerate**

Lists all the named objects that are created in the .ui file.

.RE  
.PP **preview**

Preview the .ui file. This command accepts options to specify the ID of an object and a .css file to use.

.RE

# [SIMPLIFY OPTIONS](#SIMPLIFY_OPTIONS)

.PP The **simplify** command accepts the following options:

.PP **--replace**

Write the content back to the .ui file instead of stdout.

.RE

# [PREVIEW OPTIONS](#PREVIEW_OPTIONS)

.PP The **preview** command accepts the following options:

.PP **--id=ID**

The ID of the object to preview. If not specified, gtk-builder-tool will choose a suitable object on its own.

.RE  
.PP **--css=FILE**

Load style information from the given .css file.

.RE

GTK+

---

Document: gtk-builder-tool(1) from gtk-3 3.24.52-r5 (Chainguard OS)
Source: https://gitlab.gnome.org/GNOME/gtk.git