qtextra

Extra widgets and dialogs for PyQt/PySide via qtpy

qtextra packages reusable Qt widgets, dialogs, and helpers that sit on top of PyQt/PySide through qtpy. The library focuses on opinionated, application-level building blocks such as searchable comboboxes, step progress indicators, styled buttons, collapsible sections, and utility dialogs.

Components are tested on:

• macOS, Windows & Linux
• Python 3.10 and above
• PyQt5 (5.11 and above) & PyQt6
• PySide2 (5.11 and above) & PySide6

The project overlaps somewhat with superqt, but it leans more heavily into application-ready widgets and bundled styling in src/qtextra/assets/stylesheets.

Documentation

Documentation is available at https://lukasz-migas.github.io/qtextra/

Installation

pip install qtextra

Optional extras:

pip install "qtextra[console,sentry]"

Quick Start

from qtpy.QtWidgets import QApplication, QVBoxLayout, QWidget

from qtextra.config import THEMES
from qtextra.widgets.qt_collapsible import QtCheckCollapsible
from qtextra.widgets.qt_progress_step import QtStepProgressBar

app = QApplication([])

window = QWidget()
layout = QVBoxLayout(window)

steps = QtStepProgressBar()
steps.labels = ["Load", "Validate", "Export"]
steps.value = 2
layout.addWidget(steps)

details = QtCheckCollapsible("Advanced options")
details.addRow("Status", QWidget())
layout.addWidget(details)

THEMES.apply(window)
window.show()
app.exec_()

A larger showcase example is available at examples/qt_readme_showcase.py.

Documentation

• Automatic widget generation: docs/auto.md
• Mixins reference: docs/mixins.md
• User guides: docs/
• Widgets overview: docs/widgets/index.md
• Dialogs overview: docs/dialogs/index.md
• Examples: examples/

Contributing

Contributions are always welcome. Please feel free to submit PRs with new features, bug fixes, or documentation improvements.

git clone https://github.com/lukasz-migas/qtextra.git

pip install -e ".[dev]"
pytest