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

| 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. |
- Blender 4.2 (
bqtaim to support the earliest LTS version still under support) - Windows or Mac
- PySide6
PyObjC&iterm2(Mac only)
- Install & enable the bqt addon (see installation docs)
- 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
- 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
Discuss BQt on
- The BlenderArtists thread
- Ynput thread
Recommended version of bqt for legacy Blender versions.
| Blender | bqt |
notes |
|---|---|---|
| 4.2+ | 2.0.0 | Moving from addon to Blender extensions Dropped support for PySide2 |
| 2.93 -> 4.1 | 1.4.2 | |
| 2.83 -> 2.92 | 1.4.0 | Uncompatible logging option used |