{"id":27290,"library":"pyqt5-tools","title":"PyQt5 Tools","description":"PyQt5-tools provides Qt Designer, Qt Linguist, and other Qt tools for PyQt5 development. Current version 5.15.9.3.3, with irregular releases. It bundles binaries for Windows and Linux to avoid manual installation of Qt tools.","status":"active","version":"5.15.9.3.3","language":"python","source_language":"en","source_url":"https://github.com/altendky/pyqt-tools","tags":["pyqt5","qt-designer","qt-tools","gui"],"install":[{"cmd":"pip install pyqt5-tools","lang":"bash","label":"PyPI install"}],"dependencies":[{"reason":"Runtime dependency; tools are designed to work with PyQt5","package":"PyQt5","optional":false}],"imports":[{"note":"Old API used direct module attribute; correct is via QtDesigner class","wrong":"import pyqt5_tools; pyqt5_tools.designer()","symbol":"QtDesigner launch","correct":"from pyqt5_tools import QtDesigner; QtDesigner.run()"}],"quickstart":{"code":"import os\nfrom pyqt5_tools import QtDesigner\n# Optionally set designer path\nos.environ.setdefault('QT_QPA_PLATFORM_PLUGIN_PATH', '')\nQtDesigner.run()\n","lang":"python","description":"Launch Qt Designer from Python code."},"warnings":[{"fix":"Use `from pyqt5_tools import QtDesigner; QtDesigner.run()`","message":"In version 5.15.x, the import path changed from `pyqt5_tools.designer` to `pyqt5_tools.QtDesigner.run()`. Direct function calls break.","severity":"breaking","affected_versions":">=5.15"},{"fix":"Run `pip install PyQt5` before or alongside pyqt5-tools.","message":"PyQt5-tools does not install PyQt5 automatically. Must install PyQt5 separately.","severity":"gotcha","affected_versions":"all"},{"fix":"Install system packages: `sudo apt install libxcb-xinerama0` or use offscreen platform: `export QT_QPA_PLATFORM=offscreen`","message":"On Linux, Qt platform plugin errors may occur: 'Could not load the Qt platform plugin \"xcb\"'. This is due to missing system libraries.","severity":"gotcha","affected_versions":"all"}],"env_vars":null,"last_verified":"2026-04-27T00:00:00.000Z","next_check":"2026-07-26T00:00:00.000Z","problems":[{"fix":"Run `pip install pyqt5-tools` and use correct import: `from pyqt5_tools import QtDesigner`","cause":"Package not installed or old version with different namespace.","error":"ModuleNotFoundError: No module named 'pyqt5_tools'"},{"fix":"Update pyqt5-tools: `pip install --upgrade pyqt5-tools` and use `QtDesigner.run()`","cause":"Using older version where the API was different or import was incorrect.","error":"'QtDesigner' object has no attribute 'run'"}],"ecosystem":"pypi","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null}