⚠️ PyPi version is currently outdated. Install from this repo for latest.

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

Blender 2.83or higher. Windows (stable) or Mac (experimental)

1. Download the latest release. You can download the zip from the repo.
2. Extract the zip and copy the bqt folder to your blender addons folder.
3. Enable the addon by going to Edit > Preferences > Add-ons and search for qt

⚠ PIP install is currently outdated, do not use until further notice.

The installation of bqt with automatic setup for Blender requires the usage of the integrated python interpreter found within ../Blender Foundation/<version>/Python/bin

python.exe -m pip install bqt

If you are installing from a clone of the repository you can easily install by navigating to bqt's root folder and running:

python setup.py install

When working on the bqt code from a repo, to prevent having to reinstall bqt every time you make a change, you can symlink the bqt folder to your blender addons folder to develop bqt. Any updates in the repo are then reflected in blender on restart. e.g.:

mklink /J "C:\Users\USERNAME\AppData\Roaming\Blender Foundation\Blender\2.93\scripts\addons\bqt" "C:\Users\hanne\OneDrive\Documents\repos\_Blender\bqt\bqt"

• BQT_DISABLE_STARTUP if set to 1, completely disable bqt
• BQT_DISABLE_WRAP if set to 1, disable wrapping blender in a QWindow
• BQT_DISABLE_CLOSE_DIALOGUE if set to 1, use the standard blender close dialogue

bqt_demo shows you how to use bqt with several qt demos you can run in Blender

Discuss BQT on

• the BlenderArtists thread
• Ynput thread

• Custom UI for Blender only: https://github.com/mmmrqs/bl_ui_widgets