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. Plans at customwidgets.org/pricing; 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).

Project links

Key dates

PyPI data
Data sourced directly from PyPI's database.
  • Released:
Latest release

1 maintainer

PyPI data
Data sourced directly from PyPI's database.
Avatar for khamisiKib from gravatar.com khamisiKib

Credits

PyPI data
Data sourced directly from PyPI's database.

Author: Khamisi Kibet

License

GNU General Public License v3 (GPLv3) (GPL-3.0-only)

Requires

Python >=3.10

Provides Extra

pyside6 qr acrylic acrylic-hq loaders mcp map dev all

Tags

PySide PyQt Qt Custom Widgets Animations Desktop GUI Designer Python GUI Modern UI Component Library

Classifiers

Report project as malware

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

qt_pyqt_pyside_custom_widgets-2.6.0.tar.gz (6.9 MB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

qt_pyqt_pyside_custom_widgets-2.6.0-py3-none-any.whl (9.6 MB view details)

Uploaded Python 3

File details

Details for the file qt_pyqt_pyside_custom_widgets-2.6.0.tar.gz.

File metadata

File hashes

Hashes for qt_pyqt_pyside_custom_widgets-2.6.0.tar.gz
Algorithm Hash digest
SHA256 bae0062af0a469a72f2f6644b7b6527d102518ee3874c5a4727d77f1f0c6352c
MD5 3e7015172303edfff81f4155662d8286
BLAKE2b-256 3a9a4972665f26c0332ba0f7a05e35e127e34fda3dda5913ff004b26e17fd160

See more details on using hashes here.

File details

Details for the file qt_pyqt_pyside_custom_widgets-2.6.0-py3-none-any.whl.

File metadata

File hashes

Hashes for qt_pyqt_pyside_custom_widgets-2.6.0-py3-none-any.whl
Algorithm Hash digest
SHA256 f5aa4fa74379842d5dcbdf59cce1a1a9dc94cce6d94252d319ee638f0cda8167
MD5 366d576884a5b01e27777f2d83ef19f7
BLAKE2b-256 d5981fb6cd7a2296d4d9095ebe8bea4833fdd51e1e72409d1fdae781dfb82a9f

See more details on using hashes here.

Release history Release notifications | RSS feed

This release

2.6.0 This release

2 files

2.5.0

2 files

2.4.1

2 files

2.4.0

2 files

2.3.2

2 files

2.3.1

2 files

Yanked

2.3.0

2 files

Yanked reason: Declares Python >=3.9 but requires >=3.10 — crashes at import on 3.9. Use 2.3.2.

2.2.1

2 files

2.2.0

2 files

2.1.9

2 files

2.1.8

2 files

2.1.7

2 files

2.1.6

2 files

2.1.5

2 files

2.1.4

2 files

2.1.3

2 files

2.1.2

2 files

2.1.1

2 files

2.1.0

2 files

2.0.9

2 files

2.0.8

2 files

2.0.7

2 files

2.0.6

2 files

2.0.5

2 files

2.0.4

2 files

2.0.3

2 files

2.0.2

2 files

2.0.1

2 files

1.0.2

2 files

1.0.1

3 files

1.0.0

2 files

0.9.9

2 files

0.9.8

2 files

0.9.7

2 files

0.9.6

2 files

0.9.5

2 files

0.9.4

2 files

0.9.3

2 files

0.9.2

2 files

0.9.1

2 files

0.9.0

2 files

0.8.9

2 files

0.8.8

2 files

0.8.7

2 files

0.8.6

2 files

0.8.5

2 files

0.8.4

2 files

0.8.3

2 files

0.8.2

2 files

0.8.1

2 files

0.8.0

2 files

0.7.9

2 files

0.7.8

2 files

0.7.7

2 files

0.7.6

2 files

0.7.5

1 file

0.7.4

2 files

0.7.3

2 files

0.7.2

2 files

0.7.1

2 files

0.7.0

2 files

0.6.9

2 files

0.6.8

1 file

0.6.7

2 files

0.6.6

2 files

0.6.5

2 files

0.6.4

1 file

0.6.3

1 file

0.6.2

1 file

0.6.1

1 file

0.6.0

1 file

0.5.9

1 file

0.5.8

1 file

0.5.7

1 file

0.5.6

1 file

0.5.5

1 file

0.5.4

1 file

0.5.3

1 file

0.5.2

1 file

0.5.1

1 file

0.5.0

2 files

0.4.9

1 file

0.4.8

1 file

0.4.7

1 file

0.4.6

1 file

0.4.4

1 file

0.4.3

1 file

0.4.2

1 file

0.4.1

1 file

0.4.0

1 file

0.3.9

1 file

0.3.8

1 file

0.3.7

1 file

0.3.6

1 file

0.3.5

1 file

0.3.4

1 file

0.3.3

1 file

0.3.2

1 file

0.3.1

1 file

0.3.0

1 file

0.2.9

1 file

0.2.8

1 file

0.2.7

1 file

0.2.6

1 file

0.2.5

1 file

0.2.4

1 file

0.2.3

1 file

0.2.2

1 file

0.2.1

1 file

0.2.0

2 files

0.1.9

2 files

0.1.8

2 files

0.1.7

2 files

0.1.6

2 files

0.1.5

2 files

0.1.4

2 files

0.1.3

2 files

0.1.2

2 files

0.1.1

2 files

0.1.0

2 files

0.0.9

2 files

0.0.8

2 files

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