The Qml Preview

The QML Preview tool watches QML and JavaScript files on disk and updates the application live with any changes. The application to be previewed has to have QML debugging enabled. More...

qmlpreview [options] executable [parameters...]


–verbosePrint debugging output.
-h, –helpDisplays help on commandline options.
–help-allDisplays help, including generic Qt options.
-v, –versionDisplays version information.


executableThe path of the executable file that loads a QML document.
parametersArguments of the executable


Enable QML Debugging

To enable QML debugging, make sure you build your application with appropriate configuration parameters. When using qmake, you should add CONFIG+=qml_debug in the .pro file. If you use another build system, then QT_QML_DEBUG variable should be defined.


target_compile_definitions(MyApp PRIVATE QT_QML_DEBUG)

© 2024 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.