PYSIDE6-QML(1)

PYSIDE6-QML(1) 💖

okay so this is pyside6-qml, one of the PySide6 tools, and bestie it is so fun — it's the thing you use when you want to run a .qml file, like, right now, no build step, no project setup, nothing. Just vibes. ✨

---

🌸 NAME 🌸

pyside6-qml — literally just qml. bestie. that's the whole name. 💅

---

✨ DESCRIPTION ✨

Here's the whole usage, verbatim, because you will need it:

usage: qml.py [-h] [--module-paths MODULE_PATHS [MODULE_PATHS ...]]
       [--list-conf] [--apptype {core,gui,widget}] [--config
       {default,resizeToItem}] [--rhi {vulkan,metal,d3dll,gl}]
       [--core-profile] [-v] [--gles | --desktop | --software |
       --disable-context-sharing] file

So this tool mimics the capabilities of the qml runtime utility by directly invoking QQmlEngine/QQuickView — no cap, it just goes straight to the engine. Which means it enables quick prototyping with qml files. You write a qml file, you run it, you see it. periodt. 🦋

---

🌈 positional arguments

• file — Path to qml file to display. that's the one, the file you wanna see, give it here. 🎀

---

👑 options

• -h, --help — show this help message and exit. the classic. always there for you. 🫶
• --module-paths, -I MODULE_PATHS [MODULE_PATHS ...] — Specify space separated folder/file paths where the Qml classes are defined. By default,the parent directory of the qml_path is searched recursively for all .py files and they are imported. Otherwise only the paths give in module paths are searched. so like — default behaviour is it goes rummaging through the parent dir of your qml file, recursive, scooping up every .py it finds and importing them. but if you pass this, it only looks where you said. your call bestie 💅
• --list-conf — List the built-in configurations. lil peek at what configs exist before you pick one 🍓
• --apptype, -a {core,gui,widget} — Select which application class to use. Default is gui. lowkey important decision, don't sleep on it ✨
• --config, -c {default,resizeToItem} — Select the built-in configurations. 🎀
• --rhi, -r {vulkan,metal,d3dll,gl} — Set the backend for the Qt graphics abstraction (RHI). pick your graphics flavour, iconic 🌈
• --core-profile — Force use of OpenGL Core Profile. forcing it. no negotiation. 🔥
• -v, --verbose — Print information about what qml is doing, like specific file URLs being loaded. the "tell me everything" button, honestly obsessed 🔍
• --gles — Force use of GLES (AA_UseOpenGLES). 💜
• --desktop — Force use of desktop OpenGL (AA_UseDesktopOpenGL). 🦋
• --software — Force use of software rendering(AA_UseSoftwareOpenGL). for when the GPU said no 😭
• --disable-context-sharing — Disable the use of a shared GL context for QtQuick Windows. 🧚

heads up bestie: --gles, --desktop, --software, and --disable-context-sharing all live in the same group in that usage line, so they're mutually exclusive-ish — you can only pick one of the rendering modes there. choose wisely 💖

---

and that's the whole thing! go prototype something cute 💖🦋🌸

pyside6-qml 6.11 — September 2026 — mwah, love u, go make something iconic bestie 💅✨🎀