Qt Quick WebGL | Qt 5.15 (original) (raw)

The Qt Quick WebGL is a platform plugin that allows for single-user remote access by streaming Qt Quick user interfaces over the network. The UI is rendered in a WebGL™-enabled client browser.

Using Qt Quick WebGL

Any Qt Quick application can be launched with the webgl platform plugin as follows:

./qmlapplication -platform webgl

This starts a lightweight web server on port 8080, that the client can connect to with a web browser that supports WebGL. The listening port can be configured as follows:

./qmlapplication -platform webgl:port=80

Keyboard, mouse, touch, and multi-touch events from the client are passed to the application.

Limitations

• Streaming OpenGL® commands over the network imposes an amount of delay compared to running the application locally.
• Desktop applications that use Qt Widgets are not supported by the plugin.
• Text elements may not display correctly when the Text.NativeRendering render type option is set.
• Only one active client per process is permitted. Subsequent clients attempting to connect to the server will see a loading indicator until the previous client disconnects.
• Streaming audio is not supported.

Note: The webgl plugin requires a threaded render loop. On Windows and other platforms that use a different render loop by default, set the QSG_RENDER_LOOP environment variable accordingly:

set QSG_RENDER_LOOP=threaded

Licenses

Qt Quick WebGL is available under commercial licenses from The Qt Company. In addition, it is available under the GNU General Public License, version 3. See Qt Licensing for further details.

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