Skip to main content

QT PyQt PySide Custom Widgets

PyPI Python License Docs

133 widgets for PySide6, free and open source — charts, data tables, gauges, animated menus, window chrome, loaders and more. Every widget is authorable in Qt Designer, themed through design tokens with light/dark palettes, and documented with live screenshots generated straight from the code.

A further 23 widgets — including the advanced charts, the code and rich-text editors, the media widgets and DataTable Pro — ship in Custom Widgets Pro, which also licenses the whole catalog for closed-source use.

Custom Widgets Art

Installation

pip install QT-PyQt-PySide-Custom-Widgets[pyside6]   # first install, with Qt
pip install --upgrade QT-PyQt-PySide-Custom-Widgets

Requires Python 3.10+ (PySide6's own floor).

You need a Qt binding. The library reaches Qt through qtpy and does not bundle a binding — that is what lets you use PySide6 or PyQt6, instead of forcing a second ~200 MB Qt download on anyone who already has one. The [pyside6] extra above installs it for you. Prefer PyQt6? pip install PyQt6 and set QT_API=pyqt6. Install without a binding and the first import tells you exactly this, rather than raising a bare QtBindingsNotFoundError.

Optional extras (niche widgets pull their heavier stacks on demand):

pip install "QT-PyQt-PySide-Custom-Widgets[qr]"       # QCustomQRGenerator
pip install "QT-PyQt-PySide-Custom-Widgets[map]"      # QCustomMapView (QtLocation)
pip install "QT-PyQt-PySide-Custom-Widgets[acrylic]"  # AcrylicEffect blur
pip install "QT-PyQt-PySide-Custom-Widgets[loaders]"  # QCustomPerlinLoader
pip install "QT-PyQt-PySide-Custom-Widgets[mcp]"      # the Custom_Widgets MCP server
pip install "QT-PyQt-PySide-Custom-Widgets[all]"      # everything above

Highlights

  • Painted chart family — line, bar, area, pie, donut, sparkline, radial and liquid gauges, compass, mini bar and waveform; QPainter-native, crisp at any size. (Scatter, funnel, range bar, Sankey, candlestick, beeswarm, diverging bar, bubble, dot matrix, radar, Gantt and heatmap are Pro.)
  • QCustomDataTable — rich cell renderers (two-line, status, currency, link), synthetic select/actions columns, sortable headers.
  • Chrome & motion — custom title bars, hamburger and slide menus, animated stacked-widget transitions, flow layouts with animated reflow, progress and skeleton loaders, typewriter/sparkles/gradient text.
  • Design-token theming — applyDesignTokens drives role-based QSS and light/dark palettes across the whole set.
  • Qt Designer first — every widget and property can be authored visually; the examples ship with editable .ui files.
  • Typed — full .pyi stubs, py.typed, mypy-clean.
  • MCP server ([mcp] extra) — agent control of Qt Designer, live app observation, widget catalog/signature/render tools.
  • Design-rule linter — Custom_Widgets.lint catches glyph icons, hardcoded hex colours, drop shadows and oversized icons.

Usage

Read the required project structure before starting — apps use a ui/ + compiled src/ + Qss/ layout that keeps Designer files, generated code and themes separate. The examples/ folder contains 69 complete apps built that way.

QCustomArcLoader GIF

Documentation

Pro & support

The free library is complete on its own and licensed GPLv3. For commercial teams there is Custom Widgets Pro — 23 widgets that are not in this package (the advanced charts, the code and rich-text editors, the media widgets, the node graph) plus DataTable Pro (virtualization, server-side sort/filter, grouping with aggregates, pivot, frozen columns, inline editing, CSV/XLSX export), and 14 example applications. Active Patreon supporters get the same entitlements. The Pro licence includes a written GPL additional permission, so combining the core with Pro and your application does not pull your application under the GPL.

Contributors

Thanks to everyone involved in the development of the project!

Made with contrib.rocks.

Note — this repository is the project's permanent home. It was previously published from the KhamisiKibet account, which is no longer accessible; all development continues here under SpinnCompany.

Credits & third-party assets

This package bundles third-party icon sets and a font. Full notices and the license texts ship inside the package under Custom_Widgets/THIRD_PARTY_NOTICES.md and Custom_Widgets/licenses/.

  • Icons by Font Awesome — Free icons licensed under CC BY 4.0 (© Fonticons, Inc.); fonts under SIL OFL 1.1, code under MIT. Icons may be recoloured/resized.
  • Material Design Icons — Apache License 2.0 (© Google and contributors).
  • Feather — MIT (© 2013-2017 Cole Bemis).
  • Rosario — SIL Open Font License 1.1 (the bundled UI font).

Metadata

Release files for QT-PyQt-PySide-Custom-Widgets 2.6.2

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for QT-PyQt-PySide-Custom-Widgets 2.6.2
File Size Uploaded Provenance Actions
qt_pyqt_pyside_custom_widgets-2.6.2.tar.gz 7.0 MB Without provenance Details for qt_pyqt_pyside_custom_widgets-2.6.2.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for QT-PyQt-PySide-Custom-Widgets 2.6.2
File Interpreter ABI Platform Actions
qt_pyqt_pyside_custom_widgets-2.6.2-py3-none-any.whl Python 3 none any Details for qt_pyqt_pyside_custom_widgets-2.6.2-py3-none-any.whl

Total release size: 16.5 MB

Release files / qt_pyqt_pyside_custom_widgets-2.6.2.tar.gz

Download URL qt_pyqt_pyside_custom_widgets-2.6.2.tar.gz
Size 7.0 MB
Tags Source
SHA-256 checksum
How to use checksums
5cc59579f8bfc8424214b95e5428ec511e9e9b1be242313bd328715aee14aa5e
BLAKE2b-256 checksum
How to use checksums
809095e041c5c41f13cd8e97f8d73e150bc690ae74f5cb8defc7914dfec0eae5
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.14.8

Release files / qt_pyqt_pyside_custom_widgets-2.6.2-py3-none-any.whl

Download URL qt_pyqt_pyside_custom_widgets-2.6.2-py3-none-any.whl
Size 9.6 MB
Tags Python 3
SHA-256 checksum
How to use checksums
ece910077396db0d5f5c00699095d2e664c3585c849a1dde433e4114d07a8a08
BLAKE2b-256 checksum
How to use checksums
8fac49683259dc1c2b861b429c613d8d012d23abb5d6e43d6ce02eaad5610993
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.14.8

Security for QT-PyQt-PySide-Custom-Widgets 2.6.2

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

2.6.2 This release

2 release files No provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page