NAME

       gtk4-builder-tool - GtkBuilder File Utility

SYNOPSIS

       gtk4-builder-tool <COMMAND> [OPTIONS...] <FILE>

       gtk4-builder-tool validate <FILE>
       gtk4-builder-tool enumerate <FILE>
       gtk4-builder-tool simplify [OPTIONS...] <FILE>
       gtk4-builder-tool preview [OPTIONS...] <FILE>
       gtk4-builder-tool screenshot [OPTIONS...] <FILE>

DESCRIPTION

       gtk4-builder-tool can perform various operations on GtkBuilder UI definition files.

COMMANDS

   Validation
       The validate command validates the given UI definition file and reports errors to stderr.

   Enumeration
       The  enumerate  command  lists all the named objects that are present in the UI definition
       file.

   Preview
       The preview command displays the UI definition file.

       This command accepts options to specify the ID of the toplevel object and a  CSS  file  to
       use.

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

       --css=FILE
          Load style information from the given CSS file.

   Screenshot
       The screenshot command saves a rendering of the UI definition file as a png image or  node
       file. The name of the file to write can be specified as a second FILE argument.

       This  command  accepts  options to specify the ID of the toplevel object and a CSS file to
       use.

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

       --css=FILE
          Load style information from the given CSS file.

       --node
          Write a serialized node file instead of a png image.

       --force
          Overwrite an existing file.

   Simplification
       The simplify command simplifies the UI definition file by removing properties that are set
       to their default values and writes the resulting XML to the standard output,  or  back  to
       the input file.

       When  the --3to4 option is specified, the simplify command interprets the input as a GTK 3
       UI definuition file and attempts to convert it to GTK 4 equivalents. It  performs  various
       conversions,   such  as  renaming  properties,  translating  child  properties  to  layout
       properties, rewriting the setup  for  GtkNotebook,  GtkStack,  GtkAssistant   or  changing
       toolbars into boxes.

       You  should  always  test  the  modified UI definition files produced by gtk4-builder-tool
       before using them in production.

       Note in particular that the conversion done with --3to4 is meant as a starting point for a
       port from GTK 3 to GTK 4. It is expected that you will have to do manual fixups  after the
       initial conversion.

       --replace
          Write the content back to the UI definition file instead of using the standard output.

       --3to4
          Transform a GTK 3 UI definition file to the equivalent GTK 4 definitions.

                                                                              GTK4-BUILDER-TOOL()