USDCAT(1)

🦋 NAME 🦋 · USDCAT(1) · User Commands

usdcat — manual page for usdcat 26.11.1

✨ SYNOPSIS ✨

usdcat [OPTIONS] inputFiles...

💖 DESCRIPTION 💖

okay so bestie, usdcat writes usd file(s) either as text to stdout or to a specified output file. that’s it, that’s the whole vibe — iconic behavior, fr fr. ✨

🌸 Positionals 🌸

• inputFiles ... — A list of input files. like, the actual files you’re feeding in, bestie.

💅 OPTIONS 💅

vibe check: every flag is right here, no skips, periodt. 💅

• -h,--help — Print this help message and exit. short, sweet, iconic.
• -o,--out file — Write a single input file to this output file instead of stdout. one input file, one output file — no cap.
• --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. no cap, watch that exit code.
• -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.

---

kisses bestie 💖 — that was usdcat 26.11.1, dated October 2026, and yes, USDCAT(1) ate. 🫶🎀