PYSIDE6-QMLCACHEGEN(1)

💅 PYSIDE6-QMLCACHEGEN

okay bestie, welcome to the PySide6 tools corner of the manual, this one's all about pyside6-qmlcachegen ✨ it lives in the PySide6 tools section, lowercase, cute, does one job and does it well.

---

🎀 NAME

pyside6-qmlcachegen — literally just qmlcachegen 🦋

---

✨ SYNOPSIS

qmlcachegen [options] [qml file]

---

👑 OPTIONS

• -h, --help — shows you the help for the commandline options. the classic "i forgot what the flag was" move 🙈
• --help-all — same energy but it ALSO shows the generic Qt options. the full deluxe version.
• -v, --version — tells you the version info. slay.
• --bare — do not include the default import directories. use this when you wanna run qmlcachegen on a project that's using a different Qt version. fitting name honestly, it's giving minimalism 💅
• --filter-resource-file — filters out the QML/JS files from a resource file that can be cached ahead of time instead 🔥
• --resource-file-mapping <old-name=new-name> — the path from the original resource file to the new one. note the <old-name=new-name> shape, keep it exact bestie.
• --resource <resource-file-name> — a Qt resource file that might later contain one of the compiled files.
• --resource-path <resource-path> — the Qt resource file path that corresponds to the file being compiled.
• --resource-name <compiled-file-list> — required if you wanna generate qmlcache_loader without qrc files. this is the name of the Qt resource that the input files belong to. no skipping this one, it's mandatory in that case 👑
• -i <qmldir file> — import an extra qmldir 🧚
• -I <import directory> — look for QML modules in the specified directory. capital I, don't mix it up with lowercase i, they are Not the same thing.
• --only-bytecode — generate only byte code for bindings and functions, no C++ code. bytecode only, no cap 💀
• --verbose — outputs compile warnings. the "tell me everything" mode.
• --warnings-are-errors — treats warnings as errors. dramatic? yes. useful? also yes. 🌸
• --validate-basic-blocks — performs checks on the basic blocks of a function compiled ahead of time, to validate its structure and coherence. it's like a vibe check but for control flow 🌈
• --dump-aot-stats — dumps statistics about ahead-of-time compilation of bindings and functions. numbers go brrr 📊
• --module-id <id> — identifies the module of the qml file being compiled, for aot stats. pairs great with --dump-aot-stats iykyk.
• -o <file name> — output file name. where the goods go 💖

🫶 Arguments

• [qml file] — the QML source file to generate a cache for. the main character of this whole operation ⭐

---

reminder bestie: this whole thing is qmlcachegen under the hood, the pyside6- prefix is just how you reach it 🎀

---

and that's the page!! brought to you by pyside6-qmlcachegen 6.11, dated September 2026 — catch you in the next manpage, mwah 💋💜