Installation¶
From PyPI¶
The package is available on PyPI:
Qt Binding¶
A Qt 6 binding is required and not installed with fxgui: PySide6 6.5 or newer. A DCC such as Houdini ships its own PySide6; outside one, install it yourself:
PyQt6 is not supported: fxgui goes through QtPy, but its tests run on PySide6 only, and a PyQt6 run fails in many places.
Qt 5 (PySide2, PyQt5) and PySide6 older than 6.5 are not supported:
import fxgui raises an ImportError that names the binding or the
version it found.
From Source¶
Clone the repository:
Or using the requirements file:
Optional Dependencies¶
Docking¶
fxdocking.FXDockArea docks panes with Qt Advanced Docking System
(QtAds). Its Python package, PySide6-QtAds, is built against one exact
PySide6: each release names the PySide6 it needs, and pip replaces the
one you have to match it. So install it with your own PySide6 version
named beside it. Find your version first:
Then name it, here 6.8.2:
pip picks the QtAds release made for that PySide6 and leaves your
PySide6 alone. If it answers ResolutionImpossible, no QtAds release was
made for your PySide6 (6.5.3, Houdini 21's, has none): docking is not
available there.
Inside a DCC, PySide6 comes with the application, not from pip, so
pip show finds nothing. Do not pip install QtAds into a DCC's Python:
its PySide6 would load beside the host's and break it.
Only fxgui.fxdocking imports QtAds; the rest of fxgui works without it.
Documentation¶
To build this site with Zensical:
pip install -e ".[zensical]"
zensical serve # Preview at http://127.0.0.1:8000
zensical build # Write the site to site/
DCC Integration¶
Question
A DCC's Python only sees fxgui if it is on its PYTHONPATH. For Houdini, install fxgui and its dependencies into a folder of their own with a Python of the same version as Houdini's (3.11 for Houdini 21): python3.11 -m pip install --target C:/path/to/fxgui_libs fxgui. PySide6 is not installed, since fxgui does not depend on it. Then copy houdini_package.json into Houdini's packages folder and set FXGUI_LIBS in it to that folder.