USDCAT(1)                        User Commands                       USDCAT(1)

NAME
       usdcat - manual page for usdcat 26.08

SYNOPSIS
       usdcat [OPTIONS] inputFiles...

DESCRIPTION
       Write usd file(s) either as text to stdout or to a specified output
       file.

   Positionals:
       inputFiles ...
              A list of input files

OPTIONS
       -h,--help
              Print this help message and exit

       -o,--out file
              Write a single input file to this output file instead of stdout.

       --usdFormat usda|usdc
              Use this underlying file format for output files with the
              extension 'usd'. For example, passing '-o output.usd --usdformat
              usda' will create output.usd as a text file. The
              USD_DEFAULT_FILE_FORMAT environment variable is another way to
              achieve this.

       -l,--loadOnly
              Attempt to load the specified input files and report 'OK' or
              'ERR' for each one. After all files are processed, this script
              will exit with a non-zero exit code if any files failed to load.

       -f,--flatten
              Compose stages with the input files as root layers and write
              their flattened content.

       --flattenLayerStack
              Flatten the layer stack with the given root layer, and write out
              the results. Unlike --flatten, this does not flatten composition
              arcs (such as references).

       --skipSourceFileComment
              If --flatten is specified, skip adding a comment regarding the
              source of the flattened layer in the documentation field of the
              output layer.

       --mask PRIMPATH[,PRIMPATH...]
              Limit stage population to these prims, their descendants and
              ancestors. To specify multiple paths, either use commas with no
              spaces, or quote the argument and separate paths by commas
              and/or spaces. Requires --flatten.

       --layerMetadata
              Load only layer metadata in the USD file.  This option cannot be
              combined with either --flatten or --flattenLayerStack.

usdcat 26.08                    September 2026                       USDCAT(1)