Back to Doc.qt.io
Contact Us Blog Download Qt

Debug on Linux Get help

Enable QML debugging

To enable QML debugging for a project:

  1. In Solution Explorer, right-click the project and select Properties in the context menu.
  2. Select Configuration Properties > Qt Project Settings.
  3. In Enable QML Debugging, select Yes.

    {Enabling QML debugging for a project}

  4. Select OK to save the project settings.
  5. Go to Build > Rebuild Solution to rebuild the project.

Disable QML debugging

To disable processing of all QML debug events by the QML debug engine:

  1. Go to Extensions > Qt VS Tools > Options > Qt > General > QML Debugging.

    {QML Debugging in Qt General Options}

  2. Set Process debug events to False.

This effectively excludes the QML debug engine from the debugging environment and disables debugging of QML code for all projects.

Set debugging connection timeout

To increase or decrease the timeout for debugging connections in milliseconds:

  1. Go to Extensions > Qt VS Tools > Options > Qt > General > QML Debugging.
  2. Set the value of Runtime connection timeout in milliseconds.

To remove the timeout, set the value to Disabled.

See also Tutorial: Qt Quick debugging, Cross-compile, Debug applications, Debug on Linux, and Debugging Qt Quick applications.

Debug on Linux Get help

© 2025 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.