BQt

Add QT support to Blender, letting you create custom UI for your addons with PySide6 QtWidgets.

Features

| feature | description | |--------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------| | fully custom UI | Instead of feeling limited by N-Panel only UI. Do whatever you want. | | cross app | Qt widgets run natively in Krita, 3ds Max, Maya, … and are great to use in cross dcc pipelines | | existing community | hundreds of QT widgets on GitHub you can reuse, and lots of stack exchange questions answered regarding qt. | | Themed | BQt applies the blender-qt-stylesheet so qt widgets will by default look similar to Blender. |

Requirements

• Blender 4.2 (bqt aim to support the earliest LTS version still under support)
• Windows or Mac
• PySide6
• PyObjC & iterm2 (Mac only)

How to use

1. Install & enable the bqt addon (see installation docs)
2. Create & show your Qt widget, bqt will automatically register it with its widget manager.

• The bqt env vars let you toggle bqt features on and off
• sample code: bqt_demo shows you how to use bqt with several qt demos you can run in Blender

contribute

• I am a technical writer and want to contribute to the docs. see readme on the wiki.
• I am a dev and want to contribute to bqt code, see contribute guidelines.
• I am a user or tester and want to report a bug or request a feature, please post here

Community

Discuss BQt on

• The BlenderArtists thread
• Ynput thread

Blender legacy versions

Recommended version of bqt for legacy Blender versions.

| Blender | bqt | notes | |---------------|-------|--------| | 4.2+ | 2.0.0 | Moving from addon to Blender extensions<br>Dropped support for PySide2 | | 2.93 -> 4.1 | 1.4.2 | | | 2.83 -> 2.92 | 1.4.0 | Uncompatible logging option used |