PYSIDE6-QMLTYPEREGISTRAR(1)

💖 PYSIDE6-QMLTYPEREGISTRAR(1) 💖

okay bestie, sit down, hydrate, and let me tell you about pyside6-qmltyperegistrar — which is, for the record, the qmltyperegistrar tool hanging out in the PySide6 tools section of your manual. she's a build-time queen and she has one job: turn your MOC-generated json into QML type registrations. no cap. 👑

---

✨ NAME ✨

pyside6-qmltyperegistrar — literally just qmltyperegistrar. that's the name. that's the whole vibe. 🦋

---

🌸 SYNOPSIS 🌸

qmltyperegistrar [options] [MOC generated json file]

that's it. options first, MOC json last. she eats json and produces type registrations. slay. 💅

---

🎀 OPTIONS 🎀

every single one, no skips, we are thorough in this group chat:

• -h, --help — shows you the help for the commandline options. your emotional support flag. 🫶
• --help-all — help, but extra: this one also throws in the generic Qt options. the deluxe edition. ✨
• -v, --version — tells you the version info. icon behaviour honestly.
• -o <file> — write the output into the file you specify. pick a good one.
• --private-includes — pulls in headers that end in _p.h using #include <private/foo_p.h> instead of #include <foo_p.h>. so if you're the "private headers, yes please" type, this is your flag. 🔥
• --import-name <module name> — the name of the module used for type and module registrations. name your module, bestie. 🏷️
• --past-major-version <past major version> — the past major version used for type and module registrations. yes, past, she's the previous one.
• --major-version <major version> — the major version used for type and module registrations. the big number. 👑
• --minor-version <minor version> — the minor version, used for module registration. the lil number. 🍓
• --namespace <namespace> — generates the type registration functions inside a C++ namespace. cozy containment container energy. 🧚
• --generate-qmltypes <qmltypes file> — generate the qmltypes into the file you name. 💖
• --foreign-types <foreign types> — a comma separated list of other modules' metatypes files to consult for foreign types while generating the qmltypes file. com·ma se·pa·rat·ed. do not forget the commas. 😭
• --follow-foreign-versioning — set this and the versioning scheme of foreign base classes gets respected instead of ignored. mostly useful for modules that want to follow Qt's versioning scheme. it's giving "we do it the Qt way here". 🌈
• --jsroot — use the JavaScript root object's meta types as the sole input and generate no C++ output at all. only useful in combination with --generate-qmltypes. read that again — no C++ output, so don't pair her with anything else. 💀
• --extract — extract QML types from a module and register them using QML_FOREIGN. the glow-up pipeline. ✨

🌼 Arguments 🌼

• [MOC generated json file] — the MOC generated json output. this is the snack she eats. 🍓

---

heads up bestie: --jsroot genuinely produces no C++ output, so it only makes sense next to --generate-qmltypes. and --foreign-types is a comma separated list — that comma is load-bearing. 🫡

---

that's the whole page, no skips, no crumbs left. this was pyside6-qmltyperegistrar 6.11, dated September 2026 — mwah, love that for us. go build something iconic. 💜🎀